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

HTTPcURLJavaScriptPython

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
}