Token Query
Last updated: 12-Jan-2024
This API is used to initiate card Acquisition requests specifying the following details:
| Request Details | Values |
|---|---|
| Method | POST |
| URL | https://{ENVIRONMENT}/oidc/poscloud/nexo/cardAcquisition |
| Authorization | https://verifone.cloud/docs/in-store-payments/integration-set-terminal#step-3__003a__00a0setting-up-basic-auth-in-postman |
|
Headers: Content-Type x-terminal-simulator x-site-entity-id
Authorization |
application/json true Entity ID of child to be passed in case parent token is used while calling this API. "user-uid:api" key pair encoded in base64. See the Obtaining API Keys guide for more information. |
| Body > Raw | See the request example below. |
Check the POS Cloud API reference for more details on the required parameters.
| Required parameters | Description |
|---|---|
MessageHeader |
Object |
MessageHeader.MessageClass |
"SERVICE" |
MessageHeader.MessageCategory |
"CARDACQUISITION" |
| MessageHeader.MessageType | "REQUEST" |
| MessageHeader.ServiceID | String |
| MessageHeader.SaleID | String |
| MessageHeader.POIID | String |
| CardAcquisitionRequest | Object |
| CardAcquisitionRequest.SaleData | Object |
| CardAcquisitionRequest.TransactionID | String |
| CardAcquisitionRequest.TimeStamp | String |
| CardAcquisitionRequest.CardAcquisitionTransaction | Object |
| CardAcquisitionRequest.SaleData.TokenRequestedType | String |
{
"MessageHeader": {
"MessageClass": "SERVICE",
"MessageCategory": "CARDACQUISITION",
"MessageType": "REQUEST",
"ServiceID": "34567",
"SaleID": "1234",
"POIID": "275-090-044"
},
"CardAcquisitionRequest": {
"SaleData": {
"TokenRequestedType": "Transaction",
"SaleTransactionID": {
"TransactionID": "12345",
"TimeStamp": "2021-07-02T11:39:07.087Z"
}
}
}
}Based on the response from the terminal, the POS Cloud will send back the response.
{
"MessageHeader": {
"MessageClass": "SERVICE",
"MessageCategory": "CARDACQUISITION",
"MessageType": "RESPONSE",
"ServiceID": "34567",
"SaleID": "1234",
"POIID": "275-090-044"
},
"CardAcquisitionResponse": {
"Response": {
"Result": "SUCCESS",
"ErrorCondition": null,
"AdditionalResponse": "Transaction Success"
},
"SaleData": {
"OperatorID": null,
"SaleTransactionID": {
"TransactionID": "12345",
"TimeStamp": "2021-07-02T11:39:07.087Z"
},
"TokenRequestedType": null,
"SaleReferenceID": null,
"SaleTerminalData": null,
"CustomerOrderReq": null,
"SaleToPOIData": null,
"SaleToAcquirerData": null
},
"POIData": {
"POITransactionID": {
"TransactionID": "0b7e0f79-dcbb-468a-98f8-2f0ba59de312",
"TimeStamp": "2021-07-02T11:39:07.087Z"
},
"POIReconciliationID": null
},
"PaymentBrand": null,
"PaymentInstrumentData": {
"PaymentInstrumentType": "CARD",
"ProtectedCardData": null,
"CardData": {
"PaymentBrand": "VISA",
"MaskedPAN": "468779******2388",
"PaymentAccountRef": null,
"EntryMode": "ICC",
"CardCountryCode": null,
"ProtectedCardData": null,
"SensitiveCardData": {
"PAN": null,
"CardSeqNumb": null,
"ExpiryDate": "01/24",
"TrackData": null
},
"AllowedProductCode": null,
"PaymentToken": {
"TokenRequestedType": null,
"TokenValue": "4687790366272388",
"ExpiryDateTime": null
},
"VF_CardholderName": null,
"VF_EmvTags": {
"9F1A": "0840",
"8A": "Z1",
"9F39": "05",
"9F36": "01E6",
"5F34": "01",
"9F37": "30F760F1",
"4F": "A0000000031010",
"9F12": "VISA Debit",
"9F34": "3F0000",
"9F35": "22",
"9F10": "06010A0380A800",
"9F33": "E0F8C8",
"9F0E": "0010000000",
"5F2A": "0840",
"9F0F": "B8689C9800",
"50": "Visa Debit",
"9F0D": "B860848800",
"95": "0000000000",
"9A": "220615",
"9F27": "00",
"9B": "2000",
"9F03": "000000000000",
"9C": "00",
"9F26": "0EF544F85BE758CD",
"9F09": "0096",
"9F07": "FF80",
"9F08": "0096",
"9F41": "00000006",
"9F40": "F000F0A001",
"9F02": "000000000000",
"5F20": "CARD HOLDER /",
"9F21": "105655",
"82": "3C00",
"9F1E": "75090044",
"84": "A0000000031010"
}
},
"VF_AccountType": "CREDIT",
"CustomerToken": null,
"_vf_AlternativePaymentData": null
},
"LoyaltyAccount": null,
"CustomerOrder": null
}
}
Rate this article:
