Link de pagamento
Quick Reference
WhatURLs de pagamento geradas pela API
WhyDistribuição omnicanal sem embutir código de checkout
DifficultyBeginner
PrerequisitesAutenticação → Carteira
Um payment link cria uma URL compartilhável que abre o checkout da A55 — ideal para faturas, vendas assistidas por suporte e lojas leves sem SDK embutido.
Por que payment links
| Benefício | Detalhe |
|---|---|
| Código mínimo | Gere links pela API ou pelo painel |
| Omnicanal | WhatsApp, e-mail, SMS, redes |
| Checkout hospedado | Mesmos métodos do checkout padrão |
| Uso único ou reutilizável | is_checkout controla o comportamento |
Criar um link
POST https://core-manager.a55.tech/api/v1/bank/wallet/payment-link/
Authorization: Bearer $ACCESS_TOKEN
A resposta retorna uma url apontando para https://pay.a55.tech/checkout/{uuid} (o caminho exato segue a resposta da API).
Distribuição
- E-mail — incorpore em faturas e lembretes.
- WhatsApp / SMS — cole o link HTTPS.
- Redes — publique o link em campanhas.
- QR code — codifique a URL para loja física ou impressão.
Flag is_checkout
| Valor | Comportamento |
|---|---|
true | Uso único, fluxo estilo checkout |
false | Reutilizável até revogar |
Detalhes operacionais
Confirme expiração, máximo de resgates e regras de idempotência com seu gerente de integração — podem variar conforme a configuração do produto.
Exemplos
- cURL
- Corpo JSON
curl -sS -X POST 'https://core-manager.a55.tech/api/v1/bank/wallet/payment-link/' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"wallet_uuid": "00000000-0000-4000-8000-000000000001",
"amount": 10000,
"currency": "BRL",
"is_checkout": true
}'
{
"wallet_uuid": "00000000-0000-4000-8000-000000000001",
"amount": 10000,
"currency": "BRL",
"is_checkout": true
}
Embutir com SDK
A55Pay.open({ checkoutUuid: '<uuid-from-payment-link>' });
Compartilhe com segurança
Use apenas HTTPS. Não cole segredos ou tokens de pré-autenticação em canais públicos.