文档目录 · 创建代收

创建代收

POST /api/v1/pay/create

创建及确认新单时会排除维护通道;只有会话、尚未生成正式订单时,不能继续选择维护通道。维护前已有正式订单仍使用原通道处理,详见 通道维护说明。

字段 类型 必填 说明
merchant_order_no string 是 商户唯一订单号,最长 128 字符
amount string 是 十进制金额,如 100.00
currency string 是 大写币种代码,如 MYR、SGD、USDT
channel_code string 否 可省略;传入时将收银台可选范围限定为该通道,仍须满足当前商户、币种、支付类型和限额要求
customer_id string 否 客户标识,最长 191 字符
customer_name string 否 客户姓名,最长 191 字符
customer_email string 否 客户邮箱,合法邮箱,最长 254 字符
customer_phone string 否 客户电话,最长 191 字符
payer_bank_code string 否 平台支付代码,与 currency 组成身份;支持已验证的银行、支付网络或支付方式。需要付款银行资料的通道仍仅支持 DBS、UOB、OCBC,区分大小写
payer_bank_account_owner string 否 付款账户姓名,最长 191 字符
payer_bank_account_number string 否 付款账户号码,最长 191 字符
payer_username string 否 可选付款人用户名,最长 191 字符
notify_url string 否 异步通知地址;省略时使用商户默认通知地址,生产环境必须使用 HTTPS
return_url string 否 本次会话的浏览器返回地址,须为绝对 HTTP(S) URL,最长 2048 字节;未传时使用商户默认地址(如有),返回不构成支付成功依据

客户和付款人字段用于收银台预填;用户可在确认前编辑或补齐,条件必填项按所选通道校验。银行代码以所选通道支持的值为准。确认后使用所选通道提交,选择失效时返回错误,不自动切换通道。

请求示例:

{
  "api_key": "<API_KEY>",
  "merchant_id": "merchant_1001",
  "merchant_order_no": "PAY202609160001",
  "amount": "100.00",
  "currency": "MYR",
  "notify_url": "https://merchant.example.com/payment/notify",
  "return_url": "https://merchant.example.com/payment/result",
  "timestamp": "1789516800",
  "nonce": "550e8400-e29b-41d4-a716-446655440000",
  "sign": "<64位小写HMAC-SHA256>"
}

响应示例:

{
  "code": 0,
  "message": "OK",
  "data": {
    "checkout_mode": "cashier",
    "platform_order_no": "P202609160001",
    "merchant_order_no": "PAY202609160001",
    "amount": "100.00",
    "requested_amount": "100.00",
    "currency": "MYR",
    "status": "awaiting_payment_method",
    "payment_url": "https://cashier.example.com/#/cashier/<opaque-token>",
    "expired_at": "2026-09-16T15:30:00Z"
  },
  "request_id": "req_01JEXAMPLE"
}

搜索文档