Links de pagamento 🔗
Um link de pagamento é uma URL compartilhável que abre um checkout hospedado sem você precisar criar a transação — ideal para cobrar por WhatsApp, e-mail, bio de rede social ou QR impresso. O cliente abre o link, escolhe como pagar, e a cobrança é criada na hora, no momento em que ele clica em Pagar.
O link tem o formato:
https://checkout.v2.pagnow.com/l/{token}Onde criar
Você cria e gerencia os links no painel (Dashboard → Links de pagamento). Cada link é vinculado a um modelo de checkout, que define visual, idiomas e métodos.
Para cada link você define:
- Valor — fixo (você define o preço) ou definido pelo cliente (o cliente digita quanto vai pagar — útil para doações/gorjetas).
- Produto/descrição — o que aparece no resumo.
- Moeda e métodos vêm do modelo (ver seleção de moeda abaixo).
- Limites opcionais — número máximo de usos, data de expiração e uma URL de redirecionamento pós-pagamento.
Seleção de moeda embutida
Quando o modelo habilita mais de uma moeda, o link mostra um seletor de moeda
na própria página — sem passo extra. Ao trocar a moeda, a página re-resolve
ao vivo os métodos disponíveis, o valor convertido (câmbio) e a taxa exibida.
Como cada método é amarrado à sua moeda (PIX ↔ BRL, métodos locais europeus ↔
EUR), a moeda escolhida é a moeda de cobrança: a transação nasce nela
quando o cliente confirma.
Ciclo de vida
- Você cria o link no painel e compartilha a URL.
- O cliente abre
…/l/{token}, vê o resumo, escolhe moeda (se houver mais de uma) e método, e preenche os campos que o modelo pedir. - Ao clicar em Pagar, a transação é criada na moeda escolhida e o cliente segue o fluxo normal do método (QR do PIX, redirecionamento, etc.).
- Você recebe os webhooks normais da cobrança.
Links respeitam os limites configurados: expirados ou com usos esgotados deixam de aceitar novas cobranças.
Diferença para o campo checkout
Campo checkout na API | Link de pagamento | |
|---|---|---|
| Quem cria a transação | Você, via POST /v1/payments | O cliente, ao clicar em Pagar |
| Valor | Você já sabe e envia | Fixo ou definido pelo cliente |
| Uso típico | Integração no seu checkout/servidor | Compartilhar uma URL pronta |
| Multi-moeda na página | — (moeda já definida na cobrança) | Sim, seletor embutido |
Próximos passos
- Checkout hospedado — o campo
checkoutna criação da cobrança. - Modelos de checkout — o visual, idiomas e métodos por trás do link.
