🛠️
Integration Guide
  • 🔎Overview
    • 👋Welcome to XGateway
  • 🏎️QUICK START
    • Integrate with XGateway
    • Supported currencies
    • Keys and authentication
    • KYC
  • ⚙️INTEGRATION GUIDES
    • Important Concepts
    • Environments
      • Testing on the demo environment
    • Integration using Checkout Page
    • Integration using API
      • Channel payment flow API
      • Assets balance API
      • Exchange rate service API
      • Export SumSub KYC token
    • Deposit data
    • Callbacks
      • Transaction callback
        • Transaction object
      • Bank Account callback
      • KYC callback
    • How to initiate a withdrawal
      • Withdrawal API(V2)
      • Withdrawal API(V1)
    • Check transaction status
  • 💱Payment flows
    • Transaction flowchart
    • KYC checks diagram
    • Confirmation subprocess
    • User flow for crypto onramp
    • User flow for banking onramp
    • Fees structure
      • Adjustable BTC Minimum Deposit Fee Framework
  • 🏤Back office
Powered by GitBook
On this page
  1. INTEGRATION GUIDES

Deposit data

PreviousExport SumSub KYC tokenNextCallbacks

Last updated 2 days ago

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
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: localhost:8000
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
}