付款码支付接口
<p><strong>接口描述：</strong> </p>
<ul>
<li>发起B扫C动态码支付交易</li>
</ul>
<p><strong>接口URL：</strong> </p>
<ul>
<li>测试<code>https://test.gdyfsk.com/yfpay/v3/pay</code></li>
<li>正式<code>https://open.gdyfsk.com/yfpay/v3/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/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>86000033007</td>
</tr>
<tr>
<td style="text-align: left;">terminal_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">C</td>
<td style="text-align: left;">乐收赢终端号或设备SN，扫码设备必传，绑定播报、打印等功能时必传</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;">是</td>
<td style="text-align: left;">支付类型：000自动识别，300支付宝，400微信，900.龙支付</td>
<td>000</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;">是</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;">是</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;">是</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;">是</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://open.gdyfsk.com/notifty">https://open.gdyfsk.com/notifty</a></td>
</tr>
<tr>
<td style="text-align: left;">goods_detail</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">详情内容，json格式的字符串</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">--goods_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商品编号</td>
<td>8005</td>
</tr>
<tr>
<td style="text-align: left;">--goods_name</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;">--goods_quantity</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商品数量</td>
<td>1</td>
</tr>
<tr>
<td style="text-align: left;">--goods_price</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;">share_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">1.乐收赢分账 2.三方分账</td>
<td>0</td>
</tr>
<tr>
<td style="text-align: left;">share_detail</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">分账详情，json格式的字符串</td>
<td>"{\"share_count\":\"2\",\"share_fee_mch\":\"851811130002\",\"share_array\":[{\"share_mch\":\"851811130002\",\"share_amount\":\"122\"},{\"share_mch\":\"851811130003\",\"share_amount\":\"322\"}]}"</td>
</tr>
<tr>
<td style="text-align: left;">--share_count</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">分账条目数</td>
<td>2</td>
</tr>
<tr>
<td style="text-align: left;">--share_fee_mch</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">承担手续费的商户</td>
<td>851811130002</td>
</tr>
<tr>
<td style="text-align: left;">--share_array</td>
<td style="text-align: left;">array</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">分账数组，json数组</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">----share_mch</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">分账商户号</td>
<td>851811130002</td>
</tr>
<tr>
<td style="text-align: left;">----share_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">分账金额，单位：分</td>
<td>122</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;">签名字符串,拼装所有值不为空（为null不参与，空字符串参与）</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><code>备注：</code> sign 字段传递参数按照字典序用&符号连接最后拼接机构key，UTF-8编码，32位md5加密转换， 示例：a=1&b=1&c=1&d=1&key=51c7d68424e5492199cf7f4734a2b977，详细见 [接入指引](<a href="https://www.showdoc.com.cn/leshouying/10788371225650114">https://www.showdoc.com.cn/leshouying/10788371225650114</a> "接入指引")</p>
<p><strong>请求示例：</strong></p>
<pre><code class="language-json">{
&quot;inst_no&quot;: 900075,
&quot;mch_no&quot;: &quot;Y52211090004&quot;,
&quot;pay_type&quot;: &quot;000&quot;,
&quot;pay_trace_no&quot;: &quot;134dsa463451313131313001&quot;,
&quot;pay_time&quot;: &quot;20780907150901&quot;,
&quot;auth_code&quot;: &quot;136227154669209037&quot;,
&quot;total_amount&quot;: &quot;1&quot;,
&quot;order_body&quot;: &quot;休休测试&quot;,
&quot;attach&quot;: &quot;888&quot;,
&quot;goods_detail &quot;: [{
&quot;goods_id&quot;: &quot;8005&quot;,
&quot;goods_name&quot;: &quot;苹果&quot;,
&quot;goods_quantity &quot;: &quot;1&quot;,
&quot;goods_price&quot;: &quot;100&quot;}] ,
&quot;sign&quot;: &quot;2a687258945430e546c172fbfa57bee7&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>
<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;">是</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;">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>86000033007</td>
</tr>
<tr>
<td style="text-align: left;">mch_name</td>
<td style="text-align: left;">string(80)</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(50)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">门店名称</td>
<td>1号店</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: left;">string(3)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">支付类型：300支付宝，400微信，900.龙支付</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;">是</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;">是</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;">是</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;">是</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;">discount_amount</td>
<td style="text-align: left;">string(8)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">优惠金额，单位：分</td>
<td>0</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><code>备注：</code> 若返回结果result_code=PAY_IN_PROCESS 支付中，需要调用订单查询接口进行轮询，建议返回后5秒开始。一共轮询15次间隔5秒</p>
<p><strong>返回示例：</strong> </p>
<pre><code class="language-json">{
&quot;return_code&quot;: &quot;SUCCESS&quot;,
&quot;return_msg&quot;: &quot;支付中&quot;,
&quot;result_code&quot;: &quot;PAY_IN_PROCESS&quot;,
&quot;pay_type&quot;: &quot;400&quot;,
&quot;mch_name&quot;: &quot;小白盒周康宝岛牛肉饭&quot;,
&quot;shop_name&quot;: &quot;&quot;,
&quot;mch_no&quot;: &quot;Y52211090004&quot;,
&quot;shop_no&quot;: null,
&quot;pay_trace_no&quot;: &quot;134dsa463451313131313001&quot;,
&quot;pay_time&quot;: &quot;20780907150901&quot;,
&quot;total_amount&quot;: &quot;1&quot;,
&quot;end_time&quot;: &quot;20180907164353&quot;,
&quot;trade_no&quot;: &quot;20000002814118090716435200001&quot;,
&quot;td_trade_no&quot;: null,
&quot;qd_trade_no&quot;: null,
&quot;user_id&quot;: null,
&quot;attach&quot;: &quot;1234&quot;,
&quot;receipt_amount&quot;: null,
&quot;sign&quot;: &quot;cb0c5a87b7d0d9a637439173ea6b5e43&quot;
}
</code></pre>