支付商户文档


(日本支付)创建出款单

<p><strong>简要描述:</strong></p> <ul> <li>创建出款接口</li> </ul> <p><strong>请求URL:</strong></p> <ul> <li><code>/gateway/api/v2/payouts</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,固定值SVC0004</td> </tr> <tr> <td style="text-align: left;">payout_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_name</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>银行名称</td> </tr> <tr> <td style="text-align: left;">branch_name</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>支行名</td> </tr> <tr> <td style="text-align: left;">branch_code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</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;">number</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</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>[签名说明][2571966527973026]</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <pre><code>{ &amp;quot;amount&amp;quot;: 50000, &amp;quot;name&amp;quot;: &amp;quot;首田榮二郎&amp;quot;, &amp;quot;notify_url&amp;quot;: &amp;quot;https://xxx.xx/notification&amp;quot;, &amp;quot;bank_name&amp;quot;: &amp;quot;三井住友銀行&amp;quot;, &amp;quot;branch_name&amp;quot;: &amp;quot;TEST&amp;quot;, &amp;quot;branch_code&amp;quot;: &amp;quot;TEST&amp;quot;, &amp;quot;number&amp;quot;: &amp;quot;9876543210&amp;quot;, &amp;quot;payout_cl_id&amp;quot;: &amp;quot;DEVPOT00143538&amp;quot;, &amp;quot;platform_id&amp;quot;: &amp;quot;PF0002&amp;quot;, &amp;quot;request_time&amp;quot;: &amp;quot;1595504997&amp;quot;, &amp;quot;service_id&amp;quot;: &amp;quot;SVC0004&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;8ac38fb87c2bcce4cf36627d4f8aa747&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;payout_id&amp;quot;: &amp;quot;POT00000001&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> </tbody> </table> <p><strong>备注</strong></p> <ul> <li>商户Id为系统分配之唯一识别,如尚未取得请联系系统人员</li> <li>服务Id请填入<code>SVC0004</code>(银行卡代付)</li> <li>交易金额单位为分,请乘以100传入,例如收款10000.00请传值1000000</li> <li>请求时间使用Unix timestamp,单位为秒</li> <li>返回0000时仅代表接口调用成功,并不表示交易状态,请调用查询接口确认结果</li> <li>如遇任何情况未取得server回应(e.g. 5xx HttpStatus, ...),需调用查询接口或等待回调,不可直接视为订单失败</li> </ul>

页面列表

ITEM_HTML