mrautio/emvpt

Minimum Viable Payment Terminal

emvpt - Minimum Viable Payment Terminal

Project's intention is to support simple EMV transaction cases for chip and contactless/NFC.

Terminal simulator run

Note!

• You'll need a smart card reader device.
• If you need a test payment card, you can check emv-card-simulator project out.

terminalsimulator$ cargo run -- --help

Library

emvpt$ cargo test

Docker

docker build -t emvpt -f Dockerfile . && docker run --rm -t emvpt

Update dependencies

Run the GitHub Actions Workflow.

References

• EMV Contact Specifications
• EMV Contactless Specifications
  • EMV Contactless Book C-1 - Kernel 1 (JCB and Visa)
  • EMV Contactless Book C-2 - Kernel 2 (MasterCard)
  • EMV Contactless Book C-3 - Kernel 3 (Visa)
  • EMV Contactless Book C-4 - Kernel 4 (American Express)
  • EMV Contactless Book C-5 - Kernel 5 (JCB)
  • EMV Contactless Book C-6 - Kernel 6 (Discover)
  • EMV Contactless Book C-7 - Kernel 7 (UnionPay)
• ISO codes
  • Processing codes
  • Country codes
    • FI country code

emvpt's Issues

Add option to force contact card run in contactless mode

some visa dual interface test card (flashed by app VMCP) have only contactless PSE on contact reader. Could you please add an option to force program run in contactless mode?

Discover NFC/contactless support

• Add production CA public key to scheme_ca_public_keys_production.yaml, if missing
• Add test CA public key to scheme_ca_public_keys_test.yaml, if missing
• Test contactless purchase
• Fix any possible errors

Add support for XDA/ODE

ref. EMVco Specification Bulletin 243

Support XDA (Extended Data Authentication) and ODE (Offline Data Encipherment) using ECC (Elliptic Curve Cryptography)

JCB NFC/contactless support

• Add production CA public key to scheme_ca_public_keys_production.yaml, if missing
• Add test CA public key to scheme_ca_public_keys_test.yaml, if missing
• Test contactless purchase
• Fix any possible errors

Add support for ATR specifications

• SB nº 265 Contact – TCK Byte requirements in ATR
• SB nº 264 Contact – Warm Reset Initiation
• SB nº 218: Contact ATR Parameter Requirements

Improve EMV Tag data type definitions

EMV tags are configured here: https://github.com/mrautio/emvpt/blob/master/emvpt/src/config/emv_tags.yaml

1. Tag data should be extended so that tag:

• format is known: ans/bin/cn etc
• length of data is known: min/max/variable
• source is known: icc/terminal etc

2. Tag structures are known (i.e. inside which structure the tag is stored)

3. Tag human readable printing should take tag data format into consideration (i.e. PAN hexadecimals look like PAN in the human readable format)

Add support for biometric specifications

SB nº 185: Biometric Terminal Specification

Add public keys for more issuers

EFTLab provides a list of keys from well-known issuers:
https://www.eftlab.com/knowledge-base/243-ca-public-keys/

Wish it could be added to the default configuration. Thanks a lot.

Discover chip/contact support

• Add production CA public key to scheme_ca_public_keys_production.yaml, if missing
• Add test CA public key to scheme_ca_public_keys_test.yaml, if missing
• Test contact purchase
• Fix any possible errors

UnionPay chip/contact support

• Add production CA public key to scheme_ca_public_keys_production.yaml, if missing
• Add test CA public key to scheme_ca_public_keys_test.yaml, if missing
• Test contact purchase
• Fix any possible errors

JCB chip/contact support

• Add production CA public key to scheme_ca_public_keys_production.yaml, if missing
• Add test CA public key to scheme_ca_public_keys_test.yaml, if missing
• Test contact purchase
• Fix any possible errors

American Express chip/contact support

• Add production CA public key to scheme_ca_public_keys_production.yaml, if missing
• Add test CA public key to scheme_ca_public_keys_test.yaml, if missing
• Test contact purchase
• Fix any possible errors

UnionPay NFC/contactless support

• Add production CA public key to scheme_ca_public_keys_production.yaml, if missing
• Add test CA public key to scheme_ca_public_keys_test.yaml, if missing
• Test contactless purchase
• Fix any possible errors

American Express NFC/contactless support

• Add production CA public key to scheme_ca_public_keys_production.yaml, if missing
• Add test CA public key to scheme_ca_public_keys_test.yaml, if missing
• Test contactless purchase
• Fix any possible errors

Contactless purchase test automation case

Create a contactless purchase test automation case