支付商户文档


(人民币-银行卡代付)创建出款单

<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</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;">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;: &amp;quot;50000&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;test_name&amp;quot;, &amp;quot;notify_url&amp;quot;: &amp;quot;https://xxx.xx/notification&amp;quot;, &amp;quot;number&amp;quot;: &amp;quot;4088748280272397&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> <p><code>注意(非常重要!):因为存在网络波动、并发量过大、被攻击等不可抗力因素,如若在调用代付接口时遇到超时、HTTP500错误、调用结果返回空白,或网路延迟时,请以订单查询接口状态为依据,或与运营人员取得联系,提供商户单号进行人工查询,由运营人员人工确认代付订单是否失败。未经过运营人员人工确认就驳回代付订单所造成的损失,本平台概不负责!</code></p> <ul> <li>商户Id为系统分配之唯一识别,如尚未取得请联系系统人员</li> <li>钱包Id为系统根据收款渠道分配,可于商户后台首页获得或从余额查询接口获得, 可不填写由系统自动选择出款钱包</li> <li>服务Id请填入<code>SVC0004</code>(银行卡代付)</li> <li>交易金额单位为人民币(分)</li> <li>请求时间使用Unix timestamp,单位为秒</li> <li>返回0000时仅代表接口调用成功,并不表示交易状态,请调用查询接口确认结果</li> <li>如遇任何情况未取得server回应(e.g. 5xx HttpStatus, ...),需调用查询接口或等待回调,不可直接视为订单失败</li> </ul> <p>[2571966527973026]: <a href="https://www.showdoc.com.cn/fantian?page_id=2571966527973026">https://www.showdoc.com.cn/fantian?page_id=2571966527973026</a> &quot;订单签名&quot;</p>

页面列表

ITEM_HTML