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

• SVC0097 QR 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 10000000 for 100,000.00 LAK
• Minimum amount per transaction is 100,000 LAK; the upstream will reject orders below this amount
• We recommend passing name (payer name) when creating the order; the upstream requires a payer name, so if the merchant omits it, the payer will first be redirected to a transit page to fill it 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