提现/付款退票结果通知
场景
用于向业务方主动推送通知提现/付款结果。若一笔提现/付款交易拆分多笔支付单,则会通知多次,可通过交易完成标识(complete_flag)判断是否为终态。
提示
- 退票是交易单先成功后失败的场景(渠道受理后并成功通过交易网络发出后被收款行拒绝的情况),是针对支付单产生的单据,故退票标识会在支付单据上打标,退票详情请参考账户(加款)流水。
- 退票金额小于等于支付单对应目标金额(渠道在退票情况可能会收取手续费),实际退票金额为退回账户金额,实际退票金额=退票金额-退票手续费金额
EVENT
OPEN_PAYOUT_ORDER_RETURN
需要验证签名通知消息体
| Parameter | Type | Required | Description |
|---|---|---|---|
| order_id | string(64) | M | PingPong唯一单号 |
| client_id | string(64) | M | 客户号 |
| partner_order_id | string(64) | M | 交易请求单号 |
| distribute_id | string(64) | M | 支付单ID |
| refund_id | string(64) | M | 退票单ID【退票唯一标识】 |
| refund_amount | decimal(18,2) | M | 退票金额【银行退回金额】 |
| refund_actual_amount | decimal(18,2) | M | 实际退票金额【退回账户金额,扣除退票手续费后】 |
| refund_currency | string(8) | M | 退票币种 |
| refund_fee_amount | decimal(18,2) | M | 退票手续费金额 |
| refund_fee_currency | string(8) | M | 退票手续费币种【同退回账户币种】 |
| refund_time | long | M | 退票时间,精确到毫秒 |
| reason | string(128) | M | 退票说明 |
| refund_account_info | object | M | 退回账户信息 |
refund_account_info
| Parameter | Type | Required | Description |
|---|---|---|---|
| account_id | string(64) | M | 退回账户ID |
| account_type | string(32) | M | 退回账户类型 |
| currency | string(3) | M | 退回账户币种 |
| receipt_amount | decimal(18,2) | M | 账户收款金额 |
| receipt_fee_amount | decimal(18,2) | M | 账户收款手续费 |
| receipt_actual_amount | decimal(18,2) | M | 账户实收金额 |