Acquiring HTTP API
[POST] Create New Fiat Order
/private-api/orders/{slug}
| Attribute | Type | Required | Description |
|---|---|---|---|
| slug | string | Y | unique instance name defined for the company |
Request Payload
{
"amount": "200",
"currency": "UAH",
"external_order_id": "INV-123"
}
| Attribute | Type | Required | Description |
|---|---|---|---|
| amount | decimal | Y | min 200 / max 29500 |
| currency | string | Y | Fiat currency ticker |
| external_order_id | string | N | unique order identifier in client Database (usually Internal Payment or Order ID used). Number of characters: min 1, max 255. Allowed symbols: aA-zZ, 0-9. Special characters: “-“, “_“. |
Response Payload
{
"order": {
"id": "08d585b1-86c6-496d-b413-ab17aa74fdd6",
"currency": "UAH",
"value": "200",
"expected_amount": "200",
"received_total": "0",
"exchange_rate": "37.83",
"received_currency": "USDT",
"deposited_currency": "USDT",
"status": "OPEN",
"external_order_id": "INV-123",
"created_at": "2022-03-23 09:35:16",
"completed_at": null,
"acquiring_url": "https://merchant.pay.whitepay.com/fiat-order/08d585b1-86c6-496d-b413-ab17aa74fdd6",
"is_internal": false,
"order_number": "000000001",
"transactions": []
}
}
Check out order entity reference for detailed description.
[GET] Show Fiat Order Details
/private-api/orders/{slug}/{orderId}
| Attribute | Type | Required | Description |
|---|---|---|---|
| slug | string | Y | unique instance name defined for the company |
| orderId | string | Y | unique identifier of order |
Response Payload
{
"order": {
"id": "68b5d903-6d69-4db6-80d2-a012c4244876",
"currency": "UAH",
"value": "300",
"expected_amount": "300",
"received_total": "6.76",
"exchange_rate": "37.83",
"is_internal": false,
"deposited_currency": "UAH",
"received_currency": "USDT",
"status": "COMPLETE",
"external_order_id": null,
"created_at": "2022-03-23 15:13:49",
"completed_at": "2022-03-23 15:15:41",
"acquiring_url": "https://merchant.pay.whitepay.com/fiat-order/68b5d903-6d69-4db6-80d2-a012c4244876",
"order_number": "000000001",
"transactions": [
{
"id": "7f17439c-f65c-4d9e-9807-f5c66e029e18",
"currency": "UAH",
"value": "300",
"status": "COMPLETE",
"hash": "cpi_G5Wwu8MkY1Z4DlIA",
"is_internal": false,
"created_at": "2022-03-23 15:15:41",
"completed_at": "2022-03-23 15:15:41"
}
]
}
}
Check out order entity reference for detailed description.
[GET] Show Fiat Orders List
/private-api/orders/{slug}
| Attribute | Type | Required | Description |
|---|---|---|---|
| slug | string | Y | unique instance name defined for the company |
Response Payload
{
"orders": [
{
"id": "fb6d3059-ca3d-4dfc-a338-cdf457f5e1b1",
"currency": "UAH",
"expected_amount": "15500.50",
"received_total": "0",
"exchange_rate": "37.83",
"received_currency": "USDT",
"deposited_currency": "USDT",
"value": "15500.50",
"status": "COMPLETE",
"external_order_id": "INV-123",
"created_at": "2022-03-23 09:25:18",
"completed_at": "2022-03-23 09:35:16",
"acquiring_url": "https://merchant.pay.whitepay.com/fiat-order/fb6d3059-ca3d-4dfc-a338-cdf457f5e1b1",
"order_number": "000000001"
},
{
"id": "08d585b1-86c6-496d-b413-ab17aa74fdd6",
"currency": "UAH",
"expected_amount": "200",
"received_total": "0",
"exchange_rate": "37.83",
"received_currency": "USDT",
"deposited_currency": "USDT",
"value": "200",
"status": "COMPLETE",
"external_order_id": "INV-123",
"created_at": "2022-03-22 23:46:12",
"completed_at": "2022-03-22 23:55:01",
"acquiring_url": "https://merchant.pay.whitepay.com/fiat-order/08d585b1-86c6-496d-b413-ab17aa74fdd6",
"order_number": "000000002"
}
],
"meta": {
"current_page": 1,
"last_page": 1,
"total": 2
}
}
Check out pagination entity reference for detailed description.
Filters
| Param | Type | Required | Description |
|---|---|---|---|
| page | int | N | Page number |
| per_page | int | N | Count of items per page |
| date_from | date | N | Format: 2022-06-01+00:00:00 |
| date_to | date | N | Format: 2022-06-01+00:00:00 |
| completed_at_from | date | N | Format: 2022-06-01+00:00:00 |
| completed_at_to | date | N | Format: 2022-06-01+00:00:00 |
| order_status_id | uuid | N | Ref. Order Status ID |
| external_order_id | string | N | Ref. External Order ID |
[GET] Show Invoice Currencies For Fiat Order Creation
/currencies/fiat-order-target-currencies
Response Payload
{
"currencies": [
{
"id": "3366a58a-451b-4ec3-91fb-9091671a2e92",
"ticker": "UAH",
"is_fiat": true,
"title": null,
"min_amount": "200",
"max_amount": "29500",
"precision": 2,
"icon": "https://media.whitepay.com/currency-default-icon.svg"
},
{
"id": "25f16a7b-593c-4cfb-a7c9-f98674050496",
"ticker": "USD",
"is_fiat": true,
"title": "United States Dollar",
"min_amount": "10",
"max_amount": "10000",
"precision": 2,
"icon": "https://media.whitepay.com/currency-default-icon.svg"
},
{
"id": "8bfa671b-9457-4f35-a42b-4f9f76fd328f",
"ticker": "KZT",
"is_fiat": true,
"title": "Kazakhstani Tenge",
"min_amount": "1500",
"max_amount": "10000",
"precision": 2,
"icon": "https://media.whitepay.com/currency-default-icon.svg"
},
{
"id": "f5d61716-c428-428e-823a-1df68a9f7234",
"ticker": "EUR",
"is_fiat": true,
"title": "Euro",
"min_amount": "10",
"max_amount": "10000",
"precision": 2,
"icon": "https://media.whitepay.com/4a8552d8-5546-4b86-a183-6467ede1d395/eur.svg"
}
]
}
Check out invoice currencies entity reference for detailed description.
Order Status Change
