代付接口
创建代付
按银行卡号和 IFSC 向印度银行账户下发 INR。提交即扣余额，经审核后出款；失败或冲正的转账会把金额和手续费自动退回。
最后更新 2026-10-24
请求参数
收款人姓名需要与银行记录匹配到收款行能接受的程度。
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| user_id | 是 | int | 商户 ID |
| merchant_order_no | 是 | string | 你的代付订单号，唯一 |
| amount | 是 | decimal | INR，100 – 20,000 |
| name | 是 | string | 收款人姓名 |
| bank_card_no | 是 | string | 银行卡号 |
| ifsc | 是 | string | IFSC 码，如 SBIN0001234 |
| callback_url | 是 | string | 接收异步回调的地址 |
| sign | 是 | string | MD5 签名 |
签名 —— 只有四个值
注意与代收不同：没有 pay_type，也没有 callback_url。把代收的签名公式套过来是最常见的对接错误。
sign = md5(user_id + merchant_order_no + amount + key)
订单状态
有两个状态会退钱。3 和 4 应当作终态退款处理，而不是"立刻重试"。
| status | 含义 | 退款 |
|---|---|---|
| 0 | 审核中 | |
| 1 | 代付中 | |
| 2 | 成功 | |
| 3 | 失败 | 自动退回 |
| 4 | 冲正 —— 已确认但未到账 | 自动退回 |
费用与余额
手续费 = 金额 × 3% + ₹6。金额和手续费在提交时一起扣，余额不足会直接拒绝，而不是排队等待。
amount = 1000 fee = 1000 * 0.03 + 6 = 36.00 debit = 1036.00
常见问题
提交前会校验 IFSC 吗？
会校验格式，但账户是否存在由收款行判断。卡号错误会由银行拒绝并自动退款。
审核中的代付能取消吗？
在还是 status 0 时把 merchant_order_no 发我们 Telegram 可以处理。一旦进入 status 1 就已经在途了。