创建收款单(老挝)
创建老挝基普(LAK)收款订单接口。
请求资讯
- 请求 URL:
/gateway/api/v2/payments - 请求方式:
POST - Content-Type:
application/json;charset=utf-8
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| platform_id | 是 | String(6) | 商户 ID |
| service_id | 是 | String(7) | 服务 ID,固定值 SVC0097 |
| payment_cl_id | 是 | String(64) | 商户订单号 |
| amount | 是 | Integer(10) | 金额(分) |
| notify_url | 是 | String(256) | 交易结果通知地址 |
| name | 否 | String(16) | 付款人姓名 |
| request_time | 是 | Integer(10) | 请求时间(秒) |
| sign_type | 否 | String(16) | 签名类型,固定值 HMAC-SHA256 |
| sign | 是 | String(32|64) | 订单签名 |
服务 ID
SVC0097QR 扫码(老挝通道)
返回示例
成功返回
{
"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"
}
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| error_code | String | 错误码,详见全局错误码 |
| error_msg | String | 错误讯息(error_code 不为 "0000" 时返回) |
| link | String | 订单收银台地址 |
| payment_id | String | 平台订单号 |
| payment_cl_id | String | 商户订单号 |
| amount | Int | 提单金额 |
| qr_code_content | String | qr code 内容 |
备注
- 交易金额单位为老挝基普(分),请乘以 100 传入,例如收款 100,000.00 LAK 请传值 10000000
- 单笔最低金额 100,000 LAK,低于此金额上游将拒绝建单
- 建议建单时带入
name(付款人姓名);上游要求必填付款人姓名,若商户未提供,系统会先将付款人导向中转页面填写姓名,完成后再继续原支付流程 - QR 码内金额固定写入,产生后不可更改,如需调整金额请重新建单
- QR 码有效期约 5–15 分钟,且同一张 QR 不可重复支付,请建单后尽快引导用户完成扫码
- 请求时间使用 Unix timestamp,单位为秒
- 交易结果将通知至
notify_url,请传入可公开访问之完整地址(仅支援 http 与 https 协议),参数规范见 交易结果通知 - 订单最终状态请以 查询收款单 或交易结果通知为准