(韩圆支付)创建收款单
<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;">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;">user_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(16)</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;">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;130000000&quot;,
&quot;name&quot;: &quot;테스&quot;,
&quot;user_id&quot;: &quot;playerA&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;https://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1nePB%2FayV7EO9S1EQ%3D%3D&quot;,
&quot;register_link&quot;: &quot;httsp://xxx.xxx.xx/gateway/register/v1/payments/GqhJK1nePB%2FayV7EO9S1EQ%3D%3D&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;">register_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>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>商户Id为系统分配之唯一识别,如尚未取得请联系系统人员</li>
<li>服务Id请填入<code>SVC0026</code>(ATM支付) 或更多请参考[service_id列表](<a href="https://www.showdoc.com.cn/fantian/2576861531680654">https://www.showdoc.com.cn/fantian/2576861531680654</a> "service_id列表")</li>
<li>交易金额单位为韩圆(分),假使收款10000,请乘以100,传入1000000</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>
<li><code>需注意,此通道仅供实名用户收款,并且订单将以实际到帐金额为主,接收结果时必须使用 real_amount 为实际上分栏位</code></li>
</ul>