创建代收
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"
}