Authorization with Contact EMV and Offline PIN
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.
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/paymentsTest:
POST
https://apitest.cybersource.com
/pts/v2/paymentsRequired Fields for Processing an Authorization with Contact EMV and Offline PIN
- Cybersourceprovides the value for this field.
- Set the value tocontact.
- Set the value to4. Set the value to0if the terminal does not support PINs.
- Set the value toretail.
REST Example: Processing an Authorization with Contact EMV and Offline PIN
Request
{ "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" } }
Response to a Successful Request
{ "_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" }