支付商户文档


(韩圆支付)创建收款单

<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> &quot;订单签名&quot;)</td> </tr> </tbody> </table> <p><strong> 請求示例</strong></p> <pre><code> { &amp;quot;amount&amp;quot;: &amp;quot;130000000&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;테스&amp;quot;, &amp;quot;user_id&amp;quot;: &amp;quot;playerA&amp;quot;, &amp;quot;notify_url&amp;quot;: &amp;quot;https://xxx.xx/notification&amp;quot;, &amp;quot;payment_cl_id&amp;quot;: &amp;quot;DEVPM00014581&amp;quot;, &amp;quot;platform_id&amp;quot;: &amp;quot;PF0002&amp;quot;, &amp;quot;request_time&amp;quot;: &amp;quot;1595504136&amp;quot;, &amp;quot;service_id&amp;quot;: &amp;quot;SVC0001&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;c81634c1769044eac9e9628a2292f557&amp;quot; } </code></pre> <p><strong>返回示例</strong></p> <pre><code> { &amp;quot;error_code&amp;quot;: &amp;quot;0000&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;link&amp;quot;: &amp;quot;https://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1nePB%2FayV7EO9S1EQ%3D%3D&amp;quot;, &amp;quot;register_link&amp;quot;: &amp;quot;httsp://xxx.xxx.xx/gateway/register/v1/payments/GqhJK1nePB%2FayV7EO9S1EQ%3D%3D&amp;quot; } }</code></pre> <p><strong>错误返回示例</strong></p> <pre><code> { &amp;quot;error_code&amp;quot;: &amp;quot;0004&amp;quot;, &amp;quot;error_msg&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>说明</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不为&quot;0000&quot;便返回)</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> &quot;service_id列表&quot;)</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> &quot;交易结果通知&quot;)</li> <li><code>需注意,此通道仅供实名用户收款,并且订单将以实际到帐金额为主,接收结果时必须使用 real_amount 为实际上分栏位</code></li> </ul>

页面列表

ITEM_HTML