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>