跳到主要内容

创建收款单(老挝)

创建老挝基普(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​

  • SVC0097 QR 扫码(老挝通道)

返回示例​

成功返回​

{
"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_codeString错误码,详见全局错误码
error_msgString错误讯息(error_code 不为 "0000" 时返回)
linkString订单收银台地址
payment_idString平台订单号
payment_cl_idString商户订单号
amountInt提单金额
qr_code_contentStringqr code 内容

备注​

  • 交易金额单位为老挝基普(分),请乘以 100 传入,例如收款 100,000.00 LAK 请传值 10000000
  • 单笔最低金额 100,000 LAK,低于此金额上游将拒绝建单
  • 建议建单时带入 name(付款人姓名);上游要求必填付款人姓名,若商户未提供,系统会先将付款人导向中转页面填写姓名,完成后再继续原支付流程
  • QR 码内金额固定写入,产生后不可更改,如需调整金额请重新建单
  • QR 码有效期约 5–15 分钟,且同一张 QR 不可重复支付,请建单后尽快引导用户完成扫码
  • 请求时间使用 Unix timestamp,单位为秒
  • 交易结果将通知至 notify_url,请传入可公开访问之完整地址(仅支援 http 与 https 协议),参数规范见 交易结果通知
  • 订单最终状态请以 查询收款单 或交易结果通知为准