🛠️
Integration Guide
  • 🔎Overview
    • 👋Welcome to XGateway
      • Integrate with XGateway
      • Supported currencies
      • KYC
  • ⚙️Integration Guides
    • Crypto Payments using Checkout
    • SEPA Secure payments using Checkout
    • Alternative Payment Methods using Checkout
    • Crypto Payments using API
    • Advanced features of Invoice creation
  • ❔Miscellaneous
    • Keys and authentication
    • Check transaction status
    • Environments
    • Invoice currencies
    • Deposit data confirmation
    • Callbacks
      • Transaction callback
      • Bank Account callback
      • KYC callback
    • Withdrawal initiation with API
    • Disputes resolution
  • 💱Payment flows
    • Transaction flowchart
    • KYC checks diagram
    • Confirmation subprocess
    • User flow for Crypto Payments
    • User flow for SEPA Secure
    • Fees structure
      • Adjustable BTC Minimum Deposit Fee Framework
  • 🏤Back office
Powered by GitBook
On this page
  1. Miscellaneous

Deposit data confirmation

PreviousInvoice currenciesNextCallbacks

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