快捷支付-下单接口
<p><strong>接口描述：</strong> </p>
<ul>
<li>创建订单接口，创建快捷支付订单接口</li>
</ul>
<p><strong>接口URL：</strong> </p>
<ul>
<li><code>https://open.51shoubei.com/openpay/v3/fastPay</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</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">机构号 ，收呗分配</td>
<td>900024</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</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;">shop_no</td>
<td style="text-align: left;">string</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</td>
<td style="text-align: left;">否</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</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">支付类型：200 快捷支付 目前仅支持200</td>
<td>200</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;">pay_time</td>
<td style="text-align: left;">string</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</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</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;">bind_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">绑卡唯一标识id在确认绑卡接口中获取</td>
<td>12341234123</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>
<td></td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</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.cc/shoubei?page_id=2361130764227691">https://www.showdoc.cc/shoubei?page_id=2361130764227691</a> "接入指引")</p>
<p><strong>请求示例：</strong></p>
<pre><code class="language-json">{
&quot;bind_id&quot;: &quot;1066015375&quot;,
&quot;inst_no&quot;: &quot;900024&quot;,
&quot;mch_no&quot;: &quot;852308230099&quot;,
&quot;pay_time&quot;: &quot;20241106150242&quot;,
&quot;pay_trace_no&quot;: &quot;dc0833d086094ee0b6ab88391035dc80&quot;,
&quot;pay_type&quot;: &quot;200&quot;,
&quot;sign&quot;: &quot;f7f6960d62883a8468546467c4950a93&quot;,
&quot;total_amount&quot;: &quot;1&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</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</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</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</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户号</td>
<td>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>86000033007</td>
</tr>
<tr>
<td style="text-align: left;">mch_name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户名称</td>
<td>休休4D</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>1号店</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">支付类型：200快捷支付</td>
<td>200</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;">pay_time</td>
<td style="text-align: left;">string</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</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</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">收呗订单号</td>
<td>20000002814118090716435200001</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;">supply_need_item_scene</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">提交补充项场景(请求验证码时/确认支付时/无需补充) REQUEST_VERIFY/CONFIRM_PAY/NONE</td>
<td>NONE</td>
</tr>
<tr>
<td style="text-align: left;">is_send_sms</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">是否需要短信确认 1 是 0 否</td>
<td>1</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">签名字符串，拼装所有传递参数，UTF-8编码，32位md5加密转换签名字符串</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong> </p>
<p>成功返回内容：</p>
<pre><code class="language-json">{
&quot;channel_order_no&quot;: &quot;3246353543&quot;,
&quot;is_send_sms&quot;: &quot;1&quot;,
&quot;mch_name&quot;: &quot;收呗数科-微企付&quot;,
&quot;mch_no&quot;: &quot;852308230099&quot;,
&quot;pay_time&quot;: &quot;20241106152515&quot;,
&quot;pay_trace_no&quot;: &quot;7e3772d225c84765a976489e8de759f3&quot;,
&quot;pay_type&quot;: &quot;200&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;&quot;,
&quot;sign&quot;: &quot;85773521884caa802e7e9a0cd3f0a6ca&quot;,
&quot;supply_need_item_scene&quot;: &quot;NONE&quot;,
&quot;total_amount&quot;: &quot;1&quot;,
&quot;trade_no&quot;: &quot;200019243O29241106152515T0002&quot;
}
</code></pre>