Jornada de Onboarding do Parceiro
Quick Reference
Fases do Onboarding
Contato Inicial
Entre em contato com tech.services@a55.tech informando:
- Nome e site da empresa
- Volume mensal de transações esperado
- Países-alvo e métodos de pagamento
- Preferência de método de integração (H2H, SDK ou Checkout Page)
A A55 designa um engenheiro de integração dedicado à sua conta em até 2 dias úteis.
Qualificação Comercial
Envie a documentação de KYC/KYB:
| Documento | Obrigatório Para |
|---|---|
| Contrato social | Todos os parceiros |
| Registro CNPJ (Brasil) | Entidades brasileiras |
| Declaração de beneficiários finais | Todos os parceiros |
| Histórico de processamento (6 meses) | Precificação baseada em volume |
Assinatura do Contrato
Após a qualificação, a A55 prepara um acordo comercial cobrindo:
- Taxas de processamento por método de pagamento e país
- Cronograma de liquidação e moeda
- Compromissos de SLA (uptime, tempo de resposta do suporte)
- Termos de responsabilidade por chargeback
Reunião Técnica de Onboarding
Uma reunião de 60 minutos com seu engenheiro de integração cobrindo:
- Arquitetura da API e fluxo de autenticação
- Método de integração recomendado para o seu caso de uso
- Configuração de webhooks e catálogo de eventos
- Demonstração do ambiente sandbox
- Planejamento de cronograma e marcos
Credenciais Sandbox Provisionadas
Você recebe:
| Credencial | Finalidade |
|---|---|
client_id / client_secret | Autenticação OAuth2 |
entity_uuid | Identificador da sua entidade |
merchant_uuid | Configuração do comerciante |
| URL Cognito do sandbox | Endpoint de token |
| URL base da API sandbox | https://sandbox.api.a55.tech |
Desenvolvimento da Integração
Construa sua integração usando um dos três métodos:
| Método | Ideal Para | Tratamento de Dados do Cartão |
|---|---|---|
| Host-to-Host (H2H) | Controle total, servidor-a-servidor | Você coleta, a A55 criptografa e armazena em cofre |
| SDK (Drop-in UI) | Aplicações web/mobile | O SDK da A55 captura com segurança no navegador |
| Checkout Page | Página de pagamento hospedada | A A55 gerencia tudo |
Consulte a Visão Geral da Integração para escolher o método adequado.
Testes de Integração
Execute sua integração contra o sandbox usando cartões de teste:
- Processe cobranças para cada método de pagamento que você suporta
- Teste todos os cenários de recusa e caminhos de tratamento de erro
- Verifique a entrega de webhooks e validação de assinatura
- Teste fluxos de reembolso e cancelamento
- Valide o tratamento de redirecionamento 3DS (se aplicável)
Revisão de Go-Live
A A55 realiza uma revisão de prontidão para produção:
- Todos os cenários de teste aprovados
- Tratamento de erro cobre todos os códigos de resposta da API
- Verificação de assinatura de webhook implementada
- Lógica de retry com backoff exponencial implementada
- Checklist de segurança concluído (veja Checklist de Go-Live)
Credenciais de Produção + Monitoramento
Após a aprovação:
client_id/client_secretde produção emitidos- URL Cognito de produção e URL base da API fornecidos
- Dashboards de monitoramento configurados
- Data de go-live confirmada e primeira cobrança em produção testada
Após o lançamento, seu engenheiro de integração permanece disponível por 30 dias de suporte hypercare.
Independentemente do método de integração escolhido, a A55 cuida da proteção dos dados do cartão:
- Host-to-Host (H2H): Você coleta os dados do cartão e os envia para a A55 via TLS. A A55 criptografa, tokeniza e armazena em cofre — seus servidores nunca precisam armazenar números de cartão.
- SDK: Os dados do cartão vão do navegador do comprador diretamente para a A55. Seus servidores nunca os veem.
- Checkout Page: Os dados do cartão são coletados inteiramente na página hospedada da A55 em
pay.a55.tech. Você nunca toca nos dados do cartão.
Todos os três métodos se beneficiam da criptografia de nível enterprise, tokenização e infraestrutura de cofre seguro da A55.
Cronograma
| Fase | Duração Típica |
|---|---|
| Contato inicial → Credenciais sandbox | 3–5 dias úteis |
| Desenvolvimento da integração | 1–4 semanas (varia) |
| Testes e revisão de go-live | 2–5 dias úteis |
| Total | 2–6 semanas |