(人民币支付)创建收款单
<p><strong>简要描述：</strong> </p>
<ul>
<li>创建收款接口</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>/gateway/api/v1/payments</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li><code>POST</code></li>
</ul>
<p><strong>请求头：</strong></p>
<ul>
<li><code>Content-Type: application/json;charset=utf-8</code></li>
</ul>
<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>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">platform_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(7)</td>
<td>商户Id</td>
</tr>
<tr>
<td style="text-align: left;">service_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(7)</td>
<td>服务Id</td>
</tr>
<tr>
<td style="text-align: left;">payment_cl_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer(10)</td>
<td>金额(分)</td>
</tr>
<tr>
<td style="text-align: left;">notify_url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(256)</td>
<td>交易结果通知地址</td>
</tr>
<tr>
<td style="text-align: left;">bank_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(6)</td>
<td>汇款人银行Id</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(16)</td>
<td>汇款人户名(如果为实名制渠道必填)</td>
</tr>
<tr>
<td style="text-align: left;">last_number</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(6)</td>
<td>汇款人帐户末六码</td>
</tr>
<tr>
<td style="text-align: left;">request_time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer(10)</td>
<td>请求时间(秒)</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>[订单签名](<a href="https://www.showdoc.com.cn/fantian/2571966527973026">https://www.showdoc.com.cn/fantian/2571966527973026</a> "订单签名")</td>
</tr>
</tbody>
</table>
<p><strong> 請求示例</strong></p>
<pre><code> {
&quot;amount&quot;: &quot;50000&quot;,
&quot;bank_id&quot;: &quot;BK0002&quot;,
&quot;last_number&quot;: &quot;123456&quot;,
&quot;name&quot;: &quot;test_name&quot;,
&quot;notify_url&quot;: &quot;https://xxx.xx/notification&quot;,
&quot;payment_cl_id&quot;: &quot;DEVPM00014581&quot;,
&quot;platform_id&quot;: &quot;PF0002&quot;,
&quot;request_time&quot;: &quot;1595504136&quot;,
&quot;service_id&quot;: &quot;SVC0001&quot;,
&quot;sign&quot;: &quot;c81634c1769044eac9e9628a2292f557&quot;
} </code></pre>
<p><strong>返回示例</strong></p>
<pre><code> {
&quot;error_code&quot;: &quot;0000&quot;,
&quot;data&quot;: {
&quot;link&quot;: &quot;http://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1nePB%2FayV7EO9S1EQ%3D%3D,
}
}</code></pre>
<p>根据不同支付渠道, 回应将包含订单资讯</p>
<pre><code>{
&quot;error_code&quot;: &quot;0000&quot;,
&quot;data&quot;: {
&quot;link&quot;: &quot;https://best-dpay.com/gateway/portal/v2/payments/?payment_id=PM00161864&amp;sign=ad3a5bfdcda4cdb9f&quot;,
&quot;payment_info&quot;: {
&quot;amount&quot;: 50000,
&quot;display_amount&quot;: 49996,
&quot;payment_id&quot;: &quot;PM00161864&quot;,
&quot;payment_cl_id&quot;: &quot;DEVPM00014581&quot;,
&quot;receiver&quot;: {
&quot;card_name&quot;: &quot; 測試代收卡01&quot;,
&quot;card_number&quot;: &quot;201408150955&quot;,
&quot;bank_name&quot;: &quot;中国建设银行&quot;,
&quot;bank_branch&quot;: &quot; 測試代收卡01&quot;,
&quot;bank_logo&quot;: &quot;https://apimg.alipay.com/combo.png?d=cashier&amp;t=CCB&quot;
},
&quot;sender&quot;: {
&quot;card_name&quot;: &quot;test_name&quot;,
&quot;card_number&quot;: &quot;*************123456&quot;,
&quot;bank_name&quot;: &quot;中国农业银行&quot;,
&quot;bank_logo&quot;: &quot;https://apimg.alipay.com/combo.png?d=cashier&amp;t=ABC&quot;,
&quot;bank_link&quot;: &quot;https://perbank.abchina.com/EbankSite/startup.do?r=6CD8F48924CC703B&quot;
},
&quot;token&quot;: &quot;26022&quot;
}
}
}</code></pre>
<p>支付宝扫码返回（支付宝转帐模式）
<strong>须注意因渠道缘故，使用支付宝扫码的商户将随机收到支付宝转帐以及扫码模式的返回，串接时需要能适应这两种返回格式</strong></p>
<pre><code>{
&quot;error_code&quot;: &quot;0000&quot;,
&quot;data&quot;: {
&quot;link&quot;: &quot;https://mwifuswzv.com/orders/9ef21531-8587-4520-aaef-b566b52de1e5?token=eyJhbGciOiJSUzI1NiJ9.eyJvcmRlcl9pZCI6IjllZjIxNTMxLTg1ODctNDUyMC1hYWVmLWI1NjZiNTJkZTFlNSJ9.YB9AUbWV_s7SN23NI78mchMLeWBGm4_zY0eddTdrc3YVzdjyZu1lW4zYt9cFD3Ai6_5I6M8Rt7Rx9QRTXzSP_jOs1dUp2ZUYosCBYi5-PjNG1Cl4VudgvA9CJQ8n9SuVP42nlL-QdWs-4VE3I_FextbtEm4FWbP9yfsiDMo_zX_vOFK_LvPzgxFDdyWoSEVGpQtPMCtEmBxAUi2Kot8ktJ2-2UKferKzEu2jrXGwiRbDJstuV3Y7B2Eu94t9fqQ69h9psQqxnXh3NrhNXz02W1Zd25PSrSUWwKPzSsxec14BS2xgV-Qfv4tEU6QvXkNxjI6bbHkmYj1eVDMBkx5j9A&quot;,
&quot;payment_info&quot;: {
&quot;amount&quot;: 273081,
&quot;display_amount&quot;: 273081,
&quot;payment_id&quot;: &quot;KUITECPM02239985&quot;,
&quot;payment_cl_id&quot;: &quot;test_1706530149_10&quot;,
&quot;token&quot;: &quot;无须附言&quot;,
&quot;alipay_account_name&quot;: &quot;2827147939@qq.com&quot;,
&quot;alipay_surname&quot;: &quot;郭&quot;
}
}
}</code></pre>
<p>支付宝扫码返回（扫码模式）
<strong>须注意因渠道缘故，使用支付宝扫码的商户将随机收到支付宝转帐以及扫码模式的返回，串接时需要能适应这两种返回格式</strong></p>
<pre><code>{
&quot;error_code&quot;: &quot;0000&quot;,
&quot;data&quot;: {
&quot;link&quot;: &quot;https://mwifuswzv.com/orders/9ef21531-8587-4520-aaef-b566b52de1e5?token=eyJhbGciOiJSUzI1NiJ9.eyJvcmRlcl9pZCI6IjllZjIxNTMxLTg1ODctNDUyMC1hYWVmLWI1NjZiNTJkZTFlNSJ9.YB9AUbWV_s7SN23NI78mchMLeWBGm4_zY0eddTdrc3YVzdjyZu1lW4zYt9cFD3Ai6_5I6M8Rt7Rx9QRTXzSP_jOs1dUp2ZUYosCBYi5-PjNG1Cl4VudgvA9CJQ8n9SuVP42nlL-QdWs-4VE3I_FextbtEm4FWbP9yfsiDMo_zX_vOFK_LvPzgxFDdyWoSEVGpQtPMCtEmBxAUi2Kot8ktJ2-2UKferKzEu2jrXGwiRbDJstuV3Y7B2Eu94t9fqQ69h9psQqxnXh3NrhNXz02W1Zd25PSrSUWwKPzSsxec14BS2xgV-Qfv4tEU6QvXkNxjI6bbHkmYj1eVDMBkx5j9A&quot;,
&quot;payment_info&quot;: {
&quot;amount&quot;: 273081,
&quot;display_amount&quot;: 273081,
&quot;payment_id&quot;: &quot;KUITECPM02239985&quot;,
&quot;payment_cl_id&quot;: &quot;test_1706530149_10&quot;,
&quot;token&quot;: &quot;无须附言&quot;,
&quot;qr_code_url&quot;: &quot;https://qr.alipay.com/tsx11102hlw8nncztyzu9e0&quot;
}
}
}</code></pre>
<p><strong>错误返回示例</strong></p>
<pre><code> {
&quot;error_code&quot;: &quot;0004&quot;,
&quot;error_msg&quot;: &quot;验签错误!&quot;
}</code></pre>
<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;">error_code</td>
<td style="text-align: left;">String</td>
<td>错误码</td>
</tr>
<tr>
<td style="text-align: left;">error_msg</td>
<td style="text-align: left;">String</td>
<td>错误讯息(如果error_code不为"0000"便返回)</td>
</tr>
<tr>
<td style="text-align: left;">link</td>
<td style="text-align: left;">String</td>
<td>订单收银地址</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">Int</td>
<td>提单金额</td>
</tr>
<tr>
<td style="text-align: left;">display_amount</td>
<td style="text-align: left;">Int</td>
<td>浮动后须支付金额</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>商户Id为系统分配之唯一识别，如尚未取得请联系系统人员</li>
<li>服务Id请填入<code>SVC0001</code>(银行卡代收) 或更多请参考[service_id列表](<a href="https://www.showdoc.com.cn/fantian/2576861531680654">https://www.showdoc.com.cn/fantian/2576861531680654</a> "service_id列表")</li>
<li>银行id可传入bank_id也可使用bank_code, 请查<a href="https://www.showdoc.com.cn/fantian/2576861531680654">数据枚举表</a></li>
<li>交易金额单位为人民币(分)</li>
<li>请求时间使用Unix timestamp，单位为秒</li>
<li>交易结果将通知至notify_url，请传入可公开访问之完整地址(仅支援http与https协议)
，参数规范见[交易结果通知](<a href="https://www.showdoc.cc/441136200448528?page_id=2571995960819336">https://www.showdoc.cc/441136200448528?page_id=2571995960819336</a> "交易结果通知")</li>
</ul>