Pular para o conteúdo principal

Changelog da API

Todas as alterações relevantes na API A55 são documentadas aqui. Breaking changes são marcadas com o prefixo ⚠️.

2026-03-01 — v1.12.0​

Novos recursos

  • Adicionado GET /api/v1/bank/wallet/bin/{card_bin}/ — Endpoint de consulta de BIN retorna bandeira, tipo, categoria, emissor e país.
  • Adicionado POST /api/v1/bank/wallet/fx/rate/ — Cotações de câmbio em tempo real para 56 pares de moedas (USD, BRL, EUR, MXN, ARS, COP, CLP, PEN).
  • Adicionado POST /api/v1/bank/wallet/checkout/ — Criação de sessão de checkout hospedado (alias para payment-link com is_checkout=true).

Melhorias

  • A resposta de cobrança PIX agora inclui pix_payload.qr_code_base64 além da URL de pagamento existente.
  • O endpoint de sessão Apple Pay retorna o campo expiresAt para gerenciamento do ciclo de vida da sessão.

2026-01-15 — v1.11.0​

Novos recursos

  • Adicionado POST /api/v1/bank/wallet/charge/pix/ — Endpoint dedicado para cobrança PIX com geração direta de QR code.
  • Adicionado POST /api/v1/bank/wallet/transfer/pix/ — Payout/transferência PIX para chaves PIX e contas bancárias.

Melhorias

  • O campo cycle de assinatura agora suporta biweekly e semiannually além dos ciclos existentes.
  • Suporte ao header Idempotency-Key estendido para todos os endpoints POST.

2025-11-01 — v1.10.0​

Novos recursos

  • Adicionado POST /api/v1/bank/wallet/tokenization/ — Tokenização de cartão sem cobrança.
  • Adicionado GET /api/v1/bank/public/charge/{uuid}/simulate-installment — Simulação pública de parcelamento.

Melhorias

  • Os payloads de webhook agora incluem reference_external_id quando definido na cobrança original.
  • Respostas de erro padronizadas no formato { code, source, description } em todos os endpoints.

2025-09-01 — v1.9.0​

Novos recursos

  • Adicionado POST /api/v1/bank/public/setup-authentication — Configuração de coleta de dados do dispositivo para 3DS.
  • Adicionado POST /api/v1/bank/public/charge/authentication/{uuid}/validate — Validação do desafio 3DS.
  • Adicionado POST /api/v1/bank/public/charge/applepay/{uuid}/session — Sessão de merchant Apple Pay.

Melhorias

  • A autenticação 3DS agora suporta EMV 3DS 2.2 com fluxos frictionless.
  • A resposta da cobrança inclui o campo url_3ds para redirecionamento 3DS H2H.

2025-07-01 — v1.8.0​

Novos recursos

  • Adicionado POST /api/v1/bank/wallet/charge/{charge_uuid}/cancel/{wallet_uuid}/ — Cancelar cobranças pendentes ou pré-capturadas.
  • Adicionado suporte a Google Pay via type_charge: "googlepay".

Melhorias

  • O endpoint de reembolso agora aceita o campo opcional reason para reconciliação.
  • Limite de requisições aumentado para 100 requisições/minuto por wallet.

⚠️ Breaking changes

  • O campo message da resposta de erro foi alterado de string para array de objetos { code, source, description }.

2025-05-01 — v1.7.0​

Novos recursos

  • Adicionado POST /api/v1/bank/public/charge/{uuid}/pay — Endpoint SDK para payV2() do A55Pay.
  • Adicionados métodos de pagamento QR Argentina (qra) e Pago Facil (pfc).

Melhorias

  • A listagem de cobranças suporta filtro por reference_external_id.
  • Política de retry de webhook estendida para 5 tentativas com backoff exponencial.

2025-03-01 — v1.6.0​

Novos recursos

  • Suporte a assinatura via objeto subscription em Criar cobrança.
  • Adicionado GET /api/v1/bank/wallet/charge/{uuid}/ — Consultar detalhes de uma cobrança.
  • Adicionado GET /api/v1/bank/wallet/charges/ — Listar cobranças com paginação.

Melhorias

  • Suporte a Apple Pay adicionado para Brasil e México.
  • A criação de wallet retorna a configuração allowed_methods.

2025-01-01 — v1.5.0 (Lançamento público inicial)​

Endpoints principais

  • POST /api/v1/bank/wallet/ — Criar wallet
  • GET /api/v1/bank/wallet/{uuid}/ — Consultar wallet
  • POST /api/v1/bank/wallet/charge/ — Criar cobrança (cartão de crédito, cartão de débito, PIX, Boleto, SPEI, OXXO)
  • POST /api/v1/bank/wallet/charge/{charge_uuid}/capture/{wallet_uuid}/ — Capturar cobrança
  • POST /api/v1/bank/wallet/charge/{charge_uuid}/refund/{wallet_uuid}/ — Reembolsar cobrança
  • POST /api/v1/bank/wallet/payment-link/ — Link de pagamento
  • POST /api/v1/bank/wallet/zero-auth/ — Validação de cartão zero-auth

Regiões suportadas: Brasil, México, Chile, Argentina, Colômbia