Quick Start

Em três passos você cria uma cobrança e descobre quando ela foi paga.

Passo 1 — Pegue o token de API

No Portal (https://app.gaudpay.com.br), como dono da conta, abra Configurações e gere o token de API. Ele é mostrado uma única vez: guarde-o num cofre de segredos.

export GAUDPAY_TOKEN="cole_o_token_aqui"

Passo 2 — Crie um link de pagamento

O link de pagamento é o caminho mais simples: o cliente escolhe Pix, boleto ou cartão numa página hospedada pelo Gaud Pay.

curl -X POST https://api.gaudpay.com.br/payment-links \
  -H "Authorization: Bearer $GAUDPAY_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1001" \
  -d '{
    "amount_cents": 15990,
    "description": "Pedido 1001",
    "allowed_methods": ["PIX", "BOLETO", "CARD"],
    "max_installments": 3,
    "boleto_config": {
      "issue_date": "2026-10-10",
      "document_kind": "DM",
      "days_until_expiration": 3
    }
  }'

A resposta traz o public_token. Envie ao cliente o endereço:

https://app.gaudpay.com.br/pay/{public_token}

Passo 3 — Receba o aviso de pagamento

Cadastre o endereço de aviso (veja Webhooks) e responda 2xx quando o aviso chegar:

curl -X PUT https://api.gaudpay.com.br/webhook-endpoint \
  -H "Authorization: Bearer $GAUDPAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://seusistema.com.br/webhooks/gaudpay", "active": true }'

A resposta traz o segredo de assinatura (whsec_…), mostrado uma única vez. Use-o para validar cada aviso.

Dica de implementação: para testar de ponta a ponta, crie um link de R$ 1,00 ("amount_cents": 100) e pague com Pix.