Withdrawals 提现

用户发起提现申请时,你可以请求一个 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(微信公众号)、wx_lite(微信小程序)、alipay(支付宝)、 unionpay(银联)、allinpay(通联)和 jdpay(京东)。此外,还支持使用自定义渠道 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
}