工作台
接口状态—
签约订单—
已发布页面—
接入流程
配置接口 → 返回银行与协议 → 接收用户订单 → 返回签约链接 → 回调签约结果
签约订单
| 平台订单号 | 商家订单号 | 银行/页面版本 | 状态 | 创建时间 | 凭证 |
|---|
订单协议凭证
落地页版本
| 页面名称 | 当前版本 | 审核中 | 地址 | 操作 |
|---|
商家接口开发文档
认证请求头
X-Merchant-Id: 商户编号 X-Timestamp: 13位毫秒时间戳 X-Nonce: 随机字符串 X-Signature: HMAC-SHA256签名
签名原文:timestamp + "\n" + nonce + "\n" + JSON.stringify(body)
1. 银行及协议列表
POST /banks
{ "merchantId":"M10001", "productCode":"TRAVEL_MONTHLY" }{ "code":"0", "message":"success", "data": { "banks": [{ "bankCode":"ICBC", "bankName":"中国工商银行", "agreements":[{ "agreementCode":"ICBC_PAY", "agreementName":"银联支付服务协议", "agreementVersion":"2026-01", "agreementContent":"<p>协议正文</p>" }] }] } }2. 创建签约订单
POST /signing-orders
{ "merchantId":"M10001", "productCode":"TRAVEL_MONTHLY", "orderNo":"平台订单号", "name":"张三", "idCard":"身份证号", "mobile":"手机号", "bankCode":"ICBC", "acceptedAgreements":[{ "agreementCode":"ICBC_PAY", "agreementVersion":"2026-01" }], "notifyUrl":"平台回调地址", "returnUrl":"平台返回地址" }{ "code":"0", "message":"success", "data": { "merchantOrderNo":"S202607120001", "signUrl":"https://bank.example.com/sign/xxx", "expiresAt":"2026-07-12T18:00:00+08:00" } }3. 签约结果回调
{ "orderNo":"平台订单号", "merchantOrderNo":"商家订单号", "status":"SUCCESS", "message":"签约成功" }状态支持:SUCCESS、FAILED、EXPIRED。回调必须使用相同HMAC签名。