Pular para o conteúdo principal

Início rápido

Do zero a uma cobrança PIX paga, em minutos.

1. Pegue sua chave de API​

No dashboard, em Chaves API, gere uma chave pnk_.... Ela identifica seu tenant — não é preciso enviar tenantId. Detalhes em Autenticação.

2. Crie uma cobrança PIX​

curl -X POST 'https://v2.pagnow.com/v1/payments' \
  -H 'apikey: pnk_sua_chave_aqui' \
  -H 'content-type: application/json' \
  -d '{
    "amount": 1990,
    "currency": "BRL",
    "paymentMethods": ["PIX"],
    "idempotencyKey": "pedido-123",
    "customerName": "João Silva",
    "customerDocument": "52998224725",
    "customerEmail": "joao@exemplo.com",
    "webhookUrl": "https://sua-loja.com/webhooks/pagnow"
  }'

A resposta (201) traz o copia-e-cola e o QR para o cliente pagar:

{
  "id": "a99e3d82-352b-49b2-b10e-4551ca69446e",
  "status": "WAITING_PAYMENT",
  "amount": 1990,
  "currency": "BRL",
  "pixCopyPaste": "00020101021226...br.gov.bcb.pix...",
  "pixQrCode": "data:image/png;base64,iVBOR...",
  "pixExpiresAt": "2026-05-27T13:00:00.000Z"
}

Página de checkout hospedada: https://checkout.v2.pagnow.com/{id}.

3. Receba a confirmação​

Prefira webhooks a ficar consultando o status. Quando o cliente paga, enviamos um POST assinado para o seu webhookUrl com event: "payment.completed".

Próximos passos​