Pular para o conteúdo principal
Esta página é para engenheiros de back-end que querem o caminho mais curto até uma integração funcional em sandbox.

​
Antes de começar

  • Um token de sandbox da Pagou
  • Acesso a https://api-sandbox.pagou.ai
  • Um identificador próprio para usar como external_ref
Tempo estimado: 10 a 15 minutos.

​
Etapa 1: valide a autenticação

curl --request GET \
  --url https://api-sandbox.pagou.ai/v2/transactions \
  --header "Authorization: Bearer SEU_TOKEN_SANDBOX"

​
Etapa 2: crie uma transação Pix

curl --request POST \
  --url https://api-sandbox.pagou.ai/v2/transactions \
  --header "Authorization: Bearer SEU_TOKEN_SANDBOX" \
  --header "Content-Type: application/json" \
  --data '{
    "external_ref": "order_1001",
    "amount": 1500,
    "currency": "BRL",
    "method": "pix",
    "notify_url": "https://merchant.example/webhooks/pagou",
    "buyer": {
      "name": "Ada Lovelace",
      "email": "ada@example.com",
      "document": {
        "type": "CPF",
        "number": "12345678901"
      }
    },
    "products": [
      {
        "name": "Pedido inicial",
        "price": 1500,
        "quantity": 1
      }
    ]
  }'

​
Etapa 3: persista os identificadores

  • seu external_ref
  • id da transação na Pagou
  • status atual
  • requestId para suporte e observabilidade

​
Etapa 4: use webhooks como canal principal

app.post("/webhooks/pagou", async (req, reply) => {
	const event = req.body as { id: string };

	reply.code(200).send({ received: true });
	await queue.enqueue(event);
});

​
Etapa 5: reconcilie quando houver dúvida

curl --request GET \
  --url https://api-sandbox.pagou.ai/v2/transactions/trx_123 \
  --header "Authorization: Bearer SEU_TOKEN_SANDBOX"