Bem-vindo
Documentação PagNow
A PagNow é uma API de pagamentos REST + JSON: PIX, cartão, boleto, stablecoin, métodos europeus (MB WAY, Multibanco, iDEAL, Bancontact, SEPA, Bizum) e checkout local na América Latina e África, 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.comComece 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.
Métodos de pagamento
| Método | Moeda | Como o cliente paga | Disponibilidade |
|---|---|---|---|
| PIX 🇧🇷 | BRL | QR Code / copia-e-cola | Ativo |
| Crypto 🌐 | USDT/USD | Endereço de depósito on-chain | Ativo |
| Cartão 🌐 | conforme conta | Redirect para checkout hospedado | Ativo |
| Boleto 🇧🇷 | BRL | Linha digitável / PDF | Sob ativação |
| MB WAY 🇵🇹 · Multibanco 🇵🇹 | EUR | Redirect para checkout hospedado | Sob ativação |
| iDEAL 🇳🇱 · Bancontact 🇧🇪 · SEPA 🇪🇺 · Bizum 🇪🇸 | EUR | Redirect para checkout hospedado | Sob ativação |
| LATAM e África 🌎 | moeda local / USD | Redirect para checkout hospedado (cliente escolhe o método local) | Sob ativação |
Métodos "sob ativação" exigem habilitação prévia na sua conta — fale com integrations@pagnow.com.
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 | Sempre envie idempotencyKey em cobranças, saques e reembolsos. Mesma chave → mesma operação (nunca duplica). Saiba mais. |
| Webhooks | POST assinado com X-PagNow-Signature quando o status muda. |
| Erros | Envelope JSON único { statusCode, error, message, requestId }. |