支付结果异步通知
<h1>支付结果异步通知</h1>
<p><strong>接口描述</strong></p>
<ul>
<li>对于各类预先生成支付订单(C扫B,公众号支付,小程序支付,APP支付等)的支付方式,在订单支付成功后,若下单时传入了notify_url参数,则服务端会通过此接口通知商户端支付成功的结果。</li>
<li>该接口的请求参数由服务端生成,返回参数是需要商户端响应的参数。</li>
<li>有可能重复通知,商户后台系统需要做幂等处理,避免重复发送。</li>
</ul>
<p><strong>接口地址</strong></p>
<p>支付请求中的<code>notify_url</code> 参数</p>
<p><strong>请求方式</strong></p>
<p><code>POST</code></p>
<p><strong>请求头部</strong></p>
<p><code>Content-Type:application/json</code></p>
<p><strong>回调参数</strong></p>
<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>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">return_code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">响应码:SUCCESS成功,FAIL失败,响应码仅代表通信</td>
<td style="text-align: left;">SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">return_msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">返回信息提示,“支付成功”,“支付中”,“参数不合法” 等</td>
<td style="text-align: left;">支付成功</td>
</tr>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">支付成功:PAY_SUCCESS成功 ,PAY_FAIL失败,TRADE_REFUND 退款成功,TRADE_REFUND_FAIL 退款失败</td>
<td style="text-align: left;">PAY_SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">支付类型,300.支付宝,400.微信,600.云闪付,700.翼支付,800.数字人民币,900.龙支付</td>
<td style="text-align: left;">300</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">请求支付流水号</td>
<td style="text-align: left;">51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">请求交易时间,格式yyyyMMddHHmmss</td>
<td style="text-align: left;">20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">end_time</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">支付完成时间,yyyyMMddHHmmss</td>
<td style="text-align: left;">20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">inst_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">机构号</td>
<td style="text-align: left;">900024</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">商户号</td>
<td style="text-align: left;">851811130002</td>
</tr>
<tr>
<td style="text-align: left;">mch_name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">商户名称</td>
<td style="text-align: left;">小猫生活</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">门店号</td>
<td style="text-align: left;">86000033007</td>
</tr>
<tr>
<td style="text-align: left;">shop_name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">门店名称</td>
<td style="text-align: left;">小猫生活</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">平台订单号</td>
<td style="text-align: left;">20000002814118090716435200001</td>
</tr>
<tr>
<td style="text-align: left;">td_trade_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">微信订/支付宝订单号</td>
<td style="text-align: left;">4200000337201905279610829271</td>
</tr>
<tr>
<td style="text-align: left;">qd_trade_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">渠道订单号</td>
<td style="text-align: left;">MYBKJHZF2019052717474162270360</td>
</tr>
<tr>
<td style="text-align: left;">o_trade_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">退款订单原订单号</td>
<td style="text-align: left;">20000131214619052717474113721</td>
</tr>
<tr>
<td style="text-align: left;">total_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">支付金额,单位:分</td>
<td style="text-align: left;">100</td>
</tr>
<tr>
<td style="text-align: left;">receipt_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商户实收金额(单位:分)= 订单金额-商户优惠金额</td>
<td style="text-align: left;">100</td>
</tr>
<tr>
<td style="text-align: left;">pay_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">用户实付(单位:分)= 订单金额-平台优惠金额-商家优惠金额</td>
<td style="text-align: left;">100</td>
</tr>
<tr>
<td style="text-align: left;">coupon_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商家优惠金额,单位:分</td>
<td style="text-align: left;">0</td>
</tr>
<tr>
<td style="text-align: left;">discount_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">平台优惠金额,单位:分</td>
<td style="text-align: left;">100</td>
</tr>
<tr>
<td style="text-align: left;">user_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">付款方用户id、微信openid、支付宝账户、qq号”等</td>
<td style="text-align: left;">odpmp5Y-AmAMgPE1alyynzngzfTg</td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">附加数据,原样返回</td>
<td style="text-align: left;">1234</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">签名</td>
<td style="text-align: left;">336437c53711dd466154c4162cbe1c52</td>
</tr>
</tbody>
</table>
<p><strong>参数示例:</strong></p>
<pre><code>{
&quot;attach&quot;: &quot;5300640076&quot;,
&quot;end_time&quot;: &quot;2019-07-20 12:36:27.0&quot;,
&quot;inst_no&quot;: &quot;900052&quot;,
&quot;mch_name&quot;: &quot;糖糖西饼屋&quot;,
&quot;mch_no&quot;: &quot;851902260011&quot;,
&quot;pay_time&quot;: &quot;20190720123623&quot;,
&quot;pay_trace_no&quot;: &quot;19988763891732480&quot;,
&quot;pay_type&quot;: &quot;300&quot;,
&quot;qd_trade_no&quot;: &quot;&quot;,
&quot;receipt_amount&quot;: &quot;9500&quot;,
&quot;result_code&quot;: &quot;PAY_SUCCESS&quot;,
&quot;return_code&quot;: &quot;SUCCESS&quot;,
&quot;return_msg&quot;: &quot;交易成功,且可对该交易做操作,如:多级分润、退款等&quot;,
&quot;shop_name&quot;: &quot;糖糖小店&quot;,
&quot;shop_no&quot;: &quot;861902260012&quot;,
&quot;sign&quot;: &quot;dbd1e9e9c0d47f1852cda1751876c3af&quot;,
&quot;td_trade_no&quot;: &quot;2019072022001498650585123932&quot;,
&quot;total_amount&quot;: &quot;9500&quot;,
&quot;pay_amount&quot;: &quot;100&quot;,
&quot;coupon_amount&quot;: &quot;0&quot;,
&quot;discount_amount&quot;: &quot;0&quot;,
&quot;trade_no&quot;: &quot;20000345563319072012362422114&quot;,
&quot;user_id&quot;: &quot;2088222426898650&quot;
}</code></pre>
<p><strong>商户收到平台回调后,须返回参数:</strong></p>
<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>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">return_code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">SUCCESS接收成功,FAIL接收失败</td>
<td style="text-align: left;">SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">return_msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">返回信息提示,“支付成功”等</td>
<td style="text-align: left;">成功</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
&quot;return_code&quot;: &quot;SUCCESS&quot;,
&quot;return_msg&quot;: &quot;成功&quot;
}</code></pre>