Get Intent
You can use this API to get the status of the transaction that corresponds to a particular intent. This API also returns the masked card info of the payer (if it’s a card transaction) and the transaction lifecycle, which includes multiple attempts, failures, and other checkpoints during a transaction.
Authorizations
Basic authentication header of the form Basic <encoded-value>
, where <encoded-value>
is the base64-encoded string username:password
.
Path Parameters
Unique identifier of the intent
"66f53a6e2097773e4f0112c8"
Response
The amount in lowest count unit (e.g., cents for USD)
100
Three-letter currency code
"USD"
The currency that the customer paid in
"USD"
Your identifier for the order
"order123"
The mode in which the transaction was made (e.g., TEST or LIVE)
"TEST"
Description of the order, if any
"Order for 2 items"
Callback URL to notify order status
"https://example.com/callback"
The URL to redirect the customer to when they cancel the payment.
"https://example.com/cancel"
Timestamp of when the intent was created
"2024-09-26T10:41:50.472+00:00"
Current status of the intent.
"CREATED"
Unique identifier of the intent
"66f53a6e2097773e4f0112c8"
The URL to redirect the customer to the xPay payment gateway for payment.
"https://pay.xpaycheckout.com/?xpay_intent_id=67f53a6e2097773e4f0112c8"
A collection of key-value pairs that were provided when the object was created. These metadata values are echoed back in the response, allowing you to store and retrieve custom information such as context-specific attributes, references, or tags. This can be useful for correlating records in your system or attaching meaningful context to transactions.
{
"orderId": "12345",
"customerNote": "Deliver after 5 PM"
}
Was this page helpful?