分润结算
分润结算是指分润数据产生后,根据一定条件对分润数据进行汇总,然后再根据汇总信息对每个分润接收方发起结算。
分润结算只能由分润发起方创建,生成在分润发起方的应用下,不能由接收方创建。
如果订单收款方是子商户,则需该子商户发起分润结算(使用子商户的 API KEY 和应用 ID)。
发起分润结算的前置条件:
1、配置分润结算所需要的付款渠道,目前支持支付宝、微信(App、JSAPI 和小程序)、银联电子代付、通联代付、京东代付以及 Ping++ 余额渠道(无需额外配置)。
2、为需要接收分润的用户配置相应渠道的结算账户,参考 用户结算账户 。
分润结算创建时需要指定结算使用渠道,同时指定分润结算的范围,支持按时间维度,接收分润方维度和订单维度筛选分润对象。
- 对于商户或子商户而言,需要按照双方的约定时间,调用 Server-SDK 的创建分润结算 API 发起请求;
- Ping++ 接受请求后对满足条件的分润对象汇总生成新的分润结算对象,并返回给服务端。注:汇总过的分润对象不能再次被汇总结算,此时分润对象的状态为结算汇总。
- 服务端接收分润结算对象后,可以自行决定是否同意结算,调用 Server-SDK 的确认分润结算 API 发起请求。如果撤销,分润结算对象变为结算已撤销状态,同时分润对象会回到入账状态。
- Ping++ 接受确认后,向渠道发送企业付款请求,并返回已发起状态的分润结算对象。
- 服务端接收分润结算对象后,Ping++ 将会按照实际分润结算的情况,推送对应的
royalty_settlement.succeeded
分润结算成功、royalty_settlement.failed
分润结算失败、royalty_settlement.partially_succeeded
分润结算部分成功、royalty_settlement.canceled
分润结算全部撤销的 Webhooks 事件回调,你的服务端需要监听并接受 Webhooks 回调; - 请务必加上分润结算结果的主动查询机制:如果在可接受时间范围内没有收到 Webhooks 通知,你也可以调用 Server-SDK 封装的查询方法,主动向 Ping++ 发起请求来获得订单状态,该查询结果可以作为交易结果。
注意事项:
- 汇总分润对象时,需要满足汇总后对分润接收方的分润金额大于等于 0 时才可发起结算
- 如果只是想查看分润结算信息,不想真实生成分润结算对象,可以使用结算预览参数进行预览
- 如果分润结算失败,对应的分润对象会回到入账状态,可以重新发起分润结算
- 此接口需要使用创建 Order 时收款方(
receipt_app
)的APIKey
和私钥请求 API 接口
下一步分润结算明细