API 更新日志

A55 API 的所有重要变更均记录在此。破坏性变更以 ⚠️ 前缀标记。

---

2026-03-01——v1.12.0

新功能

• 新增 GET /api/v1/bank/wallet/bin/{card_bin}/——BIN 查询端点，返回卡品牌、类型、类别、发卡行和国家。
• 新增 POST /api/v1/bank/wallet/fx/rate/——实时汇率报价，支持 56 个货币对（USD、BRL、EUR、MXN、ARS、COP、CLP、PEN）。
• 新增 POST /api/v1/bank/wallet/checkout/——托管结账会话创建（payment-link 的别名，使用 is_checkout=true）。

改进

• PIX 收费响应现在除了现有的支付 URL 外，还包含 pix_payload.qr_code_base64。
• Apple Pay 会话端点返回 expiresAt 字段用于会话生命周期管理。

---

2026-01-15——v1.11.0

新功能

• 新增 POST /api/v1/bank/wallet/charge/pix/——专用 PIX 收费端点，支持直接生成二维码。
• 新增 POST /api/v1/bank/wallet/transfer/pix/——PIX 付款/转账至 PIX 密钥和银行账户。

改进

• 订阅 cycle 现在除现有周期外，还支持 biweekly（双周）和 semiannually（半年）。
• Idempotency-Key 请求头支持扩展至所有 POST 端点。

---

2025-11-01——v1.10.0

新功能

• 新增 POST /api/v1/bank/wallet/tokenization/——无需收费的卡片令牌化。
• 新增 GET /api/v1/bank/public/charge/{uuid}/simulate-installment——公共分期模拟。

改进

• Webhook 载荷现在在原始收费设置了 reference_external_id 时包含该字段。
• 所有端点的错误响应统一为 { code, source, description } 格式。

---

2025-09-01——v1.9.0

新功能

• 新增 POST /api/v1/bank/public/setup-authentication——3DS 设备数据采集配置。
• 新增 POST /api/v1/bank/public/charge/authentication/{uuid}/validate——3DS 挑战验证。
• 新增 POST /api/v1/bank/public/charge/applepay/{uuid}/session——Apple Pay 商户会话。

改进

• 3DS 认证现在支持 EMV 3DS 2.2 的无摩擦流程。
• 收费响应包含 url_3ds 字段用于 H2H 3DS 重定向。

---

2025-07-01——v1.8.0

新功能

• 新增 POST /api/v1/bank/wallet/charge/{charge_uuid}/cancel/{wallet_uuid}/——取消待处理或预授权收费。
• 通过 type_charge: "googlepay" 新增 Google Pay 支持。

改进

• 退款端点现在接受可选的 reason 字段用于对账。
• 请求频率限制提升至每个钱包每分钟 100 次请求。

⚠️ 破坏性变更

• 错误响应的 message 字段从 string 更改为 { code, source, description } 对象的 array。

---

2025-05-01——v1.7.0

新功能

• 新增 POST /api/v1/bank/public/charge/{uuid}/pay——用于 A55Pay payV2() 的 SDK 支付端点。
• 新增 QR Argentina (qra) 和 Pago Facil (pfc) 支付方式。

改进

• 收费列表支持 reference_external_id 筛选。
• Webhook 重试策略扩展为 5 次尝试，使用指数退避。

---

2025-03-01——v1.6.0

新功能

• 通过创建收费中的 subscription 对象支持订阅。
• 新增 GET /api/v1/bank/wallet/charge/{uuid}/——查询单笔收费详情。
• 新增 GET /api/v1/bank/wallet/charges/——分页列出收费。

改进

• 新增巴西和墨西哥的 Apple Pay 支持。
• 钱包创建返回 allowed_methods 配置。

---

2025-01-01——v1.5.0（首次公开发布）

核心端点

• POST /api/v1/bank/wallet/——创建 wallet（钱包）
• GET /api/v1/bank/wallet/{uuid}/——查询 wallet
• POST /api/v1/bank/wallet/charge/——创建收费（信用卡、借记卡、PIX、Boleto、SPEI、OXXO）
• POST /api/v1/bank/wallet/charge/{charge_uuid}/capture/{wallet_uuid}/——捕获收费
• POST /api/v1/bank/wallet/charge/{charge_uuid}/refund/{wallet_uuid}/——退款
• POST /api/v1/bank/wallet/payment-link/——支付链接
• POST /api/v1/bank/wallet/zero-auth/——零授权卡片验证

支持的地区：巴西、墨西哥、智利、阿根廷、哥伦比亚