Query Deposit Order (Thailand)
Query a single Thai Baht (THB) deposit order by merchant order ID.
Request Information
- Request URL:
/gateway/api/v2/payments/{payment_cl_id} - Method:
GET
Request Headers
| Parameter | Type | Description |
|---|---|---|
| Authorization | String | {authorization} Authorization token assigned to the platform by the system |
Path Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| payment_cl_id | Yes | String | Merchant Order ID |
Response Example
Successful Response
{
"error_code": "0000",
"data": {
"payment_id": "PM00000102",
"payment_cl_id": "order_20260112001",
"amount": 100000,
"real_amount": 100000,
"fee": 5000,
"status": 2,
"payment_cl_name": "สมชาย ใจดี",
"create_time": 1737543600,
"success_time": 1737543700
}
}
Error Response Example
{
"error_code": "0050",
"error_msg": "Order not found!"
}
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Error code, see Global Error Codes |
| error_msg | String | Error message (returned when error_code is not "0000") |
| payment_id | String | Platform Order ID |
| payment_cl_id | String | Merchant Order ID |
| amount | Int | Submitted amount |
| real_amount | Int | Actual paid amount |
| fee | Int | Transaction fee |
| status | Int | Order status, see Order Status (-1: Awaiting payer data, 0: Pending, 1: Processing, 2: Success, 3: Cancelled, 5: Awaiting allocation) |
| payment_cl_name | String | Payer name |
| payment_cl_last_number | String | Payer account number (returned when available) |
| memo | String | Order memo (returned when present) |
| create_time | Int | Creation time (Unix timestamp) |
| success_time | Int | Payment success time (Unix timestamp) |
Remarks
authorizationis the authorization token assigned to the platform by the system. If not yet obtained, please contact the system administrator.- Amount unit is in Thai Baht (cents)
payment_idfollows the format{environment prefix}PM{8 digits}. Store it as a complete string — do not hard-code its length or prefixstatus = -1means the order is waiting for the payer to submit identity data on the completion page. The order is still valid — keep polling