文档说明
支付接口
商户接口
三方分账
银行分账
营销接口
对账接口
总分店接口
IOT设备-QM50S
付款码支付
支付查询
退款
退款结果查询
账单流水查询
账单统计查询
设备激活
扫码订单查询

乐收赢API

银飞乐收赢接口文档


付款码支付

<p><strong>接口描述:</strong> </p> <ul> <li>发起B扫C动态码支付交易</li> </ul> <p><strong>接口URL:</strong> </p> <ul> <li>测试<code>https://test.gdyfsk.com/yfpay/scaniot/qm50s/pay</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>请求头部:</strong></p> <table> <thead> <tr> <th>标签</th> <th>必填</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td>Content-Type</td> <td>是</td> <td>application/x-www-form-urlencoded</td> </tr> </tbody> </table> <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>参数示例</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">inst_no</td> <td style="text-align: left;">string(8)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">机构号 ,系统分配</td> <td>900075</td> </tr> <tr> <td style="text-align: left;">terminal_no</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">乐收赢终端号,扫码设备必传</td> <td>70020283</td> </tr> <tr> <td style="text-align: left;">pay_type</td> <td style="text-align: left;">string(3)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">支付类型: 300支付宝,400微信,600.云闪付</td> <td>300</td> </tr> <tr> <td style="text-align: left;">pay_trace_no</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">(必须在商户系统内唯一;且长度不超过64字节)</td> <td>51c7d68424e5492199cf7f4734a2b977</td> </tr> <tr> <td style="text-align: left;">pay_time</td> <td style="text-align: left;">string(14)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">请求支付时间,yyyyMMddHHmmss格式</td> <td>20181116155621</td> </tr> <tr> <td style="text-align: left;">auth_code</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">付款码</td> <td>135294518338457819</td> </tr> <tr> <td style="text-align: left;">total_amount</td> <td style="text-align: left;">string(8)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">支付金额,单位:分</td> <td>100</td> </tr> <tr> <td style="text-align: left;">order_body</td> <td style="text-align: left;">string(128)</td> <td style="text-align: left;"></td> <td style="text-align: left;">订单描述</td> <td>苹果</td> </tr> <tr> <td style="text-align: left;">attach</td> <td style="text-align: left;">string(128)</td> <td style="text-align: left;"></td> <td style="text-align: left;">自定义参数,原样返回</td> <td>1234</td> </tr> <tr> <td style="text-align: left;">notify_url</td> <td style="text-align: left;">string(255)</td> <td style="text-align: left;"></td> <td style="text-align: left;">回调地址,对于超时订单,系统自动推送订单支付结果</td> <td><a href="https://test.gdyfsk.com/notifty">https://test.gdyfsk.com/notifty</a></td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">签名字符串,拼装所有值不为空(null值不参与签名,空字符串参与)</td> <td>51c7d68424e5492199cf7f4734a2b977</td> </tr> </tbody> </table> <p><code>备注:</code> sign 字段传递参数按照字典序用&amp;符号连接最后拼接机构key,UTF-8编码,32位md5加密转换, 示例:a=1&amp;b=1&amp;c=1&amp;d=1&amp;key=51c7d68424e5492199cf7f4734a2b977</p> <p><strong>请求示例:</strong></p> <p><a href="https://test.gdyfsk.com/yfpay/scaniot/qm50s/pay?inst_no=900376&amp;terminal_no=70005338&amp;pay_type=300&amp;pay_trace_no=2024120511174969&amp;total_amount=1&amp;auth_code=288961884219692248&amp;sign=a8b50e64850017f5bd77cb130ae441c6">https://test.gdyfsk.com/yfpay/scaniot/qm50s/pay?inst_no=900376&amp;terminal_no=70005338&amp;pay_type=300&amp;pay_trace_no=2024120511174969&amp;total_amount=1&amp;auth_code=288961884219692248&amp;sign=a8b50e64850017f5bd77cb130ae441c6</a></p> <pre><code class="language-json">{ &amp;quot;inst_no&amp;quot;: &amp;quot;900075&amp;quot;, &amp;quot;terminal_no&amp;quot;: &amp;quot;70020283&amp;quot;, &amp;quot;pay_type&amp;quot;: &amp;quot;300&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;auth_code&amp;quot;: &amp;quot;136227154669209037&amp;quot;, &amp;quot;total_amount&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;order_body&amp;quot;: &amp;quot;休休测试&amp;quot;, &amp;quot;attach&amp;quot;: &amp;quot;888&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;2a687258945430e546c172fbfa57bee7&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>参数示例</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">return_code</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">响应码:SUCCESS成功,FAIL失败,响应码仅代表通信或参数</td> <td>SUCCESS</td> </tr> <tr> <td style="text-align: left;">return_msg</td> <td style="text-align: left;">string(128)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">返回信息提示,“支付成功”,“支付中”,“参数不合法” 等</td> <td>支付成功</td> </tr> <tr> <td style="text-align: left;">result_code</td> <td style="text-align: left;">string(32)</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>PAY_SUCCESS</td> </tr> <tr> <td style="text-align: left;">terminal_no</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">乐收赢终端号</td> <td>70020283</td> </tr> <tr> <td style="text-align: left;">pay_trace_no</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">请求流水号(必须在商户系统内唯一;且长度不超过64字节)</td> <td>51c7d68424e5492199cf7f4734a2b977</td> </tr> <tr> <td style="text-align: left;">pay_time</td> <td style="text-align: left;">string(14)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">请求交易时间,yyyyMMddHHmmss</td> <td>20181116155621</td> </tr> <tr> <td style="text-align: left;">end_time</td> <td style="text-align: left;">string(14)</td> <td style="text-align: left;"></td> <td style="text-align: left;">支付完成时间,yyyyMMddHHmmss</td> <td>20181116155621</td> </tr> <tr> <td style="text-align: left;">total_amount</td> <td style="text-align: left;">string(8)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">支付金额,单位:分</td> <td>100</td> </tr> <tr> <td style="text-align: left;">receipt_amount</td> <td style="text-align: left;">string(8)</td> <td style="text-align: left;"></td> <td style="text-align: left;">商户实收金额,单位:分</td> <td>100</td> </tr> <tr> <td style="text-align: left;">trade_no</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">乐收赢订单号</td> <td>20000002814118090716435200001</td> </tr> <tr> <td style="text-align: left;">td_trade_no</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;"></td> <td style="text-align: left;">微信或支付宝订单号</td> <td>4200000531202006076268443909</td> </tr> <tr> <td style="text-align: left;">qd_trade_no</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;"></td> <td style="text-align: left;">渠道订单号,支付渠道订单号 可以用于扫码退款</td> <td>20000002814118090716435200001</td> </tr> <tr> <td style="text-align: left;">user_id</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;">渠道用户信息,微信openid、支付宝账户等</td> <td style="text-align: left;">oSKoR1uw9jNsGG6EU-N3MV0z_cNM</td> </tr> <tr> <td style="text-align: left;">attach</td> <td style="text-align: left;">string(128)</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(32)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">签名字符串</td> <td>51c7d68424e5492199cf7f4734a2b977</td> </tr> </tbody> </table> <p><strong>返回示例:</strong> </p> <pre><code class="language-json">{ &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_IN_PROCESS&amp;quot;, &amp;quot;terminal_no&amp;quot;: &amp;quot;70020283&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;: &amp;quot;20180907164353&amp;quot;, &amp;quot;trade_no&amp;quot;: &amp;quot;20000002814118090716435200001&amp;quot;, &amp;quot;td_trade_no&amp;quot;: null, &amp;quot;qd_trade_no&amp;quot;: null, &amp;quot;user_id&amp;quot;: null, &amp;quot;attach&amp;quot;: &amp;quot;1234&amp;quot;, &amp;quot;receipt_amount&amp;quot;: null, &amp;quot;sign&amp;quot;: &amp;quot;cb0c5a87b7d0d9a637439173ea6b5e43&amp;quot; } </code></pre>

页面列表

ITEM_HTML