PagNow
Checkout hospedado

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:

  • Valorfixo (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

  1. Você cria o link no painel e compartilha a URL.
  2. 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.
  3. 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.).
  4. 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 APILink de pagamento
Quem cria a transaçãoVocê, via POST /v1/paymentsO cliente, ao clicar em Pagar
ValorVocê já sabe e enviaFixo ou definido pelo cliente
Uso típicoIntegração no seu checkout/servidorCompartilhar uma URL pronta
Multi-moeda na página— (moeda já definida na cobrança)Sim, seletor embutido

Próximos passos

Nesta página