Skip to main content

API Changelog

All notable changes to the A55 API are documented here. Breaking changes are marked with a ⚠️ prefix.

2026-03-01 — v1.12.0​

New features

  • Added GET /api/v1/bank/wallet/bin/{card_bin}/ — BIN lookup endpoint returns brand, type, category, issuer, and country.
  • Added POST /api/v1/bank/wallet/fx/rate/ — Real-time exchange rate quotes across 56 currency pairs (USD, BRL, EUR, MXN, ARS, COP, CLP, PEN).
  • Added POST /api/v1/bank/wallet/checkout/ — Hosted checkout session creation (alias for payment-link with is_checkout=true).

Improvements

  • PIX charge response now includes pix_payload.qr_code_base64 alongside the existing payment URL.
  • Apple Pay session endpoint returns expiresAt field for session lifecycle management.

2026-01-15 — v1.11.0​

New features

  • Added POST /api/v1/bank/wallet/charge/pix/ — Dedicated PIX charge endpoint with direct QR code generation.
  • Added POST /api/v1/bank/wallet/transfer/pix/ — PIX payout/transfer to PIX keys and bank accounts.

Improvements

  • Subscription cycle now supports biweekly and semiannually in addition to existing cycles.
  • Idempotency-Key header support extended to all POST endpoints.

2025-11-01 — v1.10.0​

New features

  • Added POST /api/v1/bank/wallet/tokenization/ — Card tokenization without charging.
  • Added GET /api/v1/bank/public/charge/{uuid}/simulate-installment — Public installment simulation.

Improvements

  • Webhook payloads now include reference_external_id when set on the original charge.
  • Error responses standardized to { code, source, description } format across all endpoints.

2025-09-01 — v1.9.0​

New features

  • Added POST /api/v1/bank/public/setup-authentication — 3DS Device Data Collection setup.
  • Added POST /api/v1/bank/public/charge/authentication/{uuid}/validate — 3DS challenge validation.
  • Added POST /api/v1/bank/public/charge/applepay/{uuid}/session — Apple Pay merchant session.

Improvements

  • 3DS authentication now supports EMV 3DS 2.2 with frictionless flows.
  • Charge response includes url_3ds field for H2H 3DS redirect.

2025-07-01 — v1.8.0​

New features

  • Added POST /api/v1/bank/wallet/charge/{charge_uuid}/cancel/{wallet_uuid}/ — Cancel pending or pre-captured charges.
  • Added Google Pay support via type_charge: "googlepay".

Improvements

  • Refund endpoint now accepts optional reason field for reconciliation.
  • Rate limiting increased to 100 requests/minute per wallet.

⚠️ Breaking changes

  • Error response message field changed from string to array of { code, source, description } objects.

2025-05-01 — v1.7.0​

New features

  • Added POST /api/v1/bank/public/charge/{uuid}/pay — SDK pay endpoint for A55Pay payV2().
  • Added QR Argentina (qra) and Pago Facil (pfc) payment methods.

Improvements

  • Charge listing supports reference_external_id filter.
  • Webhook retry policy extended to 5 attempts with exponential backoff.

2025-03-01 — v1.6.0​

New features

  • Subscription support via subscription object in Create charge.
  • Added GET /api/v1/bank/wallet/charge/{uuid}/ — Get single charge details.
  • Added GET /api/v1/bank/wallet/charges/ — List charges with pagination.

Improvements

  • Apple Pay support added for Brazil and Mexico.
  • Wallet creation returns allowed_methods configuration.

2025-01-01 — v1.5.0 (Initial public release)​

Core endpoints

  • POST /api/v1/bank/wallet/ — Create wallet
  • GET /api/v1/bank/wallet/{uuid}/ — Get wallet
  • POST /api/v1/bank/wallet/charge/ — Create charge (credit card, debit card, PIX, Boleto, SPEI, OXXO)
  • POST /api/v1/bank/wallet/charge/{charge_uuid}/capture/{wallet_uuid}/ — Capture charge
  • POST /api/v1/bank/wallet/charge/{charge_uuid}/refund/{wallet_uuid}/ — Refund charge
  • POST /api/v1/bank/wallet/payment-link/ — Payment link
  • POST /api/v1/bank/wallet/zero-auth/ — Zero-auth card validation

Supported regions: Brazil, Mexico, Chile, Argentina, Colombia