你可以请求一个新的 balance_bonus 对象向用户发起一次余额赠送。赠送成功后,用户的可用余额会增加,赠送的余额不能提现、转账,只能用于消费。
| 属性 | 描述 |
|---|---|
| id string | 余额赠送对象 ID,由 Ping++ 生成。 |
| object string | 值为 "balance_bonus"。 |
| app string | 对应 app 对象的 id,查看 如何获取App ID。 |
| created int | 创建时间,用 Unix 时间戳表示。 |
| livemode timestamp | 是否是 live 模式。 |
| paid boolean | 是否已赠送。 |
| refunded boolean | 是否存在退款信息,无论退款是否成功。 |
| order_no string | 商户订单号,必须在商户的系统内唯一。 |
| amount int | 赠送金额,单位为分。 |
| amount_refunded int | 已退款的赠送金额,单位为分。 |
| time_paid int | 支付成功时间,用 Unix 时间戳表示。 |
| user string | 受赠的 user 对象的 id。 |
| balance_transaction string | 关联的 balance_transaction 对象的 id。 |
| description string | 附加说明,最多 60 个 Unicode 字符。 |
| metadata hash | 详见 元数据。 |