Payment Open API


出款通知

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>当转账订单上游付款成功时,支付中心会向商户业务系统发起回调通知。</li> <li>如果商户系统没有正确返回,支付网关会延迟再次通知。</li> </ul> <h5>请求URL</h5> <ul> <li><code>该链接是通过转账下单接口提交的参数notifyUrl设置, 如果无法访问链接,商户系统将无法接收到支付中心的通知。</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST</li> </ul> <h5>请求类型</h5> <ul> <li><code>application/x-www-form-urlencoded</code></li> </ul> <h5>参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">参数描述</th> <th style="text-align: left;">必填</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">示例值</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">mchNo</td> <td style="text-align: left;">商户号</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td style="text-align: left;">M1621873433953</td> <td>商户号</td> </tr> <tr> <td style="text-align: left;">appId</td> <td style="text-align: left;">应用ID</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td style="text-align: left;">60cc09bce4b0f1c0b83761c9</td> <td>应用ID</td> </tr> <tr> <td style="text-align: left;">mchOrderNo</td> <td style="text-align: left;">商户订单号</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td style="text-align: left;">20160427210604000490</td> <td>商户转账订单号</td> </tr> <tr> <td style="text-align: left;">transferId</td> <td style="text-align: left;">转账订单号</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td style="text-align: left;">T20160427210604000490</td> <td>支付中心生成的转账单号</td> </tr> <tr> <td style="text-align: left;">currency</td> <td style="text-align: left;">货币代码</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(3)</td> <td style="text-align: left;">INR</td> <td>三位货币代码:例如<code>INR:印度卢比</code></td> </tr> <tr> <td style="text-align: left;">amountTo</td> <td style="text-align: left;">交易总金额</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td style="text-align: left;">10100</td> <td>包含手续费&lt;/br&gt;<code>单位: 分</code></td> </tr> <tr> <td style="text-align: left;">mchFeeAmount</td> <td style="text-align: left;">转账手续费</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td style="text-align: left;">100</td> <td>出款手续费&lt;/br&gt;<code>单位: 分</code></td> </tr> <tr> <td style="text-align: left;">amount</td> <td style="text-align: left;">到账金额</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td style="text-align: left;">10000</td> <td>去除手续费,实际收到的金额&lt;/br&gt;<code>单位: 分</code></td> </tr> <tr> <td style="text-align: left;">entryType</td> <td style="text-align: left;">入账方式</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(10)</td> <td style="text-align: left;">IMPS</td> <td>入账方式: <code>IMPS 或 UPI</code>&lt;/br&gt;UPI在周末或者银行假期时不支持;&lt;/br&gt;IMPS任何时间段都支持</td> </tr> <tr> <td style="text-align: left;">state</td> <td style="text-align: left;">转账状态</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td style="text-align: left;">2</td> <td>转账状态:&lt;/br&gt;<code>0:订单生成</code>&lt;br/&gt;<code>1:转账中</code>&lt;br/&gt;<code>2:转账成功</code>&lt;/br&gt;<code>3:转账失败</code>&lt;/br&gt;<code>4:转账关闭</code></td> </tr> <tr> <td style="text-align: left;">accountNo</td> <td style="text-align: left;">收款账号</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(64)</td> <td style="text-align: left;">收款人银行卡号</td> </tr> <tr> <td style="text-align: left;">accountName</td> <td style="text-align: left;">收款人姓名</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(64)</td> <td style="text-align: left;">Nitin Gadge</td> <td>收款人开户名称</td> </tr> <tr> <td style="text-align: left;">accountEmail</td> <td style="text-align: left;">收款人邮箱</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(64)</td> <td style="text-align: left;">Nitin198483@gmail.com</td> <td>收款人邮箱</td> </tr> <tr> <td style="text-align: left;">accountPhone</td> <td style="text-align: left;">收款人手机号</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(16)</td> <td style="text-align: left;">8197220658</td> <td>收款人手机号</td> </tr> <tr> <td style="text-align: left;">bankName</td> <td style="text-align: left;">收款人开户行名称</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(64)</td> <td style="text-align: left;">HDFC bank</td> <td>当前仅作为记录</td> </tr> <tr> <td style="text-align: left;">transferDesc</td> <td style="text-align: left;">转账备注信息</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(128)</td> <td style="text-align: left;">测试转账</td> <td>转账备注信息</td> </tr> <tr> <td style="text-align: left;">channelOrderNo</td> <td style="text-align: left;">渠道订单号</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td style="text-align: left;">20160427210604000490</td> <td>对应渠道的订单号</td> </tr> <tr> <td style="text-align: left;">errCode</td> <td style="text-align: left;">渠道错误码</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td style="text-align: left;">1002</td> <td>渠道返回错误码</td> </tr> <tr> <td style="text-align: left;">errMsg</td> <td style="text-align: left;">渠道错误描述</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Business Failed 失败</td> <td>渠道返回错误描述</td> </tr> <tr> <td style="text-align: left;">extParam</td> <td style="text-align: left;">商户扩展参数</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(512)</td> <td style="text-align: left;">134586944573118714</td> <td>回调时会原样返回</td> </tr> <tr> <td style="text-align: left;">createdAt</td> <td style="text-align: left;">创建时间</td> <td style="text-align: left;">是</td> <td style="text-align: left;">long</td> <td style="text-align: left;">1622016572190</td> <td>订单创建时间,13位时间戳</td> </tr> <tr> <td style="text-align: left;">successTime</td> <td style="text-align: left;">成功时间</td> <td style="text-align: left;">否</td> <td style="text-align: left;">long</td> <td style="text-align: left;">1622016572190</td> <td>订单支付成功时有值,交易成功时间,13位时间戳</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">签名</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td style="text-align: left;">1622016572190</td> <td>订单支付成功时间,13位时间戳</td> </tr> </tbody> </table> <h5>商户返回示例</h5> <ul> <li>商户收到回调通知后,需要给平台返回的示例: <pre><code>success</code></pre></li> </ul> <h5>返回参数说明</h5> <ul> <li> <p>商户业务系统处理后同步返回给支付中心,返回字符串 <code>success</code> 则表示成功,返回 <code>非success</code> 则表示处理失败,支付中心会再次通知业务系统。</p> </li> <li> <p><code>通知频率</code>0 / 30 / 60 / 90 / 120 / 150,单位: 秒。</p> </li> <li><code>注意</code>返回的字符串必须是小写,且前后不能有空格和换行符。</li> </ul>

页面列表

ITEM_HTML