跳转到内容
PGSwift Docs
文档/从 V1 迁移

从 V1 迁移

如何将 V1 Webhook 集成迁移到当前的 Webhook 事件。

V1 和 V2 可并行运行,无需立即迁移。如需迁移,请注意以下变化:

变更项 V1 V2
付款事件名称 payment.completed payment.v2.completed
出款事件名称 disbursement.completed disbursement.v2.completed、disbursement.v2.fail、disbursement.v2.expired
付款负载结构 字段直接位于根层级(扁平结构) 字段嵌套在 data 中,外层增加 event 和 timestamp
出款负载结构 { event, data } 信封 { event, timestamp, data } 信封(新增 timestamp)
结算事件 不支持 transaction_settlement.settled(V2 专属)

V2 保留了 V1 的所有字段,名称和类型均不变(amount 在两个版本中均为字符串)。差异如下:

V1 事件 V2 事件 V2 新增字段
payment.completed payment.v2.completed payment_channel、payment_at、service_fee_rate_str、service_fee_amount_str、nett_amount_str
disbursement.completed disbursement.v2.completed(成功)、disbursement.v2.fail(失败)、disbursement.v2.expired(过期) valid_account_name、reason、payment_at

V2 以后可能会新增字段;各 V2 事件页面列出其当前字段。