分润结算

分润结算是指分润数据产生后,根据一定条件对分润数据进行汇总,然后再根据汇总信息对每个分润接收方发起结算。

分润结算只能由分润发起方创建,生成在分润发起方的应用下,不能由接收方创建。

如果订单收款方是子商户,则需该子商户发起分润结算(使用子商户的 API KEY 和应用 ID)。

发起分润结算的前置条件:

1、配置分润结算所需要的付款渠道,目前支持支付宝、微信(App、JSAPI 和小程序)、银联电子代付、通联代付、京东代付以及 Ping++ 余额渠道(无需额外配置)。

2、为需要接收分润的用户配置相应渠道的结算账户,参考 用户结算账户

分润结算创建时需要指定结算使用渠道,同时指定分润结算的范围,支持按时间维度,接收分润方维度和订单维度筛选分润对象。

royalty_settlement

  1. 对于商户或子商户而言,需要按照双方的约定时间,调用 Server-SDK 的创建分润结算 API 发起请求;
  2. Ping++ 接受请求后对满足条件的分润对象汇总生成新的分润结算对象,并返回给服务端。注:汇总过的分润对象不能再次被汇总结算,此时分润对象的状态为结算汇总。
  3. 服务端接收分润结算对象后,可以自行决定是否同意结算,调用 Server-SDK 的确认分润结算 API 发起请求。如果撤销,分润结算对象变为结算已撤销状态,同时分润对象会回到入账状态。
  4. Ping++ 接受确认后,向渠道发送企业付款请求,并返回已发起状态的分润结算对象。
  5. 服务端接收分润结算对象后,Ping++ 将会按照实际分润结算的情况,推送对应的 royalty_settlement.succeeded 分润结算成功、royalty_settlement.failed 分润结算失败、 royalty_settlement.partially_succeeded 分润结算部分成功、royalty_settlement.canceled 分润结算全部撤销的 Webhooks 事件回调,你的服务端需要监听并接受 Webhooks 回调;
  6. 请务必加上分润结算结果的主动查询机制:如果在可接受时间范围内没有收到 Webhooks 通知,你也可以调用 Server-SDK 封装的查询方法,主动向 Ping++ 发起请求来获得订单状态,该查询结果可以作为交易结果。

注意事项:

  1. 汇总分润对象时,需要满足汇总后对分润接收方的分润金额大于等于 0 时才可发起结算
  2. 如果只是想查看分润结算信息,不想真实生成分润结算对象,可以使用结算预览参数进行预览
  3. 如果分润结算失败,对应的分润对象会回到入账状态,可以重新发起分润结算
  4. 此接口需要使用创建 Order 时收款方(receipt_app)的APIKey和私钥请求 API 接口