接口地址#
POST
https://YOUR_GATEWAY_HOST/Payment_Dfpay_add.htmlapplication/x-www-form-urlencoded
参数定义#
| 参数名称 | 参数含义 | 是否必填 | 是否参与签名 | 参数说明 |
|---|---|---|---|---|
mchid | 商户号 | 是 | 是 | 平台分配商户号 |
out_trade_no | 商户代付订单号 | 是 | 是 | length 20 |
money | 代付金额 | 是 | 是 | |
bankname | 银行编码 | 是 | 是 | 银行编码 |
subbranch | 支行名称 | 否 | 是 | 支行名称 |
accountname | 开户名 | 是 | 是 | 开户名 |
cardnumber | 银行卡号 | 是 | 是 | 银行卡号 |
ifsc | IFSC | 是 | 是 | 印度银行 IFSC 编码,必填,不能为空,参与签名。 |
province | 所属省 | 否 | 是 | 所属省 |
city | 所属市 | 否 | 是 | 所属市 |
notifyurl | 异步回调 | 否 | 是 | 请给出有效的地址,地址后可以携带自定义get(?a=1&b=2)参数。(POST返回数据) |
pay_md5sign | MD5数据签名 | 是 | 否 | 请看MD5签名处理 |
请求与响应示例#
cURL · 使用前替换占位参数
curl --request POST 'https://YOUR_GATEWAY_HOST/Payment_Dfpay_add.html' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'mchid=10000' \
--data-urlencode 'out_trade_no=DEMO_PAYOUT_001' \
--data-urlencode 'money=100.00' \
--data-urlencode 'bankname=HDFC Bank' \
--data-urlencode 'subbranch=bank_branch' \
--data-urlencode 'accountname=DEMO CUSTOMER' \
--data-urlencode 'cardnumber=000000000000' \
--data-urlencode 'ifsc=HDFC0000001' \
--data-urlencode 'province=-' \
--data-urlencode 'city=-' \
--data-urlencode 'notifyurl=https://merchant.example/payout/notify' \
--data-urlencode 'pay_md5sign=CALCULATE_WITH_YOUR_APIKEY'请求参数 · 以表单提交
{
"mchid": "10000",
"out_trade_no": "DEMO_PAYOUT_001",
"money": "100.00",
"bankname": "HDFC Bank",
"subbranch": "bank_branch",
"accountname": "DEMO CUSTOMER",
"cardnumber": "000000000000",
"ifsc": "HDFC0000001",
"province": "-",
"city": "-",
"notifyurl": "https://merchant.example/payout/notify",
"pay_md5sign": "CALCULATE_WITH_YOUR_APIKEY"
}响应示例
{
"status": "success",
"msg": "代付申请成功",
"transaction_id": "DEMO_PLATFORM_PAYOUT"
}响应示例
{
"status": "error",
"msg": "金额错误,可用余额不足!",
"data": []
}签名与结果处理#
按该接口的签名范围计算,不要把所有示例字段都加入签名。
查看签名指南