Create Deposit Order (Laos)
API for creating Lao Kip (LAK) deposit orders.
Request Information
- Request URL:
/gateway/api/v2/payments - Method:
POST - Content-Type:
application/json;charset=utf-8
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| platform_id | Yes | String(6) | Merchant ID |
| service_id | Yes | String(7) | Service ID, fixed value SVC0097 |
| payment_cl_id | Yes | String(64) | Merchant Order ID |
| amount | Yes | Integer(10) | Amount (in cents) |
| notify_url | Yes | String(256) | Callback URL for transaction results |
| name | No | String(16) | Payer name |
| last_number | No | String(32) | Payer's bank account number (digits; spaces or - are removed automatically) |
| bank_name | No | String(16) | Payer's bank code, see Bank List |
| request_time | Yes | Integer(10) | Request time (seconds) |
| sign_type | No | String(16) | Signature type, fixed value HMAC-SHA256 |
| sign | Yes | String(32|64) | Order Signature |
Service ID
SVC0097QR Scan
Response Example
Successful Response
{
"error_code": "0000",
"data": {
"link": "https://pay.example.com/cashier/DEMOPM0123456",
"payment_id": "DEMOPM0123456",
"payment_cl_id": "order_20260112001",
"amount": 10000000,
"qr_code_content": "00020101021115312031041800520446JDBGWU78NMFD4OT3868"
}
}
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") |
| link | String | Cashier page URL |
| payment_id | String | Platform Order ID |
| payment_cl_id | String | Merchant Order ID |
| amount | Int | Order amount |
| qr_code_content | String | QR code content |
Remarks
- Transaction amount is in Lao Kip (cents), please multiply by 100 before sending, e.g. pass
10000000for 100,000.00 LAK - Minimum amount per transaction is 100,000 LAK; orders below this amount cannot be created
- We recommend passing the payer's real details when creating the order:
name(name),last_number(bank account number) andbank_name(bank code). Some channels require complete payer details; if they are missing or the bank code is not supported, the payer will first be redirected to a transit page to fill them in before the original payment flow continues - The amount is fixed inside the QR code once generated and cannot be changed; create a new order if the amount needs to change
- The QR code is valid for approximately 5–15 minutes and cannot be reused for repeated payment; direct the payer to scan it as soon as possible after order creation
- Request time uses Unix timestamp, in seconds
- Transaction results will be sent to
notify_url; the URL must be publicly reachable (http/https only), see Deposit Notification for parameter details - The final order status must be taken from Query Deposit Order or the transaction notification