Check transaction status
There is an API to validate transaction data, if the transaction ID is known.
For security reasons, it is highly recommended to always check the transaction data using this API instead of relying only on the callback data.
API endpoint specification
get
Retrieves transaction details to the authenticated merchant by transaction ID.
Access to this endpoint requires a valid API key. The API key is sent in the x-api-key
header on requests.
Authorizations
Path parameters
transactionIdstringRequired
Responses
200
Ok
application/json
400
Bad request
application/json
401
Unauthorized
application/json
404
Not Found
application/json
500
Internal server error
application/json
get
GET /api/v2/transaction/{transactionId} HTTP/1.1
Host: api.xgateway.tech
x-api-key: YOUR_API_KEY
Accept: */*
{
"data": {
"senderDetails": {
"senderIban": "GB29NWBK60161331926819",
"senderAccountNumber": "31926819",
"senderSortCode": "601613"
},
"amount": "0.01",
"applicationId": null,
"currency": "eUSDC",
"customerId": "auto_test_x123456y-9876-12ab-c345-x3y76zuvw4kl",
"hash": "AbXyZ12MnOpQR34stUV56WxYZ78+/aBCDeFgHIJklMNOpQrST90vwXYzaBCDeFgHIJklMNOpQrST90vwXYzaBCDeFgHIJ",
"id": "a1b2c3d4-5678-4efa-bcde-123456789abc",
"invoiceId": "f1e2d3c4-1234-4abc-b567-89abcdef0123",
"network": "ethereum",
"orderId": "autotest_orderId_USD_a1b2c3d4-5678-4efa-bcde-123456789abc",
"status": "confirmed",
"transactionHash": "0xa1b2c3d4e5f60789abcdef1234567890a1b2c3d4e5f60789abcdef1234567890",
"type": "deposit",
"info": {
"exchangeRate": "1",
"referenceAmount": "0.01",
"referenceCurrency": "USD",
"referenceExchangeRate": "1",
"transactionAmount": "0.01",
"transactionCurrency": "eUSDC"
},
"fees": {
"processing": "0.00004",
"technical": "0.3437"
},
"eur": "0",
"usd": "0.01"
},
"success": true
}
Last updated