乐收赢API

银飞乐收赢接口文档


待支付订单创建

<p><strong>接口描述:</strong> </p> <ul> <li>待支付订单创建接口,用于POS内置的APP发起有订单支付</li> <li>释义:</li> <li>1)用户调用此接口创建待支付订单,订单默认支付方式为刷卡,默认支付类型为刷卡</li> <li>2)通过POS内置的APP调用待支付订单查询接口,对待支付订单发起支付</li> <li>3)支付完成后订单支付类型、支付方式同步为用户实际付款信息</li> </ul> <p><strong>接口URL:</strong> 测试 <code>https://test.gdyfsk.com/yfpay/v3/trade/createPay</code> 正式 <code>https://open.gdyfsk.com/yfpay/v3/trade/createPay</code></p> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>请求头部:</strong></p> <table> <thead> <tr> <th style="text-align: left;">标签</th> <th style="text-align: left;">必填</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">Content-Type</td> <td style="text-align: left;">是</td> <td>application/json</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;">是</td> <td style="text-align: left;">机构号,系统分配</td> <td>900075</td> </tr> <tr> <td style="text-align: left;">mch_no</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">商户号</td> <td>Y52211090004</td> </tr> <tr> <td style="text-align: left;">shop_no</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">否</td> <td style="text-align: left;">门店号</td> <td>S000001</td> </tr> <tr> <td style="text-align: left;">terminal_no</td> <td style="text-align: left;">string</td> <td style="text-align: left;">是</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</td> <td style="text-align: left;">是</td> <td style="text-align: left;">请求流水号(在商户系统内唯一)</td> <td>51c7d68424e5492199cf7f4734a2b977</td> </tr> <tr> <td style="text-align: left;">total_amount</td> <td style="text-align: left;">string</td> <td style="text-align: left;">是</td> <td style="text-align: left;">支付金额,单位:分</td> <td>100</td> </tr> <tr> <td style="text-align: left;">notify_url</td> <td style="text-align: left;">string</td> <td style="text-align: left;">否</td> <td style="text-align: left;">回调地址(如果传值就以此为主,否则默认用渠道配置)</td> </tr> <tr> <td style="text-align: left;">order_body</td> <td style="text-align: left;">string</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</td> <td style="text-align: left;">否</td> <td style="text-align: left;">自定义参数,原样返回</td> <td>1234</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">签名</td> <td>51c7d68424e5492199cf7f4734a2b977</td> </tr> </tbody> </table> <p><strong>请求示例:</strong></p> <pre><code class="language-json">{ &amp;quot;pay_trace_no&amp;quot;: &amp;quot;57c8666e21274ebc81c83774e3754496&amp;quot;, &amp;quot;inst_no&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;terminal_no&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;total_amount&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;3ac14bc7a0bce75a2c2aaad45938a647&amp;quot;, &amp;quot;mch_no&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;notify_url&amp;quot;: &amp;quot;www.baidu.com&amp;quot;, &amp;quot;order_body&amp;quot;: &amp;quot;夏季校服&amp;quot;, &amp;quot;shop_no&amp;quot;: &amp;quot;&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;">是</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;">是</td> <td style="text-align: left;">返回消息提示 关单成功,关单失败等</td> </tr> <tr> <td style="text-align: left;">result_code</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">只有在return_code为SUCCESS时有返回,PAY_SUCEESS为创建订单成功</td> </tr> <tr> <td style="text-align: left;">mch_name</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">商户名称</td> <td>张三个体户</td> </tr> <tr> <td style="text-align: left;">shop_name</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">否</td> <td style="text-align: left;">门店名称</td> <td>金沙洲店</td> </tr> <tr> <td style="text-align: left;">mch_no</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">商户号</td> <td>Y52211090004</td> </tr> <tr> <td style="text-align: left;">shop_no</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">否</td> <td style="text-align: left;">门店号</td> <td>S000001</td> </tr> <tr> <td style="text-align: left;">pay_trace_no</td> <td style="text-align: left;">string</td> <td style="text-align: left;">是</td> <td style="text-align: left;">请求流水号</td> <td>51c7d68424e5492199cf7f4734a2b977</td> </tr> <tr> <td style="text-align: left;">total_amount</td> <td style="text-align: left;">string</td> <td style="text-align: left;">是</td> <td style="text-align: left;">支付金额,单位:分</td> <td>100</td> </tr> <tr> <td style="text-align: left;">out_trade_no</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">乐收赢订单号</td> <td>2018116165053</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>1234</td> </tr> <tr> <td style="text-align: left;">terminal_no</td> <td style="text-align: left;">string</td> <td style="text-align: left;">是</td> <td style="text-align: left;">乐收赢终端号</td> <td>70020283</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</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;success&amp;quot;, &amp;quot;mch_name&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;shop_name&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;mch_no&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;shop_no&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;pay_trace_no&amp;quot;: &amp;quot;57c8666e21274ebc81c83774e3754496&amp;quot;, &amp;quot;total_amount&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;out_trade_no&amp;quot;: &amp;quot;200002394PAY250107163728T0xx&amp;quot;, &amp;quot;attach&amp;quot;: null, &amp;quot;terminal_no&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;305a4e36981da8266fb2abc0482c5793&amp;quot; }</code></pre>

页面列表

ITEM_HTML