HuiPay-development_one

开发中的文档


延时分账确认接口

<h5>简要描述</h5> <ul> <li>延时分账确认接口适用于延时分账的场景。只有已支付完成且延时分账的Payment对象,才支持调用创建支付确认对象。支持一次全额或多次部分确认,多次部分确认时,当前确认金额 + 已确认金额 + 已撤销金额不能大于原支付金额。</li> </ul> <h5>请求URL</h5> <ul> <li><code>https://pay.bjtdba.com/v1/HuiPay/payment_confirm_create</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> </ul> <h5>参数</h5> <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;">payment_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>支付对象id</td> </tr> <tr> <td style="text-align: left;">order_no</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>请求订单号,只能为英文、数字或者下划线的一种或多种组合,保证在app_id下唯一</td> </tr> <tr> <td style="text-align: left;">confirm_amt</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>确认金额,必须大于0,保留两位小数点,如0.10、100.05等。必须小于等于原支付金额-已确认金额-已撤销金额。</td> </tr> <tr> <td style="text-align: left;">description</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>附加信息</td> </tr> <tr> <td style="text-align: left;">div_members</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>分账对象信息列表,一次请求最多仅支持7个分账方。json对象 形式,详见 分账对象信息列表</td> </tr> <tr> <td style="text-align: left;">fee_mode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>固定值 I</td> </tr> <tr> <td style="text-align: left;">union_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>用户id 在平台注册后产生的用户唯一标识</td> </tr> <tr> <td style="text-align: left;">api_key</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>api_key 进件查询时返回的api_key</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>{ "payment_id":"0021120211206162575575379968", "order_no":"payment_confirm_c06170257639419", "api_key":"api_live_d996bd55a4a7-ec0574a24516", "confirm_amt":"0.02", "div_members":[ { "member_id":"0", "amount":"0.01", "fee_flag":"Y" }, { "member_id":"Member_erise_16377450631945", "amount":"0.01", "fee_flag":"N" } ], "description":"test 分账" }</code></pre> <h5>返回示例</h5> <pre><code> { "code":200, "message":"success", "data":{ "app_id":"app_bd46cc29-6b-a70f-65187485f468", "confirm_amt":"0.02", "confirmed_amt":"0.00", "created_time":"1638778539", "description":"test 分账", "div_members":[ { "amount":"0.01", "fee_flag":"Y", "member_id":"0" }, { "amount":"0.01", "fee_flag":"N", "member_id":"Member_enterprise_16450631945" } ], "fee_amt":"0.00", "id":"0021120211206160313844095629467648", "object":"payment_confirm", "order_no":"payment_confirm_create20211206161539792401", "refunded_amt":"0.00", "reserved_amt":"0.00", "status":"succeeded", "prod_mode":"true" } }</code></pre> <h5>返回参数说明</h5> <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;">id</td> <td style="text-align: left;">int</td> <td>确认支付的ID 用于查询</td> </tr> <tr> <td style="text-align: left;">app_id</td> <td style="text-align: left;">string</td> <td>应用的app_id</td> </tr> <tr> <td style="text-align: left;">confirm_amt</td> <td style="text-align: left;">string</td> <td>确认金额, 必须大于0,保留两位小数点,如0.10、100.05等。必须小于等于原支付金额-已确认金额-已撤销金额。</td> </tr> <tr> <td style="text-align: left;">confirmed_amt</td> <td style="text-align: left;">string</td> <td>原支付对象已确认金额。</td> </tr> <tr> <td style="text-align: left;">created_time</td> <td style="text-align: left;">string</td> <td>创建时的时间戳</td> </tr> <tr> <td style="text-align: left;">description</td> <td style="text-align: left;">string</td> <td>附加说明</td> </tr> <tr> <td style="text-align: left;">div_members</td> <td style="text-align: left;">string</td> <td>参考支付时的div_members参数说明</td> </tr> <tr> <td style="text-align: left;">refunded_amt</td> <td style="text-align: left;">string</td> <td>当前支付确认对象已退款金额,包括已退款完成金额和退款处理中的金额。</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">string</td> <td>pending 交易处理中<br>succeeded 交易成功<br>failed 交易失败</td> </tr> </tbody> </table>

页面列表

ITEM_HTML