SDK 集成（V1）
Quick Reference
What旧版 A55Pay.pay()
Why在规划迁移至 V2 期间与 V1 商户保持一致
Reading Time5 分钟
Difficulty中级
PrerequisitesSDK V2 → 身份验证
旧版
SDK V1 为旧版。 使用较旧的 A55Pay.pay(config) 与旧版 3DS 路径。新集成应使用 SDK V2。
本文档面向现有商户在规划迁移期间维持行为。行为与错误码可能与 V2 不同。
主要方法：A55Pay.pay(config)
- A55Pay.pay
A55Pay.pay({
chargeUuid: '00000000-0000-4000-8000-000000000001',
holder: '张伟',
number: '4111111111111111',
month: '12',
year: '2030',
cvc: '123',
onSuccess: (payload) => {},
onFailed: (err) => {},
});
字段名：V1 与 V2
| V1 | V2（userData） |
|---|---|
holder | name |
number | card_number |
month / year | card_expiry_month / card_expiry_year |
cvc | card_cvv |
迁移路径
- 在小型适配器层将 V1 字段映射为 V2 等价项。
- 将入口从
pay()切换为payV2()。 - 更新 3DS 处理（旧版供应商流程 vs V2 中的 A55 托管 3DS）。
- 在 sandbox（沙箱环境） 中测试：端到端验证 webhook 与回调。
- 生产监控；若流量允许可执行 A/B 切换。
先做适配器
在适配器模块中一次性映射字段，切换到 payV2，再在删除 V1 代码路径前验证 3DS 与 webhook。
说明
- 行为
错误载荷、边界情况与 3DS 重定向可能与 SDK V2 不一致。旧版 3DS 路径与 confirmacion.a55.tech 上当前的 A55 托管 3DS并不相同。