Skip to main content

In-Person Payments

Payment - using token - V2

Last updated: 22-Jan-2024

 This API is used to initiate payment requests, specifying the following details:

Request Details Values
Method POST
URL https://{ENVIRONMENT}/oidc/poscloud/nexo/v2/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": "1992",
        "POIID": "275-051-429"
    },
    "PaymentRequest": {
        "SaleData": {
            "SaleReferenceID": "112233",
            "SaleTransactionID": {
                "TransactionID": "62b7641d-6acb-4cdc-8e72-3ee343",
                "TimeStamp": "2023-08-29T17:18:19+05:30"
            }
        },
        "PaymentTransaction": {
            "AmountsReq": {
                "Currency": "USD",
                "RequestedAmount": "6"
            }
        },
        "PaymentData": {
            "PaymentType": "NORMAL",
            "PaymentInstrumentData": {
                "PaymentInstrumentType": "",
                "CardData": {
                    "PaymentToken": {
                        "TokenRequestedType": "CUSTOMER",
                        "TokenValue": "kLQvvreBJRwlwId7iSGg"
                    }
                }
            }
        }
    }
}

Based on the response from the terminal/external terminal simulator, the POS Cloud will send back the response.

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo