对接总览
使用一套签名规则完成代收、代付和余额查询。建单响应表示订单被接受，付款结果通过查单或异步回调确认。
开始之前
- 获取属于同一商户应用的
tenant_id、app_key和app_secret。 - 确认已开通的付款方式、单笔金额范围、费率和请求 IP 配置。
- 配置可接收 POST JSON 的
notify_url。测试凭证与正式凭证不可混用。 - 按签名规则计算签名，再发送 JSON 对象。
选择接口
| 操作 | 方法 | 路径 |
|---|---|---|
| 创建代收 · H5 | POST | /v1/api/collection/create_order |
| 创建代收 · Deeplink | POST | /v1/api/collection/create_deeplink_order |
| 代收查单 | POST | /v1/api/collection/query_order |
| 查询 UPI | POST | /v1/api/collection/query_upi |
| 查询 UTR | POST | /v1/api/collection/query_utr |
| 提交 UTR | POST | /v1/api/collection/submitted_utr |
| 创建代付 | POST | /v1/api/disbursement/create_order |
| 代付查单 | POST | /v1/api/disbursement/query_order |
| 查询余额 | POST | /v1/api/tenant/query_balance |
两条主要流程
- 代收：创建 H5 或 Deeplink 订单 → 使用返回的支付链接及应付金额 → 接收成功回调或查询订单。
- 代付：创建订单 → 获取平台订单号 → 接收结果回调或查询订单。建单成功不表示已向收款人付款。