Skip to main content

​
Duas formas de configuração

  1. Global (recomendado): configure no painel da Pagou para receber todos os eventos da conta.
  2. Por transação: envie notify_url no POST /v2/transactions para sobrescrever o destino naquele pagamento.

​
Exemplo com notify_url

curl --request POST \
  --url https://api.pagou.ai/v2/transactions \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 1500,
    "currency": "BRL",
    "method": "credit_card",
    "token": "pgct_0123456789abcdef",
    "notify_url": "https://api.suaempresa.com/webhooks/pagou",
    "buyer": {
      "name": "Maria Silva",
      "email": "maria@empresa.com",
      "document": { "type": "CPF", "number": "12345678901" }
    },
    "products": [{ "name": "Pedido #1234", "price": 1500, "quantity": 1 }]
  }'

​
Checklist de produção

  • URL HTTPS com baixa latência
  • Timeout curto no receiver + processamento em fila
  • Idempotência por id do evento
  • Observabilidade com correlation_id
Para o formato de cada evento, veja Webhooks de pagamentos e Webhooks de Transferência.