On This Page
FILTER BY TAG

Check-In Authorization with Contact EMV and
TMS
 Token Creation

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

Endpoint

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

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

clientReferenceInformation.code
clientReferenceInformation.comments
Set the value to
Checkin Auth CP
.
clientReferenceInformation.partner.developerId
Visa Acceptance Solutions
 provides the value for this field.
clientReferenceInformation.partner.solutionId
Visa Acceptance Solutions
 provides the value for this field.
clientReferenceInformation.partner. thirdPartyCertificationNumber
clientReferenceInformation.transactionId
Set this field to a unique value to manage timeout scenarios when a response message is not received.
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
paymentInformation.card.type
pointOfSaleInformation.emv.cardSequenceNumber
Set the value to
01
.
pointOfSaleInformation.emv.tags
pointOfSaleInformation.entryMode
Set the value to
contact
.
pointOfSaleInformation.terminalCapability
Set the value to
4
.
pointOfSaleInformation.terminalId
This field is required if it is within project scope. Merchant configuration is required in order to support multiple terminal IDs. Otherwise,
Visa Acceptance Solutions
 uses the default terminal ID in the merchant configuration.
pointOfSaleInformation.trackData
processingInformation.actionList
Set the value to
TOKEN_CREATE
.
processingInformation.actionTokenTypes
Set the field to one of these values:
  • customer
  • instrumentIdentifier
  • paymentInstrument
processingInformation.commerceIndicator
Set the value to
retail
.
processingInformation.industryDataType
Set the value to
lodging
.
processingInformation.reconciliationId
Set the value to the room or folio number.
travelInformation.duration

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.
Request
{
    "clientReferenceInformation": {
        "code": "TestCode123",
        "comments": "Checkin Auth CP",
        "_comment": "Include the transactionId - A unique value used to manage timeout scenarios when response 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
{
    "_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"
        }
    }
}
RELATED TO THIS PAGE