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 事件页面列出其当前字段。