接口地址#
POST
https://YOUR_GATEWAY_HOST/Pay_Index.htmlapplication/x-www-form-urlencoded
参数定义#
| 参数名称 | 参数含义 | 是否参与签名 | 是否必填 | 参数说明 |
|---|---|---|---|---|
pay_memberid | 商户号 | 是 | 是 | 平台分配商户号 |
pay_orderid | 商户订单号 | 是 | 是 | 订单号唯一 |
pay_applydate | 提交时间 | 是 | 是 | 时间格式:2018-12-28 18:18:18 |
pay_bankcode | 通道编码 | 是 | 是 | 开发文档[附件]银行编码参考,或通道费率中查看 |
pay_notifyurl | 异步回调 | 是 | 是 | 请给出有效的地址,地址后可以携带自定义get(?a=1&b=2)参数。(POST返回数据) |
pay_callbackurl | 同步回调 | 是 | 是 | 请给出有效的地址,地址后可以携带自定义get(?a=1&b=2)参数。(POST返回数据) |
pay_amount | 订单金额 | 是 | 是 | |
pay_md5sign | MD5数据签名 | 否 | 是 | 请看MD5签名处理 |
pay_attach | 附加字段 | 否 | 否 | 此字段在返回时按原样返回 |
pay_productname | 商品名称 | 否 | 否 | 商品名称 |
pay_productnum | 商品数量 | 否 | 否 | 商品数量 |
pay_productdesc | 商品描述 | 否 | 否 | 商品描述 |
pay_producturl | 商户链接地址 | 否 | 否 | 商户链接地址 |
type | 返回数据格式 | 否 | 否 | 返回数据的格式,如果不传则返回html页面,如果值=json 则返回json串 |
请求与响应示例#
cURL · 使用前替换占位参数
curl --request POST 'https://YOUR_GATEWAY_HOST/Pay_Index.html' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'pay_memberid=10000' \
--data-urlencode 'pay_orderid=DEMO_COLLECT_001' \
--data-urlencode 'pay_amount=100.00' \
--data-urlencode 'pay_applydate=2026-10-11 12:00:00' \
--data-urlencode 'pay_bankcode=YOUR_CHANNEL_CODE' \
--data-urlencode 'pay_notifyurl=https://merchant.example/notify' \
--data-urlencode 'pay_callbackurl=https://merchant.example/return' \
--data-urlencode 'pay_md5sign=CALCULATE_WITH_YOUR_APIKEY' \
--data-urlencode 'type=json'请求参数 · 以表单提交
{
"pay_memberid": "10000",
"pay_orderid": "DEMO_COLLECT_001",
"pay_amount": "100.00",
"pay_applydate": "2026-10-11 12:00:00",
"pay_bankcode": "YOUR_CHANNEL_CODE",
"pay_notifyurl": "https://merchant.example/notify",
"pay_callbackurl": "https://merchant.example/return",
"pay_md5sign": "CALCULATE_WITH_YOUR_APIKEY",
"type": "json"
}响应示例
{
"status": "1",
"msg": "下单成功",
"pay_amount": "100.00",
"pay_orderid": "DEMO_PLATFORM_COLLECT",
"payUrl": "https://cashier.example/pay/DEMO"
}响应示例
{
"status": "error",
"msg": "下单失败",
"content": "Reason for error"
}签名与结果处理#
按该接口的签名范围计算,不要把所有示例字段都加入签名。
查看签名指南