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

  1. Abra sua conta na plataforma e conclua o registro de entidade e de usuário.
  2. Confirme o e-mail e defina o fator de autenticação.
  3. 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

  1. Crie sua primeira carteira (wallet) dentro da conta.
  2. Escolha o meio de pagamento e monte o payload da cobrança.
  3. 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

  1. Configure a URL de webhook na conta.
  2. Acompanhe os eventos recebidos: charge criado, pago, estornado.
  3. Consulte o status em detalhe pela API e reconcilie no seu lado.