Deposit data confirmation

When a deposit is received, and the merchant is sent the corresponding callback, it is highly recommended to double check the deposit data using a direct call to the API.

Due to security risks, merchants must use our API to request transaction details. XGateway is not liable for issues caused by relying only on callback data.

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

api_key

x-api-keystringRequired

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

/transaction/{transactionId}

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",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-15T10:35:00.000Z",
    "info": {
      "exchangeRate": "1",
      "referenceAmount": "0.01",
      "referenceCurrency": "USD",
      "referenceExchangeRate": "1",
      "transactionAmount": "0.01",
      "transactionCurrency": "eUSDC",
      "invoiceBaseAmount": "1",
      "invoiceBaseCurrency": "USD",
      "transactionAmountBaseCurrency": "0.01"
    },
    "fees": {
      "processing": "0.00004",
      "technical": "0.3437"
    },
    "eur": "0",
    "usd": "0.01",
    "additionalParams": {
      "utr": "111111111111"
    }
  },
  "success": true
}