> For the complete documentation index, see [llms.txt](https://docs.xpayconnect.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xpayconnect.io/documentation/eng/orders/info.md). # Order Information > Method: **GET** > > Path: **/merchant/order/{id}** ## Request Parameters | Parameter | Type | Required | Description | | --------- | ------ | :------: | ---------------------------------------------------------------------------------------------------------------------------------------------- | | **id** | string | ✓ | Path parameter. Accepts either the `internal_id` (format `lux...`) or the `order_id` (external\_id) provided by the merchant at order creation | ### Request Examples {% tabs %} {% tab title="JavaScript" %} ```javascript const crypto = require('crypto'); const axios = require('axios'); const apiKey = 'YOUR_API_KEY'; const xApiKey = crypto.createHash('sha256').update(`${apiKey}|`).digest('hex'); const { data } = await axios.get('https://api.xpayconnect.io/merchant/order/lux01993328-a828-7581-b3a9-e712a6a0e88c', { headers: { 'client-api-key': apiKey, 'x-api-key': xApiKey }, }); ``` {% endtab %} {% tab title="Python" %} ```python import hashlib import requests api_key = 'YOUR_API_KEY' x_api_key = hashlib.sha256(f'{api_key}|'.encode()).hexdigest() resp = requests.get('https://api.xpayconnect.io/merchant/order/lux01993328-a828-7581-b3a9-e712a6a0e88c', headers={ 'client-api-key': api_key, 'x-api-key': x_api_key, }) data = resp.json() ``` {% endtab %} {% tab title="PHP" %} ```php $apiKey = 'YOUR_API_KEY'; $xApiKey = hash('sha256', $apiKey . '|'); $ch = curl_init('https://api.xpayconnect.io/merchant/order/lux01993328-a828-7581-b3a9-e712a6a0e88c'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'client-api-key: ' . $apiKey, 'x-api-key: ' . $xApiKey, ], ]); $response = json_decode(curl_exec($ch), true); curl_close($ch); ``` {% endtab %} {% endtabs %} *** ## Response ```json { "ok": true, "id": "lux019dde94-0c92-746e-9bbc-6041608c469d", "payment_id": "11664", "status": "success", "success_callback_url": "https://example.com/wbh", "created_at": "2026-04-30T13:28:57.764Z", "currency": "KZT", "usdtAmount": 47.87, "usdtAmountAfterFee": 41.65, "amountAfterFee": 19891.43, "exchangeRate": 463.2823486606767, "payment_details": { "address": "4400430353907287", "bank": "Kaspi Bank (KZ)", "holder_name": "ARTUR RUZIBOEV", "type": "card", "amount": "22305" } } ``` | Field | Type | Description | | -------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **ok** | boolean | `true` on a successful request | | **id** | string | Unique identifier in the system (internal\_id) | | **payment\_id** | string | Merchant-side identifier (external\_id) | | **status** | string (enum) | `pending` — in progress, `success` — completed, `error` — cancelled/error | | **success\_callback\_url** | string, null | URL for sending the webhook | | **created\_at** | string (datetime) | Order creation date and time | | **currency** | string (enum) | Order currency: `RUB`, `KGS`, `KZT`, `UZS`. Matches the merchant's currency | | **usdtAmount** | number, null | Estimated amount in USDT **excluding** the merchant fee. For fiat methods = `amount / exchangeRate` (only when `convertToUsdt: true`). For `usdt_trc20`/`ton` = the amount from `cryptoAmount` (what the client pays). For `ton` the value numerically represents the amount in TON, not USDT | | **usdtAmountAfterFee** | number, null | Amount in USDT credited to the merchant's USDT balance **after** the fee. Before `success` — an estimate; after `success` — the final value. Returned when a base USDT value exists (fiat methods with `convertToUsdt: true`, or `usdt_trc20`/`ton` with a populated `cryptoAmount`). For `ton` the value numerically represents the amount in TON | | **amountAfterFee** | number | Amount in fiat currency after deducting the merchant fee. Before `success` — an estimate; after `success` — the final value. Always returned | | **exchangeRate** | number, null | Fixed USDT/`currency` rate (populated when `convertToUsdt: true` for fiat methods; absent for `usdt_trc20`/`ton`) | | **payment\_details** | object | Payment details information | | ↳ **address** | string | Payment requisites | | ↳ **bank** | string | Bank name | | ↳ **holder\_name** | string | Name of the requisite holder | | ↳ **type** | string (enum) | [Payment method](/documentation/eng/orders/create.md#platezhnye-metody) | | ↳ **amount** | string | Final amount the client must pay in `currency`. May differ from the value provided by the merchant after [system amount uniquification](/documentation/eng/orders/create.md#unikalizaciya-summy) | | ↳ **cryptoAmount** | string, null | Amount to pay in cryptocurrency — populated only for crypto methods (`usdt_trc20`, `ton`, `btc`, `ltc`, etc.). For `ton` the amount is in TON, not USDT. Absent for fiat methods (`card`/`sim`/`sbp`) — conversion of merchant revenue to USDT is controlled by the `convertToUsdt` flag and the `usdtAmount`/`exchangeRate` fields above | {% hint style="info" %} The `payment_details.cryptoAmount` field appears in the response **only for crypto methods**. It is absent for the order above (method `card`). Example response for `usdt_trc20`: ```json { "ok": true, "id": "lux01993328-...", "payment_id": "uE4w...", "status": "pending", "currency": "RUB", "usdtAmount": 20, "usdtAmountAfterFee": 17.4, "amountAfterFee": 2001, "payment_details": { "address": "TXY...usdt-address", "bank": "USDT TRC-20", "holder_name": "—", "type": "usdt_trc20", "amount": "2300", "cryptoAmount": "20.00000000" } } ``` For `usdt_trc20`, the `usdtAmount` / `usdtAmountAfterFee` fields are taken from `cryptoAmount` (since the amount is already in USDT), and `exchangeRate` is absent. For `usdt_trc20` orders, the fiat `amountAfterFee` is still returned — this is the amount in the merchant's currency after fee deduction (relevant if the merchant operates on a fiat balance). Similarly for `ton`: ```json { "ok": true, "id": "lux01993328-...", "payment_id": "uE4w...", "status": "pending", "currency": "RUB", "usdtAmount": 50, "usdtAmountAfterFee": 47.5, "amountAfterFee": 4750, "payment_details": { "address": "UQA...ton-address", "bank": "TON", "holder_name": "TON", "type": "ton", "amount": "5000", "cryptoAmount": "50.00000000" } } ``` For `ton`, the `usdtAmount` / `usdtAmountAfterFee` fields contain the amount in **TON**. `exchangeRate` is absent. `convertToUsdt: true` is not supported for the `ton` method. {% endhint %}