cpay


支付结果查询接口

<h1>支付结果查询</h1> <p><strong>接口地址</strong></p> <p><code>https://cpay.xiangma365.com/xypay/v3/queryorder</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;">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;">60000001</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;">Y52212200002</td> </tr> <tr> <td style="text-align: left;">query_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;">31dafada31dskcada</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;">20000032114018111516011200013</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;">51c7d68424e5492199cf7f4734a2b977</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <p>通过支付订单号查询</p> <pre><code>{    &amp;quot;inst_no&amp;quot;: 60000001, &amp;quot;mch_no&amp;quot;: &amp;quot;851808290003&amp;quot;, &amp;quot;query_trace_no&amp;quot;: &amp;quot;11222323331323322&amp;quot;, &amp;quot;trade_no&amp;quot;: &amp;quot;20000002814118090716435200001&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;6e461f5c95c055b3aed017b8fcb8a1a9&amp;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> <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_IN_PROCESS支付中 ,PAY_FAIL支付失败,只有return_code为SUCCESS时才会返回。</td> <td style="text-align: left;">PAY_SUCCESS</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;">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;">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_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;">query_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;">31dafada31dskcada</td> </tr> <tr> <td style="text-align: left;">trade_state</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">交易订单状态(上游交易状态,仅供参考,判断交易请以result_code为准)</td> <td style="text-align: left;">SUCCESS</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;">wx1dafada31dskcada</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云闪付</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;">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;">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;">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;">null</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;">null</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;">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;">100</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;">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>若返回结果result_code=PAY_IN_PROCESS 支付中,需要调用订单查询接口进行轮询,建议返回后5秒开始。一共轮询15次间隔5秒</p> <p><strong>成功返回结果</strong></p> <pre><code>{     &amp;quot;return_code&amp;quot;: &amp;quot;SUCCESS&amp;quot;, &amp;quot;return_msg&amp;quot;: &amp;quot;支付成功&amp;quot;, &amp;quot;result_code&amp;quot;: &amp;quot;PAY_SUCCESS&amp;quot;, &amp;quot;pay_type&amp;quot;: &amp;quot;400&amp;quot;, &amp;quot;mch_name&amp;quot;: &amp;quot;小白盒周康宝岛牛肉饭&amp;quot;, &amp;quot;shop_name&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;mch_no&amp;quot;: &amp;quot;851808290003&amp;quot;, &amp;quot;shop_no&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;query_trace_no&amp;quot;: &amp;quot;11222323331323322&amp;quot;, &amp;quot;pay_trace_no&amp;quot;: &amp;quot;134dsa463451313131313001&amp;quot;, &amp;quot;pay_time&amp;quot;: &amp;quot;20780907150901&amp;quot;, &amp;quot;total_amount&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;end_time&amp;quot;: null, &amp;quot;trade_no&amp;quot;: &amp;quot;20000002814118090716435200001&amp;quot;, &amp;quot;td_trade_no&amp;quot;: &amp;quot;4200000180201809074294896717&amp;quot;, &amp;quot;qd_trade_no&amp;quot;: &amp;quot;MYBKJHZF2018090716435242903758&amp;quot;, &amp;quot;user_id&amp;quot;: null, &amp;quot;attach&amp;quot;: &amp;quot;888&amp;quot;, &amp;quot;trade_state&amp;quot;: &amp;quot;SUCCESS&amp;quot;, &amp;quot;receipt_amount&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;1d8612c686ef86ffe1c912a2303d3346&amp;quot; }</code></pre>

页面列表

ITEM_HTML