代付接口文档V2


4. API代付异步通知

<p><strong>简要描述:</strong></p> <ul> <li>异步通知参数</li> <li>通知方式默认:GET</li> <li>如需POST方式通知请联系技术处理.</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>API下单接口中 nurl 参数值</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>GET </li> <li>POST </li> </ul> <p><strong>参数说明:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th>说明</th> <th>签名</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">pid</td> <td>商户编号</td> <td>是</td> </tr> <tr> <td style="text-align: left;">oid</td> <td>商户订单号</td> <td>是</td> </tr> <tr> <td style="text-align: left;">amount</td> <td>代付金额(单位:分)</td> <td>是</td> </tr> <tr> <td style="text-align: left;">fee</td> <td>代付手续费(单位:元)</td> <td>是</td> </tr> <tr> <td style="text-align: left;">uname</td> <td>持卡人姓名</td> <td>是</td> </tr> <tr> <td style="text-align: left;">anumber</td> <td>银行卡号</td> <td>是</td> </tr> <tr> <td style="text-align: left;">bname</td> <td>银行名称</td> <td>是</td> </tr> <tr> <td style="text-align: left;">bprovince</td> <td>银行卡所在省份</td> <td>是</td> </tr> <tr> <td style="text-align: left;">bcity</td> <td>银行卡所在市</td> <td>是</td> </tr> <tr> <td style="text-align: left;">bbranch</td> <td>银行卡开户支行</td> <td>是</td> </tr> <tr> <td style="text-align: left;">stime</td> <td>成功时间</td> <td>是</td> </tr> <tr> <td style="text-align: left;">code</td> <td>状态码</td> <td>是</td> </tr> <tr> <td style="text-align: left;">sign</td> <td>签名</td> <td>否</td> </tr> </tbody> </table> <p><strong>签名示例:</strong> </p> <pre><code>MD5(“amount=代付金额&amp;anumber=银行卡号&amp;bbranch=银行卡开户支行&amp;bcity=银行卡所在市&amp;bname=银行名称&amp;bprovince=银行卡所在省份&amp;code=状态码&amp;fee=下发手续费&amp;oid=商户订单号&amp;pid=商户编号&amp;stime=成功时间&amp;uname=持卡人姓名&amp;key=密钥”)</code></pre> <p><strong>签名规则:</strong> </p> <pre><code>1、参数列表中,除去sign外,其他所有非空的参数都要参与签名,值为空的参数不用参与签名 2、签名顺序按照参数名a到z的顺序排序,若遇到相同的首字母,则看第二个字母,以此类推,组成规则如下: ` 参数名1=参数值1&amp;参数名2=参数值2…….参数名n=参数值n&amp;key=秘钥(由系统提供)` 3、然后使用MD5对其进行UTF-8的编码方式加密即可,签名结果统一转成小写</code></pre> <p><strong>返回示例</strong></p> <pre><code>http://异步回调地址?pid=商户编号&amp;oid=商户订单号&amp;amount=下发金额&amp;fee=下发手续费&amp;uname=持卡人姓名&amp;anumber=银行卡号&amp;bname=银行名称&amp;bprovince=银行卡所在省份&amp;bcity=银行卡所在市&amp;bbranch=银行卡开户支行&amp;stime=成功时间&amp;code=状态码&amp;sign=签名</code></pre> <p><strong>特殊说明</strong></p> <pre><code>下发成功后会将以上字段通过URL的方式GET到下单接口填写nurl参数地址,收到请求只需返回success即表示确认收到通知并处理,系统将会每隔30秒再次请求异步接口,直达请求5次后,就不在发起请求。请收到通知后校验签名和金额,并做好重复通知的处理。</code></pre> <p><strong>备注</strong></p> <ul> <li>更多返回错误代码请看错误代码说明</li> </ul>

页面列表

ITEM_HTML