用户发起提现申请时,你可以请求一个 withdrawal 对象,之后你可以对该笔提现进行审核,发起提现确认或提现取消。注:微信服务商模式商户暂不支持提现。
| 参数 | 描述 |
|---|---|
| id string | 提现对象 ID,由 Ping++ 生成。 |
| object string | 值为 "withdrawal"。 |
| app string | 对应 app 对象的 id,查看 如何获取App ID。 |
| amount int | 提现扣除的余额,单位为分。 |
| asset_transaction string | 关联的 asset_transaction 对象的 id。 |
| balance_transaction string | 关联的 balance_transaction 对象的 id。 |
| channel string | 提现使用的付款渠道:wx(微信 App)、wx_pub(微信 JSAPI)、wx_lite(微信小程序)、alipay(支付宝)、 unionpay(银联)、allinpay(通联)。此外,还支持使用自定义渠道 custom,该渠道不需要真实付款,并在确认提现时同步返回成功结果。 |
| created timestamp | 创建时间,用 Unix 时间戳表示。 |
| description string | 附加说明,最多 60 个 Unicode 字符。 |
| extra hash | 附加参数,提现付款的相关信息。 |
| failure_msg string | 错误消息的描述。 |
| fee int | 手续费,可能是渠道/银行收取。 |
| livemode boolean | 是否处于 live 模式。 |
| operation_url string | 支付宝批量付款 URL。 |
| order_no string | 提现的商户订单号。 |
| source string | 关联的 transfer 对象的 id。 |
| status string | 提现状态,已申请:created,处理中:pending,完成:succeeded,失败:failed,取消:canceled。 |
| time_canceled timestamp | 提现取消时间,用 Unix 时间戳表示。 |
| time_succeeded timestamp | 提现成功时间,用 Unix 时间戳表示。 |
| user string | 提现关联 user 对象的 id。 |
| user_fee int | 需要用户承担的手续费,单位为分。 |
| settle_account string | 提现使用的 settle_account 对象的 id。 |
| metadata hash | 详见 元数据。 |
{
"id": "1701611150302360654",
"object": "withdrawal",
"app": "app_1Gqj58ynP0mHeX1q",
"amount": 20000,
"asset_transaction": "",
"balance_transaction": "",
"channel": "unionpay",
"created": 1472648887,
"description": "test232description",
"extra": {
"account": "6225210207073918",
"name": "姓名",
"open_bank_code": "0102",
"prov": "上海",
"city": "上海"
},
"fee": 200,
"livemode": true,
"metadata":{},
"order_no": "20160829133002",
"source": null,
"status": "created",
"time_canceled": null,
"time_succeeded": null,
"user": "user_001",
"user_fee": 50
}