跳到主要内容

创建收款单（马来西亚）

创建马来西亚林吉特（MYR）收款订单接口。

请求资讯​

  • 请求 URL： /gateway/api/v2/payments
  • 请求方式： POST
  • Content-Type： application/json;charset=utf-8

请求参数​

参数名必选类型说明
platform_id是String(6)商户 ID
service_id是String(7)服务 ID
payment_cl_id是String(64)商户订单号
amount是Integer(10)金额（仙）
notify_url是String(256)交易结果通知地址
request_time是Integer(10)请求时间（秒）
sign_type否String(16)签名类型，固定值 HMAC-SHA256
sign是String(32|64)订单签名

服务 ID​

  • SVC0113 DuitNow 扫码
  • SVC0115 Touch 'n Go 电子钱包
  • SVC0116 FPX 网银

返回示例​

成功返回（SVC0113 DuitNow 扫码）​

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/cashier/DEMOPM0123456",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260112001",
    "amount": 10000,
    "qr_code_content": "00020201021226590014A000000615000101..."
  }
}

成功返回（SVC0115 / SVC0116）​

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/cashier/DEMOPM0123456",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260112001",
    "amount": 10000
  }
}

返回参数说明​

参数名类型说明
error_codeString错误码，详见全局错误码
error_msgString错误讯息（error_code 不为 "0000" 时返回）
linkString订单收银台地址
payment_idString平台订单号
payment_cl_idString商户订单号
amountInt提单金额
qr_code_contentStringDuitNow QR 码内容（仅 SVC0113，可能不返回，见备注）

备注​

  • 交易金额单位为马来西亚林吉特（仙），请乘以 100 传入，例如收款 100.00 MYR 请传值 10000
  • 单笔金额限制：SVC0113（DuitNow 扫码）为 1.00 – 2000.00 MYR；SVC0115（Touch 'n Go 电子钱包）为 1.00 – 10000.00 MYR；SVC0116（FPX 网银）为 100.00 – 50000.00 MYR
  • 取得 link 后请将付款人导向该收银台页面完成支付
  • SVC0113：一般情况下同时返回 qr_code_content（DuitNow QR 码内容），商户可自行渲染 QR 码；少数情况不返回此栏位，请以 link 引导付款人完成支付。QR 码有效期约 5 分钟，请建单后尽快引导用户扫码
  • SVC0115 / SVC0116：付款人打开 link 后将跳转至对应的支付页面完成付款
  • 本通道不需传入银行代码，付款方式由 service_id 决定
  • 请求时间使用 Unix timestamp，单位为秒
  • 交易结果将通知至 notify_url，参数规范见 交易结果通知
  • 订单最终状态请以 查询收款单 或交易结果通知为准