PLCC Card Transaction - V1
Last updated: 11-Sep-2025
This API is used to initiate payment requests specifying the following details:
| Request Details | Values |
|---|---|
| Method | POST |
| URL | https://{ENVIRONMENT}/oidc/poscloud/nexo/payment |
| 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 |
"PAYMENT" |
| MessageHeader.MessageType | "REQUEST" |
| MessageHeader.ServiceID | String |
| MessageHeader.SaleID | String |
| MessageHeader.POIID | String |
| PaymentRequest | Object |
| PaymentRequest.SaleData | Object |
| PaymentRequest.TransactionID | String |
| PaymentRequest.TimeStamp | String |
| PaymentRequest.PaymentTransaction | Object |
| PaymentRequest.AmountsReq | Object |
| PaymentRequest.Currency | String |
{
"MessageHeader": {
"MessageClass": "SERVICE",
"MessageCategory": "PAYMENT",
"MessageType": "REQUEST",
"ServiceID": "1234",
"SaleID": "POSCloud",
"POIID": "4002-4002-4002"
},
"PaymentRequest": {
"SaleData": {
"OperatorID": "223345",
"SaleTransactionID": {
"TransactionID": "123422",
"TimeStamp": "2020-04-20T14:43:59.123Z"
},
"CustomerOrderReq": null,
"SaleToAcquirerData": null,
"VF_SaleNote": "Welcome"
},
"PaymentTransaction": {
"AmountsReq": {
"Currency": "USD",
"RequestedAmount": "17"
}
},
"PaymentData": {
"PaymentType": "NORMAL",
"SplitPaymentFlag": true
},
"LoyaltyData": {
"VF_PromotionRequest": {
"VF_Code": "34211",
"VF_PlanCode": "1234",
"VF_Expiry": "202025",
"VF_FinType": "PROMO_APR"
}
}
}
}Based on the response from the terminal, the POS Cloud will send back the response.
{
"MessageHeader": {
"MessageClass": "SERVICE",
"MessageCategory": "PAYMENT",
"MessageType": "RESPONSE",
"ServiceID": "1234",
"SaleID": "POSCloud",
"POIID": "4002-4002-4002"
},
"PaymentResponse": {
"Response": {
"Result": "SUCCESS",
"ErrorCondition": null,
"AdditionalResponse": null
},
"SaleData": {
"OperatorID": "223345",
"SaleTransactionID": {
"TransactionID": "123422",
"TimeStamp": "2020-04-20T14:43:59.123Z"
},
"TokenRequestedType": null,
"SaleReferenceID": null,
"VF_TokenizationParameters": null,
"SaleTerminalData": null,
"CustomerOrderReq": null,
"SaleToPOIData": "{\"c\":\"368607\",\"m\":\"MC\",\"p\":\"PRIV_LBL\",\"i\":\"100107\",\"r\":\"CAPTURED\",\"rc\":\"4\",\"ts\":\"SUCCESS\"}",
"SaleToAcquirerData": null,
"VF_SaleNote": null,
"VF_PartnerID": "23456",
"VF_CustomerID": "65432",
"VF_L2Data": null
},
"POIData": {
"POITransactionID": {
"TransactionID": "368607",
"TimeStamp": "2024-11-10T22:26:19Z"
},
"POIReconciliationID": null
},
"PaymentResult": {
"PaymentType": "NORMAL",
"PaymentInstrumentData": {
"PaymentInstrumentType": null,
"PaymentAccountReference": null,
"VF_Tokens": null,
"ProtectedCardData": null,
"CardData": {
"BankUserData": "MC",
"PaymentBrand": "MasterCard",
"MaskedPAN": "541333******3511",
"PaymentAccountRef": null,
"EntryMode": "MAGSTRIPE",
"CardCountryCode": null,
"ProtectedCardData": null,
"SensitiveCardData": {
"PAN": "541333******3511",
"CardSeqNumb": null,
"ExpiryDate": "**/**",
"TrackData": null
},
"AllowedProductCode": null,
"PaymentToken": {
"TokenRequestedType": "TRANSACTION",
"TokenValue": "hnm3****************",
"ExpiryDateTime": "2024-08-20T18:30:00Z"
},
"VF_CardholderName": "CUST************",
"VF_EmvTags": null
},
"VF_FleetCard": {
"VF_DepartmentNum": null,
"VF_DriverNum": null,
"VF_EmployeeNum": null,
"VF_FleetData1": null,
"VF_FleetData2": null,
"VF_Hubometer": null,
"VF_JobNum": null,
"VF_MaintenanceId": null,
"VF_Odometer": null,
"VF_License": null,
"VF_PurchaseDataSeq": null,
"VF_ReferHours": null,
"VF_RefNum": null,
"VF_RestrictedProducts": null,
"VF_TrailerNum": null,
"VF_TripNum": null,
"VF_UnitNum": null,
"VF_UserId": null,
"VF_VehicleId": null
},
"VF_AccountType": "PRIVATELABEL",
"CustomerToken": null,
"_vf_AlternativePaymentData": null,
"CheckData": {
"TrackData": null,
"BankID": null,
"AccountNumber": null,
"CheckNumber": null,
"CheckCardNumber": null,
"Country": null,
"TypeCode": null
}
},
"AmountsResp": {
"Currency": "USD",
"AuthorizedAmount": "55",
"TotalRebatesAmount": null,
"TotalFeesAmount": null,
"CashBackAmount": "0",
"TipAmount": null,
"VF_FsaAuthorizedAmount": "0.0",
"VF_DiffAmountDue": "0.0",
"VF_ReturnCheckFee": 0.0
},
"MerchantOverrideFlag": null,
"CapturedSignature": {
"RawSignature": null,
"SignatureImage": {
"ImageFormat": "png",
"ImageData": "iVBORw0KGgoAAAANSUhEUgAAARYAAAEUAQAAAADG/iTpAAADiElEQVRoge3YPW7lIBAAYKIULt8ROIqP5he5SJkrOXKRazjKBbwdBTILGOMZZgZSrlZsEdl+35rh5zHDU679T3XTTTfddNPNP2qsGlvmUOrRMrtSry2zqUpk6ZPn5BYxoGR8Q7uum2PwPRODTkaf76oZG2J5+4VZpqox4eN9rJo9GKPrJvwJnauY7/hX6hg0UsdOswIpmfmOSjRntLF3kjnOqTJjxVgdr23NpBccumJSIIewOqLZ0o0w0NF8ppv3ipnTzVoxVxufssmxCpMRTBoecTKCyeNbMXmezCSaa3hqJndHmLBg5l+YPAXCpCo4lbKx9yf8xCu0/DizRDPle2bizx0OjC41fjMNZruffDGveQQDZpssIKOGGPMqG9/SVJqfwjzDa4IBgRaLzKgXd5pBNLGlaMDA4UW2KX1SNEnIpJaCAdPlDA54zGYEZrqvD3UFqtBzeL2/ONZYcP3Ut4FxgnYPNTWNuXdi5f4Ac9xm08DAsQVj9Zya5nhxwKC5zvOyD9CsrFm0aD7y8wmaL85YmIMEsz+QQd+X62Yb22ZxyHzA26vh17bBqVXhfSAZXFfwBmcy5TRjtqltULdKkybm7RdmqJlzoRQJkTVGt01R5bAGd7005+Iu8iFr5qo5v2xD25SVImeMbpuywCvWRjSbq5q4iZSlQLFWo5nrJm6aZflSfHeiKTMdY0hWLb7LwVhq0L5h/EtIeUfMQMtEvNd580qGkDOkmlJFrvGmHEJi/ACSChDnC2/eaSVJzEqGp8hfwdDql5hvWkXjfBoMGR5qdlps4twdDBkeagwtkHEtEQytpYihw1PULcGMnPlEhjlA4For9IttCw6sgfkYGPh2P85sv3DhsrIGLhjjZlojoro3rkN2LuACNu5BDxmoDo/fQXqAQPW8N1YwYICMGekBIp4vNDATb+zdMbMzB4h43rkztdkEA9Ke+UZ1GzB3njErs4DO82B+bGbJGJ3NAOs2aO7Swa94ehA5z8K5Y36dSOaZjW9IMCiBCgYtdGaPik082uaAddMHb1ARIhn4G4lkYNCSgbuOZGApLBlYUgt9R6W5aO6ApDkNR4XrCZcLroCuJrhccAWUI5tEk3/Ue5bkNm45o4YjRYxNS4nd5/NljBoeGqjZwnnBwkMDNdYf3NifEeGvhotS7M+R0BzBUIKMj2hkiOP+XzfddNNNN91000033fxv5i9ZiolFQt8XIgAAAABJRU5ErkJggg==",
"ImageReference": null
}
},
"ProtectedSignature": null,
"OnlineFlag": true,
"AuthenticationMethod": [
"SIGNATURE"
],
"ValidityDate": null,
"PaymentAcquirerData": {
"AcquirerID": null,
"MerchantID": "000022687061",
"AcquirerPOIID": "002",
"AcquirerTransactionID": {
"TransactionID": "00100306",
"TimeStamp": "2024-11-10T22:26:19Z"
},
"ApprovalCode": "443388",
"HostReconciliationID": null,
"VF_AcquirerResponseCode": null,
"VF_AcquirerResponseMessage": null
},
"VF_PaymentHostData": {
"ApprovalCode": null,
"AcquirerTransactionID": {
"TransactionID": "22334455",
"TimeStamp": null
}
}
},
"LoyaltyResult": {
"VF_PromotionInfo": {
"VF_FinType": "PROMO_APR",
"VF_VariableApr": true,
"VF_VariableAprAfter": true,
"VF_Apr": null,
"VF_AprAfter": "10.0",
"VF_Duration": "6Days",
"VF_Description": "PromoDescription"
}
},
"PaymentReceipt": {
"DocumentQualifier": "SALERECEIPT",
"IntegratedPrintFlag": null,
"RequiredSignatureFlag": null,
"OutputContent": {
"OutputFormat": "TEXT",
"PredefinedContent": null,
"OutputText": [
{
"Text": " Verifone Vantiv EMV Test \n 123 ABC Street \n ALPHARETTA, GA 30022 \n\n11/11/24 02:56:30\nClient ID: 14959200010001 \nMerchant ID: ********7061 \nTerm ID: 002 \n\n SALE \n\n************3511 MASTERCARD \nEntry Method: Swipe \nAppr Code: 443388 \nTransaction ID: 368607 \nPayment Type: CREDIT \nCardholder: CUST************ \nInvoice: 100107 \nResult:CAPTURED \nApproved Amount:USD $55.00 \nRef: 00100306 \nResponse: CAPTURED \nApproved: Online \n\nTotal: USD $ 55.00 \n\n\n No Refunds \n Store Credit Only \n Merchant Copy \n@# Verifone Vantiv EMV Test \n 123 ABC Street \n ALPHARETTA, GA 30022 \n\n11/11/24 02:56:32\nClient ID: 14959200010001 \nMerchant ID: ********7061 \nTerm ID: 002 \n\n SALE \n\n************3511 MASTERCARD \nEntry Method: Swipe \nAppr Code: 443388 \nTransaction ID: 368607 \nPayment Type: CREDIT \nCardholder: CUST************ \nInvoice: 100107 \nResult:CAPTURED \nApproved Amount:USD $55.00 \nRef: 00100306 \nResponse: CAPTURED \nApproved: Online \n\nTotal: USD $ 55.00 \n\n No Refunds \n Store Credit Only \n Customer Copy \n",
"CharacterSet": null,
"Font": null,
"StartRow": null,
"StartColumn": null,
"Color": null,
"CharacterWidth": null,
"CharacterHeight": null,
"CharacterStyle": null,
"Alignment": null,
"EndOfLineFlag": null
}
],
"OutputXHTML": null,
"OutputBarcode": null
}
}
}
}
Rate this article:
