Documentação PagNow
A PagNow é uma API de pagamentos REST + JSON: PIX, cartão, boleto e stablecoin, com webhooks assinados e SDKs oficiais. Toda requisição é autenticada por uma chave de API e os valores são sempre inteiros na menor unidade da moeda (centavos).
Base URL de produção: https://v2.pagnow.com
Comece em 3 passos
- Pegue sua chave de API no dashboard.
- Crie uma cobrança PIX com um
POST /v1/payments. - Receba a confirmação via webhook quando o cliente pagar.
Formas de integrar
- HTTP direto em qualquer linguagem (exemplos em cURL, Python e PHP ao longo da doc).
- SDK oficial:
@pagnow/sdk-node(npm) oupagnow/sdk-php(Composer) — já trazem autenticação, retries e verificação de webhook prontos. Veja SDKs. - Referência da API (OpenAPI/Redoc): https://v2.pagnow.com/docs/payments/reference.
Conceitos rápidos
| Conceito | Resumo |
|---|---|
| Autenticação | Header apikey: pnk_.... A chave identifica seu tenant. |
| Valores | Inteiros em centavos (1990 = R$ 19,90). |
| Idempotência | idempotencyKey em create/refund evita duplicidade. |
| Webhooks | POST assinado com X-PagNow-Signature quando o status muda. |
| Erros | Envelope JSON único { statusCode, error, message, requestId }. |