Purchase

This endpoint processes the payment for a previously created cart, completing the transaction. It is the final step in the location-based product flow.

🔍 Description

Use this method to:

Execute payment for the selected product previously added to the cart.

Finalize the transaction and receive confirmation

Retrieve supplier references and status codes

📌 The cart must be valid and not expired. Only carts created via the corresponding Create Cart method are accepted.

📥 Request Details

Method: POST

Authentication: Required

Path Parameters:

terminalId (integer): ID of the requesting terminal

operatorID (integer): ID of the operator provided in the Get Products response.

localReference (integer): unique identifier for this transaction.

Body Parameters:

Field	Type	Description
`amountToSendX100`	integer	Amount to send, expressed in cents
`localDateTime`	string	Timestamp of the payment request in ISO 8601 format
`cartId`	string	Unique identifier of the cart being paid

Example Request

{
  "amountToSendX100": 5000,
  "localDateTime": "2025-07-07T14:05:00Z",
  "cartId": "123456"
}

📤 Response

Returns transaction confirmation results:

Field	Type	Description
`rc`	integer	Global result code (e.g., 0 for success)
`items`	array	List containing transaction result objects
`items[].finalstatus`	integer	Status code of the individual transaction (e.g., 0 = success)
`items[].resultcode`	string	Internal result code from the supplier
`items[].resultmessage`	string	Human-readable confirmation message
`items[].supplierreference`	string	External reference provided by the supplier
`items[].suppliertoken`	string	Token or unique ID from the supplier
`items[].destinationcurrency`	string	Currency used in the transaction (e.g., EUR)
`items[].destinationamount`	integer	Amount delivered in the destination currency (in cents)

Example Response

{
  "rc": 0,
  "items": [
    {
      "finalstatus": 0,
      "resultcode": "0",
      "resultmessage": "Payment successful",
      "supplierreference": "CSQ-REF-20250707-0001",
      "suppliertoken": "TXN-20250707-ABC123",
      "destinationcurrency": "EUR",
      "destinationamount": 5000
    }
  ]
}

🧠 Usage Notes

This method must be called after cart creation and before cart expiration.

The amountToSendX100 must match the value used during cart creation.

Use supplierreference and suppliertoken for reconciliation or support tracking.

application/json

Body

Example

{
    "rc": 0,
    "items": [
        {
            "finalstatus": 0,
            "resultcode": "string",
            "resultmessage": "string",
            "supplierreference": "string",
            "suppliertoken": "string",
            "destinationcurrency": "string",
            "destinationamount": 0
        }
    ]
}

🔍 Description

📥 Request Details

Example Request

📤 Response

Example Response

🧠 Usage Notes

Request

Request Code Samples

Responses

Purchase

🔍 Description#

📥 Request Details#

Example Request#

📤 Response#

Example Response#

🧠 Usage Notes#

Request

Request Code Samples

Responses

🔍 Description

📥 Request Details

Example Request

📤 Response

Example Response

🧠 Usage Notes