Introdução
Quick Reference
Por que a A55
A maioria das integrações de pagamento na América Latina exige costurar separadamente adquirentes, provedores antifraude e serviços 3DS — um por país, um por método de pagamento. A A55 substitui essa colcha de retalhos por uma única API.
| Sem a A55 | Com a A55 |
|---|---|
| Contratos separados com adquirentes em cada país | Uma API, 29 adquirentes, 7 países |
| Construir e manter integrações de PIX, Boleto, OXXO e SPEI por conta própria | Endpoint unificado — type_charge seleciona o método |
| Implementar 3DS, antifraude e lógica de retry por conta própria | 3DS integrado, device fingerprinting e roteamento inteligente |
| Semanas para lançar um novo método de pagamento ou país | Adicione um país ou método com uma única alteração de campo |
| Múltiplos dashboards para conciliação | Um pipeline de liquidação com relatórios multi-moeda (USD, EUR, local) |
O resultado:
- Menor tempo de lançamento — vá do sandbox à produção em dias, não meses.
- Maiores taxas de aprovação — roteamento inteligente e retentativas automáticas entre provedores.
- Menor custo total — uma integração substitui dezenas de contratos com fornecedores.
- Cobertura LATAM — Brasil, México, Argentina, Chile, Colômbia, Peru e expandindo.
A hierarquia parceiro → conta → merchant → carteira suporta ambientes multi-tenant. Você pode cadastrar sub-merchants e isolar fundos em qualquer nível.
O que você pode fazer
| Funcionalidade | Descrição | Saiba mais |
|---|---|---|
| Pagamentos com cartão | Crédito e débito com 3DS, tokenização e parcelamento | Cartão de crédito |
| PIX | Pagamento instantâneo, geração de QR code, confirmação em tempo real | PIX |
| Carteiras digitais | Apple Pay, Google Pay, e-wallets | Apple/Google Pay |
| Assinaturas | Cobrança recorrente com retentativas automáticas | Assinaturas |
| Multi-moeda | Cotações de câmbio em 8 moedas, 56 pares | Taxas de câmbio |
| Webhooks | Notificações de status em tempo real com assinaturas HMAC | Webhooks |
| Links de pagamento | Checkout sem código via URL — compartilhe por WhatsApp, e-mail ou SMS | Links de pagamento |
| Tokenização de cartão | Pagamentos seguros com tokens armazenados em vault | Tokenização |
Arquitetura
Parceiros cadastram contas (entidades). Cada conta contém um ou mais merchants; cada merchant possui carteiras; carteiras financiam cobranças e podem hospedar assinaturas.
Pipeline de pagamento
Todo pagamento — independentemente do método — segue o mesmo ciclo de vida:
Credenciais necessárias
Solicite esses valores com nosso time antes de chamar a API:
| Credencial | Descrição | Onde é usada |
|---|---|---|
client_id | ID da aplicação OAuth 2.0 (público) | Requisições de token ao Cognito |
client_secret | Segredo OAuth 2.0 (privado) | Requisições de token — somente server-side |
entity_uuid | Identificador único da conta (entidade) | Criação de carteira e operações no escopo da conta |
merchant_uuid | Identificador do merchant vinculado à conta | Cobranças e transações |
wallet_uuid | Identificador da carteira | Saldos, cobranças e operações no escopo da carteira |
Armazene o client_secret apenas no seu backend — em um gerenciador de segredos ou variáveis de ambiente. Nunca o coloque em código front-end, aplicativos mobile, repositórios públicos ou logs do lado do cliente.
Teste suas credenciais
Autentique-se e liste suas carteiras para confirmar que tudo funciona.
- cURL
- Python
- JavaScript
# 1. Obter um access token
TOKEN=$(curl -s -X POST \
https://smart-capital.auth.us-east-1.amazoncognito.com/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" | jq -r '.access_token')
# 2. Listar carteiras
curl -s -X GET \
https://core-manager.a55.tech/api/v1/wallets \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" | jq .
import requests
AUTH_URL = "https://smart-capital.auth.us-east-1.amazoncognito.com/oauth2/token"
API_BASE = "https://core-manager.a55.tech/api/v1"
# Autenticar
token = requests.post(AUTH_URL, data={
"grant_type": "client_credentials",
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET",
}, headers={"Content-Type": "application/x-www-form-urlencoded"}).json()["access_token"]
# Listar carteiras
wallets = requests.get(f"{API_BASE}/wallets", headers={
"Authorization": f"Bearer {token}",
"Content-Type": "application/json",
}).json()
print(wallets)
const AUTH_URL = "https://smart-capital.auth.us-east-1.amazoncognito.com/oauth2/token";
const API_BASE = "https://core-manager.a55.tech/api/v1";
// Autenticar
const tokenResp = await fetch(AUTH_URL, {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
grant_type: "client_credentials",
client_id: "YOUR_CLIENT_ID",
client_secret: "YOUR_CLIENT_SECRET",
}),
});
const { access_token } = await tokenResp.json();
// Listar carteiras
const wallets = await fetch(`${API_BASE}/wallets`, {
headers: {
Authorization: `Bearer ${access_token}`,
"Content-Type": "application/json",
},
}).then(r => r.json());
console.log(wallets);
Use seu client_id / client_secret de sandbox para executar isso agora mesmo — nenhum dinheiro real é movimentado. Veja Ambiente para mais detalhes.
Solicite acesso
Envie um e-mail para tech.services@a55.tech com o nome da sua empresa, contato técnico e caso de uso. Nosso time irá provisionar credenciais de sandbox e guiar você pelo processo de onboarding.