Fundamentos — Começando
Fundamentos
Começando
Da criação da conta ao primeiro charge aprovado, em quatro passos. Ao final desta página você sabe exatamente o que configurar e em que ordem.
Passo 1 — Crie sua conta
- Abra sua conta na plataforma e conclua o registro de entidade e de usuário.
- Confirme o e-mail e defina o fator de autenticação.
- Complete o onboarding: contatos, documentos, estrutura societária e compliance.
Passo 2 — Gere as credenciais de API
Na área de credenciais, emita suas chaves de integração e vincule os provedores que quer usar. Cada provedor habilitado vira um transmitter disponível para a orquestração do seu fluxo.
# Exemplo: autorização na API
curl -X POST $BASE/api/v1/auth/token \
-H "Content-Type: application/json" \
-d '{"access_token": "<SEU_TOKEN>"}'Passo 3 — Crie a carteira e faça o primeiro charge
- Crie sua primeira carteira (wallet) dentro da conta.
- Escolha o meio de pagamento e monte o payload da cobrança.
- Dispare o charge e leia o retorno na API (status, ID e instruções de pagamento).
POST /api/v1/bank/wallet/charge/
{
"wallet_uuid": "00000000-0000-0000-0000-000000000000",
"type": "pix",
"amount_in_cents": 10000,
"merchant": { "name": "Loja Exemplo LTDA" }
}Passo 4 — Receba e confirme via webhook
- Configure a URL de webhook na conta.
- Acompanhe os eventos recebidos: charge criado, pago, estornado.
- Consulte o status em detalhe pela API e reconcilie no seu lado.