Check-in Authorization with Contact EMV and
TMS
 Token Creation

Use the information in this section to process an authorization with contact EMV and to create a
Token Management Service
 token.

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments

Required Fields for a Check-in Authorization with Contact EMV and
TMS
 Token Creation

Set the value to
Checkin Auth CP
.
Cybersource
 provides the value for this field.
Cybersource
 provides the value for this field.
Set this field to a unique value to manage timeout scenarios when a reply message is not received.
Set the value to
01
.
Set the value to
contact
.
Set the value to
4
.
This field is required if it is within project scope. Merchant configuration is required in order to support multiple terminal IDs. Otherwise,
Cybersource
 uses the default terminal ID in the merchant configuration.
Set the value to
TOKEN_CREATE
.
Set the value to one of these values:
  • customer
  • instrumentIdentifier
  • paymentInstrument
Set the value to
retail
.
Set the value to
lodging
.
Set the value to the room or folio number.

REST Example: Check-in Authorization with Contact EMV and
TMS
 Token Creation

This example shows you how to authorize a payment at check in with contact EMV while creating customer, payment instrument, and instrument identifier tokens.
Light Dark
Request
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
{"clientReferenceInformation": {
        "code": "TestCode123",
        "comments": "Checkin Auth CP",
        "_comment": "Include the transactionId - A unique value used to manage timeout scenarios when reply message is not received.",
        "partner": {
            "thirdPartyCertificationNumber": "123456789012",
            "developerId": "AssignedDevID",
            "solutionId": "AssignedSolutionID"
        }
    },
    "processingInformation": {
        "actionList": [
            "TOKEN_CREATE"
        ],
        "actionTokenTypes": [
            "instrumentIdentifier",
            "paymentInstrument",
            "customer"
        ],
        "commerceIndicator": "retail",
        "capture": false,
        "industryDataType": "lodging",
        "_comment": "reconciliationId field - Please pass ROOM/folio Number for Lodging",
        "reconciliationId": "214"
    },
    "travelInformation": {
        "duration": "2"
    },
    "pointOfSaleInformation": {
        "_comment": "terminalId field required if in project scope.  Merchant configuration required to support multiple TID.  Otherwise, default TID in merchant configuration used",
        "terminalId": "12345678",
        "emv": {
            "cardSequenceNumber": "01",
            "tags": "9A032203289C01005F2A0206049F1A0206049F02060000000202009F03060000000000005F3401019F36020002820200208407A0000000031010950500000000009F10201F220100A00000000000000000000000000000000000000000000000000000009F2608CE9652E31FCB34C79F2701809F33036068C89F34030200009F3704548FF8CF9F6E0420700000"
        },
        "trackData": ";4761731xxxx00027=241220119058254?",
        "entryMode": "contact",
        "terminalCapability": "4"
    },
    "paymentInformation": {
        "card": {
            "type": "001"
        }
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "500.00",
            "currency": "USD"
        }
    }}
Response to a Successful Request
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980
{"_links": {
        "authReversal": {
            "method": "POST",
            "href": "/pts/v2/payments/7334466205036952804953/reversals"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/payments/7334466205036952804953"
        },
        "capture": {
            "method": "POST",
            "href": "/pts/v2/payments/7334466205036952804953/captures"
        }
    },
    "clientReferenceInformation": {
        "code": "TestCode123",
        "comments": "Checkin Auth CP",
        "partner": {
            "developerId": "AssignedDevID",
            "solutionId": "AssignedSolutionID"
        }
    },
    "id": "7334466205036952804953",
    "orderInformation": {
        "amountDetails": {
            "authorizedAmount": "500.00",
            "currency": "USD"
        }
    },
    "paymentAccountInformation": {
        "card": {
            "type": "001"
        }
    },
    "paymentInformation": {
        "accountFeatures": {
            "category": "A",
            "group": "0"
        },
        "tokenizedCard": {
            "type": "001"
        },
        "card": {
            "type": "001"
        }
    },
    "pointOfSaleInformation": {
        "emv": {
            "tags": "9F360200029108970A2A7200860000"
        }
    },
    "processorInformation": {
        "systemTraceAuditNumber": "023821",
        "paymentAccountReferenceNumber": "V0010013019319455709071563112",
        "approvalCode": "034508",
        "networkTransactionId": "304341034201726",
        "settlementDate": "4346",
        "retrievalReferenceNumber": "434000023821",
        "transactionId": "304341034201726",
        "responseCode": "00",
        "avs": {
            "code": "2"
        }
    },
    "reconciliationId": "214",
    "status": "AUTHORIZED",
    "submitTimeUtc": "2025-12-06T00:57:00Z",
    "tokenInformation": {
        "instrumentidentifierNew": false,
        "instrumentIdentifier": {
            "state": "ACTIVE",
            "id": "7034970000031910027"
        },
        "paymentInstrument": {
            "id": "28906F4B4175D130E063AF598E0A1E0C"
        },
        "customer": {
            "id": "28907456CBDCCBBFE063AF598E0A8A5F"
        }
    }}