Contact EMV Offline PIN Authorizations

During a contact EMV authorization, the customer inserts the card into the terminal, which causes the EMV chip to be in contact with the terminal. When processing an offline PIN transaction, the EMV chip verifies the customer PIN.

Endpoints

POST /pts/v2/payments

Example

{  "clientReferenceInformation": {    "code": "test123",    "transactionId": "uniqueValue2",    "partner": {      "thirdPartyCertificationNumber": "testTPCN"    }  },  "processingInformation": {    "commerceIndicator": "retail",    "authorizationOptions": {      "partialAuthIndicator": "true"    }  },  "paymentInformation": {    "card": {      "type": "001"    }  },  "orderInformation": {    "amountDetails": {      "totalAmount": "9900.00",      "currency": "USD"    }  },  "pointOfSaleInformation": {    "entryMode": "contact",    "terminalCapability": 4,    "terminalPinCapability": 6,    "emv": {      "tags": "5F3401019F3303E0F8C8950580800480009F370465B81A3A9F100706011203A0A0009F2608E9D097D1901E8AB99F36020002820218009C01009F1A0208409A032307259F02060000000007005F2A0208409F0306000000000000DF78083831393931303236DF791B322D30323436362D312D31432D5246492D303331332D342E332E62",      "cardSequenceNumber": "01"    },    "trackData": ";4761xxxxxxxxxxxx=251220111478549?"  },  "merchantInformation": {    "transactionLocalDateTime": "20230724085022"  }}

{  "_links": {    "authReversal": {      "method": "POST",      "href": "/pts/v2/payments/6938894575296498704951/reversals"    },    "self": {      "method": "GET",      "href": "/pts/v2/payments/6938894575296498704951"    },    "capture": {      "method": "POST",      "href": "/pts/v2/payments/6938894575296498704951/captures"    }  },  "clientReferenceInformation": {    "code": "test123",    "transactionId": "uniqueValue2"  },  "id": "6938894575296498704951",  "orderInformation": {    "amountDetails": {      "authorizedAmount": "9900.00",      "currency": "USD"    }  },  "paymentAccountInformation": {    "card": {      "type": "001"    }  },  "paymentInformation": {    "accountFeatures": {      "category": "A",      "group": "0"    },    "tokenizedCard": {      "type": "001"    },    "card": {      "type": "001"    }  },  "pointOfSaleInformation": {    "emv": {      "tags": "9F36020015910AB58D60185BEF0247303072179F180430303031860E04DA9F580903B1BAEDFD1438BA48"    }  },  "processorInformation": {    "systemTraceAuditNumber": "188589",    "approvalCode": "831000",    "networkTransactionId": "016153570198200",    "retrievalReferenceNumber": "324704188589",    "transactionId": "016153570198200",    "responseCode": "00",    "avs": {      "code": "2"    }  },  "reconciliationId": "6938894575296498704951",  "status": "AUTHORIZED",  "submitTimeUtc": "2023-09-05T04:50:58Z"}

Field	Description
`clientReferenceInformation.code`	—
`clientReferenceInformation.partner.thirdPartyCertificationNumber`	provides the value for this field.
`clientReferenceInformation.transactionId`	—
`merchantInformation.transactionLocalDateTime`	—
`orderInformation.amountDetails.currency`	—
`orderInformation.amountDetails.totalAmount`	—
`paymentInformation.card.type`	—
`pointOfSaleInformation.emv.cardSequenceNumber`	—
`pointOfSaleInformation.emv.tags`	—
`pointOfSaleInformation.entryMode`	Set the value to `contact`.
`pointOfSaleInformation.terminalCapability`	Set the value to `4`. Set the value to `0` if the terminal does not support PINs.
`pointOfSaleInformation.terminalPinCapability`	—
`pointOfSaleInformation.trackData`	—
`processingInformation.commerceIndicator`	Set the value to `retail`.

Was this page helpful?

Last published: October 28, 2026

Endpoints

Example

Not available for your audience