Amadis

Main Features

Owned by Olivier Chauvineau (Unlicensed)
Last updated: Sept 30, 2024 by Alexandre PERRIER
5 min read

 

This page is subject to modifications on a weekly basis due to specs, test plans, and tools updates

 

 

Agnos Framework Features Implementations

AGF 3.2.x vs AGF 3.3.x

Main differences are on HAL. Since 3.3.x, Agnos introduces the DEVICE layer that resides below the GPI.

 

AGF 3.3.x vs AGF 3.5.x

AGF 3.5.x introduces new architectural concepts such as:

  • API serialization

  • Exit conditions

  • GPI callbacks

 

All versions presented below have been certified at a given time for a given Agnos Framework-Tool-Test Plan combination

 

Components

AGF 3.6.x

AGF 3.5.x

AGF 3.4.x

AGF 3.3.x

AGF 3.2.x

Last Update

Components

AGF 3.6.x

AGF 3.5.x

AGF 3.4.x

AGF 3.3.x

AGF 3.2.x

Last Update

 

 

Development Version

Limited Version

Maintained Version

Maintained Version

 

DEVICE

 

 

N/A

version 1.4.3

N/A

Nov 16, 2020

GPI

 

 

N/A

version 3.3.17

version 3.2.48

Nov 16, 2020

AgnosDB

 

version 3.5.12

N/A

version 3.3.12

version 3.2.30

Apr 27, 2021

Agnos

 

version vxxCAAgnos35_22

N/A

version vxxCAAgnos33_22

version vxxCAAgnos32_17

Apr 27, 2021

AgnosMW

 

version 3.5.22

N/A

version 3.3.20

version 3.2.49

Apr 27, 2021

AgnosEP

Implementation 3.6.8

Implementation 3.5.34

N/A

Implementation 3.3.34

version 3.2.62

Apr 27, 2021

Mastercard

 

specifications 3.1.3/3.1.4 (mode 1 and 4) / TEI

implementation 1.0.6

N/A

N/A

specifications 3.1.3/3.1.4 (mode 1 and 4)

implementation 1.0.6

Apr 27, 2021

Visa

specifications

VCPS 2.2c

VCTKS 1.0

VRTPKS 1.1

implementation 1.0.24

specifications 2.1.3c / 2.2b / 2.2c / VCTKS / VRTPKS

implementation 1.5.14

N/A

N/A

specifications 2.1.3c / 2.2b / VCTKS

implementation 1.5.15

May 25, 2021

American Express

specifications 4.0.3

implementation 1.0.25

specifications 4.1.0

implementation 1.0.25

specifications 4.0.2 / 4.0.3

implementation 1.0.14

N/A

N/A

specifications 4.0.2 / 4.0.3

implementation 1.0.14

Mar 22, 2021

JCB

specifications 1.5c

implementation 1.0.17

specifications 1.6a

implementation 1.0.14

specifications 1.5c

implementation 1.0.17

N/A

N/A

specifications 1.4c

implementation 1.3.7

Apr 27, 2021

Discover

 

specifications ZIP / DPAS 1.0

implementation 1.3.51

N/A

N/A

specifications ZIP / DPAS 1.0

implementation 1.3.52

May 25, 2021

CUP

 

specifications 1.0.2

implementation 1.3.14

N/A

N/A

specifications 1.0.2

implementation 1.3.14

Jan 15, 2021

C-PACE

 

In Progress

No

No

Nov 16, 2020

Interac

 

specifications 1.5d

implementation 1.3.28

N/A

N/A

specifications 1.5d

implementation 1.3.28

Apr 27, 2021

eftpos

 

 

N/A

N/A

specifications 18.04

implementation 1.0.4

No

No

Nov 16, 2020

PURE

 

specifications 2.1.8

implementation 1.0.14

N/A

N/A

specifications 2.1.8

implementation 1.0.14

No

No

Jan 15, 2021

Wise

 

 

N/A

N/A

specifications 2.0

implementation 1.3.4

No

No

Nov 16, 2020

Bancomat

 

 

N/A

specifications 2.2.0

implementation 1.0.18

Nov 16, 2020

RuPay

 

 

N/A

specifications 2.0

implementation 1.3

Nov 16, 2020

Girocard

 

In Progress

 

No

Jan 15, 2021

EMVCo Contact Test Application

 

specifications EMVCo 4.3j

implementation 3.5.1

N/A

specifications EMVCo 4.3j

implementation 3.3.3

specifications EMVCo 4.3i

implementation 3.2.23

Apr 27, 2021

C-POC Ready

 

Yes

No

No

No

Nov 16, 2020

OLA for Payment Application

 

Yes (Arkos/Atheos Compliant - Nexo Ready)

No

Yes (Arkos/Atheos Compliant)

Nov 16, 2020

AgnosSP

 

Yes

No

No

No

Nov 16, 2020

GPI Testing System (GTS)

 

Yes

No

No

No

Jan 7, 2021

ACE (embedded edition)

 

 

No

versoin 3.3.28

 

Jan 15, 2021

 

 

Torn Transactions

Torn is an EMV feature specified by some payment networks in the context of contactless card processing. All the payment networks specifications for torn transactions are meant to spare card’s internal counter. So, the feature is - globally - pretty similar across the board. But MV details are different making the feature specific from an implementation stand point.

 

 

Mastercard

JCB

CUP

PURE

Rupay

 

Mastercard

JCB

CUP

PURE

Rupay

Agnos Availability

Supported

Supported

Not Supported

Supported

Not Supported

Functional Description

  • After a torn, a brand new transaction is started. If the new card processing sequence is using one of the cards that has been previously torn (in the limit of torn depth and max lifetime) then a Recover AC command is sent instead of a Generate AC

  • After a torn, a brand new transaction is started. If the new card processing sequence is using the card that has been previously torn then an Echo command is sent so a subsequent Generate AC will be spared

 

  • After a torn, the transaction is resumed from where it was torn. If the card processing is using the card that has been torn (FCI comparison subsequent to a Select) then an Echo command is sent to resume the card processing from where it was torn

 

Configuration

  • 0xDF1D, torn depth (up to 5)

  • 0xDF1C, max lifetime (up to 7200 seconds)

  • 0xDF1D, torn depth (wired to 1)

  • 0xDF1C, max lifetime

 

  • C7 B3b6, Terminal Transaction Processing Information

 

Trigger

  • Generate AC not completed

  • Generate AC not completed

 

  • Generate AC #1 or Generate AC #2 not completed

 

Storage Mechanism

  • When a torn occurs, add a torn record:

    • 9F02

    • 9F03

    • 5A (primary key for recovery)

    • 5F34 (primary key for recovery)

    • DF04

    • 9F34

    • 9F7D

    • DF28

    • 9F1E

    • 9F33

    • 9F1A

    • 9F35

    • 95

    • 9F53

    • 5F2A

    • 9A

    • 9F21

    • 9C

    • DF51

    • DF53

    • DF54

    • DF55

    • DF56

    • DF41

  • Additional data are used for internal recovery management

  • When a torn occurs, add a torn record:

    • 57 (primary key for recovery)

    • if CDA supported:

      • 9F38 data

      • 8C data

      • 9F37

 

  • When a torn occurs, add a torn record:

    • 9F37

    • 9F27

    • 9F34

    • 9F10

  • For recovery, the FCI subsequent to a Select command is used to detect whether the card has been torn

 

Restart

  • END APPLICATION

  • Start B

  • PRESENT CARD AGAIN

  • END APPLICATION

  • Start B

  • PRESENT CARD AGAIN

 

  • TRY AGAIN

  • Start B

  • PRESENT CARD AGAIN

 

Check Point

  • The kernel is re-activated to perform a brand new transaction

  • Right before Generate AC, the kernel checks whether there was a torn situation (among the last card processing sequences) in order to send - or not - a Recover AC command

  • The kernel is re-activated to perform a brand new transaction

  • After Final Select, the kernel checks whether there is a torn situation (during the last card processing sequence) in order to send - or not - an Echo command

 

  • The kernel is re-activated and is set to jump to one of the torn states (when the torn occurred):

    • Recovery from Generate AC #1

    • Recovery from Generate AC #2

  • From one of this state, the kernel checks whether there is a torn situation (during the last card processing sequence) in order to send - or not - an Echo command

 

Too Old Verification

  • Yes

  • No

 

  • No

 

Recovery Timing

  • Recover AC performed instead of the Generate AC

  • Echo performed at a specific state, occurring between Final Select and GPO

 

  • Echo performed right after the occurrence of the Generate AC (once the start B was processed by the entry point) and the Select (to get the FCI)

 

Recovery APDU

  • 80 D0 00 00 Lc data where:

    • Lc is DRDOL length followed by corresponding DDOL data

  • 80 DF 00 00 00

 

  • 80 DF xx 00 Lc data where:

    • xx corresponds to the Generate AC number (1 or 2)

    • Lc is:

      • 4 if xx = 1 (and data = 9F37 value)

      • 8 if xx = 8 (and data = 91 value)

 

When A Recovery Command Fails

  • If the recovery fails then a Generate AC will be sent to the card like during the normal path of execution

  • If communication error:

    • END APPLICATION

    • Start B

    • A brand new transaction will start

  • Else

    • If no status word error then normal torn path of execution

    • Else like a regular transaction is any other error

 

  • Generate AC #1 recovery:

    • If communication error:

      • TRY AGAIN

      • Start B

      • A brand new transaction will start

    • Else if cancellation:

      • END APPLICATION

      • STOP

    • Else if status word error:

      • SELECT NEXT RETRY

      • Start C

      • A brand new transaction will start

    • Else:

      • Normal torn path of execution

  • Generate AC #2 recovery:

    • if communication error:

      • TRY AGAIN

      • Start A

      • A brand new transaction will start

    • Else:

      • Normal torn path of execution

 

Indicators

  • N/A

  • AgnosTVR B20b5 (torn transaction)

  • AgnosTVR B20b6 (torn activated)

  • AgnosTVR B20b1 (torn recovery initiated)

  • AgnosTVR B20b8 (not torn card)

  • AgnosTVR B20b2 (torn recovery error)

  • AgnosTVR B20b4 (torn recovery - missing 9F52)

 

  • N/A

 

Card Processing State

  • N/A. A Recover AC is sent instead of a Generate AC in the same state as a regular card processing,

  • psStateTornRecovery (AgnoTVR B18 = 2)

 

  • psStateRecoverFRomGenAC1 (AgnoTVR B18 = 20)

  • psStateRecoverFRomGenAC2 (AgnoTVR B18 = 21)

 

Notes

  • N/A

  • If a torn recovery is initiated, Read Record process is interrupted if the card that is processed is not the one that was previously torn. In that case, the transaction ends (outcome is END APPLICATION)

 

  • The ability to support a torn transaction depends on the card’s FCI (presence of PURE Echo card id, tag 9F75, in FCI/BF0C). If it is not the case then the transaction ends (outcome is END APPLICATION with error L3 = STOP )

 

 

Data Exchange

To be competed…

 

Transit

 

Supported

Option Name

 

Supported

Option Name

Mastercard

Yes

Integrated Data Storage

Visa

Yes

VCTKS

American Express

N/A

N/A

JCB

Yes

Transit

Discover

N/A

N/A

CUP

Yes

Transit

C-PACE

N/A

N/A

Interac

Yes

Transit

eftpos

N/A

N/A

PURE

N/A

N/A

Wise

N/A

N/A

Bancomat

N/A

N/A

RuPay

Depends on integration context

N/A

 

C-POC Ready

All kernels' versions are identicial to the ones used on conventional acceptance systems.

Brands

Supported

COTS LoA/LoC

Option Name

Brands

Supported

COTS LoA/LoC

Option Name

Mastercard

Yes

Yes

Standard Test Plan

No Magstripe

No IDS Torn

Visa

Yes

Yes

VRTPKS Test Plan

Online only

Signature

Online PIN

No DRL

No Cash

No Cashback

No Printer

American Express

Yes

Yes

Standard Test Plan

Onlline Only

Unable to Go Online

JCB

N/A*

No

N/A*

Discover

N/A*

No

N/A*

CUP

N/A*

No

N/A*

Pure

N/A*

No

N/A*

 

* As of Nov 11, 2020 , there is no clear guidance on a specific Tap On Phone / Tap To Phone ICS. Standard ICS may be used with limited options.