跳到主要内容

入金召回单通知

场景

用于向订阅通知的业务方通知来账资金被付款方或银行主动召回的结果。当来账资金被召回时,PingPong会立即从客户对应币种的账户余额中扣除。 如果客户余额不足,PingPong将会冻结客户的出金行为,待客户余额充足时扣除。

提示
  1. 一笔reversal召回单会根据账户余额是否满足立即扣除的情况通知一到多次。
  2. 当reversal产生且客户对应币种账户余额充足时会自动扣除,此时只通知一次,且带有扣除余额详细信息。
  3. 当reversal产生且客户对应币种账户余额不足时,此时会通知两次。第一次代表此时发生了召回且已经冻结客户出金行为,第二次代表已经扣除成功且解除了客户出金行为。

EVENT

OPEN_INBOUND_REVERSAL_RESULT

需要验证签名

事件内容

ParameterTypeRequiredDescription
client_idstring(64)M注册PingPong返回的客户ID
order_nostring(64)M召回单单号,幂等唯一
transaction_idstring(64)M召回单关联的原始来账流水单号
account_nostring(64)M收款卡号
amountdecimal(18,2)M召回金额
currencystring(16)M召回币种
value_datestring(64)M银行召回时间YYYY-MM-dd
statusstring(64)M状态 PROCESSING、SUCCESS
finish_timelongCPingPong召回单处理完成时间,status等于SUCCESS时必须,精确到毫秒
deduct_detailsarrayC扣除余额详情, status等于SUCCESS时必须

deduct_details

ParameterTypeRequiredDescription
account_typestring(32)M扣款账户类型,可用账户:AVAIL_ACCOUNT 资金暂存户:TEMP_ACCOUNT
amountdecimal(18,2)M扣款金额
currencystring(16)M扣款币种