Royalties 分润

royalty 对象在订单付款完成或退款完成后由 Ping++ 自动生成,根据订单中的分润信息或分润模板生成的清分数据。royalty 对象会在分润发起方和分润接收方关联的 app 下同时生成。royalty 对象中,分润发起方的 amount 为负值,分润接收方的 amount 为正值。

注:此接口需要使用创建 Order 时收款方(receipt_app)的APIKey和私钥请求 API 接口

属性描述
id string分润对象 ID ,由 Ping++ 生成。
object string值为 "royalty"。
payer_app string分润发起方对应的 app 对象的 id
created timestamp创建时间,用 Unix 时间戳表示。
livemode boolean是否处于 live 模式。
status string分润状态。值为 created:入账、pending:结算发起、waiting:结算汇总、succeeded:结算成功。
amount integer分润金额,单位为分。数值带符号,其中负值表示支出、正值表示收入。
method string分润方式。目前支持渠道:wx_pub(微信 JSAPI)、wx_lite(微信小程序)、alipay(支付宝)、unionpay(银联)、allinpay(通联)和 jdpay(京东)、balance(余额),以及manual(手动标记)。
recipient_app string分润接收方的 app 对象的 id
royalty_transaction string关联的 royalty_transaction 对象的 id
royalty_settlement string关联的 royalty_settlement 对象的 id
time_settled string结算成功时间,用 Unix 时间戳表示。
settle_account string关联的 settle_account 对象的 id,表示该分润结算对应用户结算账户。
source_app string平台的 app 对象的 id
source_url string关联对象的请求地址,目前支持 order 对象,例如:"/v1/orders/{ORDER_ID}"。
source_no string关联对象的 order_no
source_user string分润接收方 user 对象的 id
description string附加说明,最多 255 个 Unicode 字符。
metadata optional详见 元数据

对象示例

{
    "object": "list",
    "url": "/v1/royalties",
    "has_more": false,
    "data": [
        {
            "id": "170301124238000111",
            "object": "royalty",
            "payer_app": "app_1Gqj58ynP0mHeX1q",
            "amount": -1,
            "created": 1488343358,
            "description": "Your description",
            "livemode": true,
            "metadata": {},
            "method": "manual",
            "recipient_app": null,
            "royalty_transaction": null,
            "royalty_settlement": null,
            "source_app": "app_1Gqj58ynP0mHeX1q",
            "source_no": "12345678",
            "source_url": "/v1/orders/2011609010000025991",
            "source_user": "user_001",
            "status": "succeeded",
            "settle_account": null,
            "time_settled": 1488465301
        },
        {...},
        {...}
    ]
}