可分账余额查询

分账余额查询用于查询一笔支付单在途资金的商户可支配金额（即如果该笔订单分账时平台会扣费，则会返回扣费或退款后的可分账金额）。
接口频次
60QPS(小程序 app_id 维度)
将整单分账结果通知给开发者/服务商。

接口说明

回调地址会优先使用开发者在预下单接口传入的notify_url，如果预下单时没有传入，会请求开发者在进件时设置的支付URL，该URL查看步骤如下【开放平台控制台->小程序->能力->支付能力->支付设置】。

支付回调一定要做验签处理，防止收到假通知，回调验签的Token见上图中的Token【开放平台控制台->小程序->能力->支付能力->支付设置】；Token在发生变更时，会以订单在支付时设置的Token为准。

分账成功或者分账失败都会进行回调通知。

回调可能存在延时，若实时性要求高，开发者可以通过主动请求分账查询接口，获取分账结果。

回调接口最多重试 15 次（共 16 次），重试间隔分别为（15s、15s、30s、3min、10min、20min、30min、30min、30min、60min、3h、3h、3h、6h、6h）

在开发者服务端收到回调且处理成功后，需要按文档中响应示例 json格式返回表示处理成功，否则小程序服务端会认为通知失败进行重试。

错误码

错误码err_no	描述	排查建议
0	success	成功
1000	系统异常，请原单号重试	服务内部异常，请稍后重试
1001	业务繁忙，请稍后重试	限流（单app_id维度限流60qps），请在业务低峰期后原参数重试
1004	网络不稳定，请稍后重试	网络不稳定，请稍后重试
2000	单号记录不存在	传入的外部支付单号out_order_no查无对应支付单，检查并调整参数后重试
2010	业务参数处理异常	请检查参数后重试（是否缺少必填参数，参数是否合法等）
6002	原支付单未支付成功，禁止分账余额查询	原支付单未支付成功并核销，禁止分账余额查询

curl --location --request POST 'https://developer.toutiao.com/api/apps/ecpay/v1/unsettle_amount' \ --header 'Content-Type: application/json' \ --data-raw '{ "out_order_no": "out7101994117563058470", "app_id": "tt07e3715e98c9aac0", "sign": "d98e6af1c490b36f7b72e2037f81a511" }'

{ "err_no": 0, "err_tips": "string", "data": { "out_order_no": "string", "unsettle_amount": 0, "detail": { "pay_info": { "out_order_no": "string", "amount": 0 }, "refund_info": [ { "out_refund_no": "string", "amount": 0 } ], "payment_rake": 0, "life_rake": 0, "commission": 0 } } }

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

err_tips

string

必需

data

object

必需

err_no=0时必填

out_order_no

string

必需

商户侧的订单号，请求参数原样返回

unsettle_amount

integer

必需

剩余待结算金额，单位为分

detail

object

必需

订单动账信息(详见下方参数信息)

🟠400请求有误

可分账余额查询

接口说明#

错误码#

请求参数

返回响应

接口说明

错误码