EMV provides an easy-to-use interface to interact with EMV smartcards based on this great PCSC rust library.
The acronymim EMV stands for Europay-Mastercard-Visa and describes the behaviour of applications running in smart cards.
Most of the specification can be found on Books 1~4 on ./docs/
Currently only supports macOS
brew tap caiotavares/emv
brew install emvRequires rustup
git clone [email protected]:caiotavares/emv.git
cargo install --path ./emvemv <subcommand>emv currently the following subcommands
| subcommand | arguments |
|---|---|
shell |
|
run |
<input> |
Use shell if you want emv to open a connection with a card and keep listening for APDU commands on the command-line.
If you want emv to run a series of APDU commands with minimal manual input, use run and provide a path for a file
with APDU command-syntax.
Some commands require one or two arguments to be provided and for special cases such as PUT_DATA and PIN_UNBLOCK,
emv will prompt the user to input the cryptographic MAC (message authentication code), since these commands modify card
information.
| APDU | Arguments | Format | Prompts for |
|---|---|---|---|
SELECT |
<aid> |
<hex string> |
|
GET_PROCESSING_OPTIONS |
|||
READ_RECORD |
<record> <sfi> |
<hex string> <hex string> |
|
GET_DATA |
<tag> |
<hex string> |
|
PUT_DATA |
<tag> <value> |
<hex string> |
MAC |
GENERATE_AC |
<type> <cdol> |
ARQC/TC/ACC <hex string> |
|
PIN_UNBLOCK |
MAC | ||
PIN_CHANGE* |
<pin> |
<hex_string> |
MAC |
VERIFY |
<pin> |
<hex_string> |
* The input PIN should be encrypted by the SMC key
Example 1: Selecting a Mastercard Credit application, fetching the processing options and requesting an ARQC based on a CDOL1:
$ emv shell
> SELECT A0000000041010
> GET_PROCESSING_OPTIONS
> GENERATE_AC ARQC 0000000000100000000000100986000000000009861504280030901B6A2300001EABC126F85499760000000000000000000000000000000000000000000000000000Example 2: Selecting a Mastercard Maestro application, fetching the processing options, requesting an ARQC and finally requesting a TC from a CDOL2:
$ emv shell
> SELECT A0000000043060
> GET_PROCESSING_OPTIONS
> GENERATE_AC ARQC 0000000000100000000000100986000000000009861504280030901B6A2300001EABC126F85499760000000000000000000000000000000000000000000000000000
> GENERATE_AC TC E014E254B75DBB8D031A3030000000000030901B6A1EABC126F8549976Example 3: Using a PUT DATA command to update a linked application:
$ emv shell
> SELECT A0000000043060
> GET_PROCESSING_OPTIONS
> GENERATE_AC ARQC 0000000000100000000000100986000000000009861504280030901B6A2300001EABC126F85499760000000000000000000000000000000000000000000000000000
> GENERATE_AC TC E014E254B75DBB8D031A3030000000000030901B6A1EABC126F8549976
> PUT_DATA DF07 00FF07A000000004101000A5500A4D6173746572636172648701035F2D067074656E65739F1101019F120D4372656469746F204A6169726FBF0C159F5D030100009F4D020B0A9F6E0700760000303000
> Input the MAC: 31E9601F158651AD
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent