Integração SDK (V1)

Quick Reference

WhatA55Pay.pay() legado

WhyParidade para lojistas no V1 enquanto planejam migração para V2

DifficultyIntermediate

PrerequisitesSDK V2 → Autenticação

Legado

O SDK V1 é legado. Usa A55Pay.pay(config) e caminhos 3DS legados. Novas integrações devem usar o SDK V2.

O SDK V1 está documentado para lojistas existentes manterem o comportamento enquanto planejam a migração. Comportamento e códigos de erro podem diferir do V2.

---

Método principal: A55Pay.pay(config)

A55Pay.pay

A55Pay.pay({
  chargeUuid: '00000000-0000-4000-8000-000000000001',
  holder: 'Jane Doe',
  number: '4111111111111111',
  month: '12',
  year: '2030',
  cvc: '123',
  onSuccess: (payload) => {},
  onFailed: (err) => {},
});

---

Nomes de campos: V1 vs V2

V1	V2 (userData)
holder	name
number	card_number
month / year	card_expiry_month / card_expiry_year
cvc	card_cvv

---

Caminho de migração

1. Mapeie campos V1 para equivalentes V2 em uma pequena camada adapter.
2. Troque o ponto de entrada de pay() para payV2().
3. Atualize o tratamento de 3DS (fluxos legados do provedor vs 3DS hospedado pela A55 no V2).
4. Teste no sandbox: valide webhooks e callbacks ponta a ponta.
5. Monitore em produção; faça cutover A/B se o tráfego permitir.

Adapter primeiro

Mapeie os campos uma vez em um módulo adapter, mude para payV2 e valide 3DS e webhooks antes de remover caminhos V1.

---

Observações

Comportamento

Payloads de erro, casos extremos e redirecionamentos 3DS podem não coincidir com o SDK V2. Caminhos 3DS legados não são idênticos ao 3DS hospedado pela A55 atual em confirmacion.a55.tech.

SDK V2 →payV2, open e 3DS atual.Página de checkout →Checkout hospedado sem SDK embutido.Visão geral de integração →Compare H2H, SDK e Checkout.