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
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