Skip to main content
Neste guia você vai autenticar e criar uma cobrança PIX recebendo o código copia e cola.
1

Tenha suas credenciais

Pegue sua API Key e API Secret no painel da Avantti Finance. Guarde-as como variáveis de ambiente:
export AVANTTI_API_KEY="sua_api_key"
export AVANTTI_API_SECRET="seu_api_secret"
2

Gere o token de acesso

curl -X POST 'https://api.avanttifinance.com/auth' \
  -u "$AVANTTI_API_KEY:$AVANTTI_API_SECRET"
Guarde o token retornado.
3

Crie uma cobrança PIX

curl -X POST 'https://api.avanttifinance.com/v1/pix/in/qrcode' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -d '{
    "amountInCents": 8000,
    "postbackUrl": "https://seu-sistema.com/webhooks/avantti",
    "description": "Primeira cobrança",
    "customer": {
      "name": "João da Silva",
      "email": "joao@email.com",
      "documentType": "cpf",
      "document": "12345678909",
      "phone": "(11) 99999-9999"
    }
  }'
4

Use o QR Code / copia e cola

A resposta traz data.pix.emv (copia e cola) e data.pix.qrCode. Exiba para o cliente pagar.
{
  "success": true,
  "message": "Transação criada com sucesso",
  "data": {
    "id": "clxyz123abc",
    "pix": { "emv": "00020126...", "qrCode": "data:image/png;base64,..." },
    "status": "pending",
    "fees": 200
  }
}
5

Receba a confirmação

Quando o cliente pagar, a Avantti envia uma notificação para a sua postbackUrl. Veja Webhooks.
Quer integrar ainda mais rápido? Use nosso servidor MCP e o prompt de integração para conectar tudo com um único comando no seu assistente de IA.