Usar links de pagamento

Um link de pagamento é uma URL reutilizável do checkout hospedado. Crie uma oferta no painel e compartilhe o mesmo link no seu site, em mensagens, campanhas ou em um código QR.

Criar, editar ou visualizar o link não cobra um cliente. O checkout inicia uma tentativa de compra separada quando o comprador começa o fluxo interativo.

Requisitos

• Produtos e preços configurados para todos os itens.
• Link ativo e não expirado.
• Uma rota de pagamento disponível para o país e moeda previstos.
• Acesso para gerenciar links na conta e ambiente ativos.
• Para integrações, um receptor de Webhooks que verifique o resultado.

Configurar e publicar

1. Abra Cobranças → Links de pagamento e selecione Criar link de pagamento, ou use a API.
2. Escolha produtos, preços e quantidades. Confira a composição do carrinho e valores iniciais e recorrentes.
3. Configure campos, promoções, cupons, parcelas, expiração e ação após checkout.
4. Confira a prévia, salve e ative o link.
5. Teste uma compra no Sandbox e confira a fatura e o resultado do pagamento. Se integrar a API, verifique também o receptor de webhooks.
6. Depois de testar, configure a oferta de Produção e compartilhe a URL hospedada /checkout/:slug pelo canal escolhido.

<a href="https://checkout.example.com/checkout/summer-offer">
  Comprar
</a>

Mantenha parâmetros de campanha quando precisar de atribuição. Um domínio próprio altera o host público, não a identidade da oferta.

Cupons e promoções automáticas

Na seção de promoções do editor, selecione os benefícios automáticos e habilite Permitir cupons para o comprador informar um código. Criar um cupom ou promoção não configura o link sozinho. Consulte Cupons, Promoções e Como combinar descontos.

Salve e inicie uma nova tentativa no Sandbox para testar benefícios elegíveis e não elegíveis. A prévia mostra benefícios configurados; o cálculo final confirma quais aplicam.

Detalhes de integração

As próximas seções explicam sessões de checkout, confirmação e eventos que seu backend deve verificar. Se usar apenas o painel, consulte a fatura resultante.

Fluxo de compra

1. O comprador abre a URL e o Pharos resolve o link ativo.
2. O checkout inicia o fluxo interativo e cria uma sessão com snapshot ou retoma a sessão aberta correspondente naquela aba.
3. A sessão mantém itens, preços, recorrência, campos, benefícios, parcelas e expiração da tentativa.
4. O comprador preenche contato e faturamento e escolhe uma forma de pagamento disponível.
5. O Pharos valida a oferta, calcula o valor final e cria os registros correspondentes de cliente, fatura, assinatura e pagamento.
6. O pagamento pode concluir imediatamente, pedir outra ação ou continuar em processamento.
7. O checkout mostra o resultado ou instruções; sua integração confirma a compra somente com invoice.paid assinado e sem duplicar efeitos.

Oferta reutilizável e snapshot

Alterações de produtos, preços, campos, promoções ou parcelas afetam sessões posteriores. Uma sessão aberta mantém uma cópia da configuração original até ser concluída ou expirar. Desativar, expirar ou excluir o link impede novas sessões; não modifica a tentativa existente. Atualizar a mesma aba pode retomar sua sessão.

A prévia não cria sessão, fatura, assinatura ou pagamento. A mensagem de confirmação e destino de redirecionamento são copiados para a sessão; editar depois não altera tentativas abertas.

Ação após checkout

Escolha CONFIRMATION para mostrar o resumo com mensagem padrão ou personalizada em texto simples. A mensagem personalizada aparece como foi escrita e não é traduzida pela localização do comprador.

Escolha REDIRECT para navegar a uma URL HTTP(S) após finalização sem falha, incluindo pagamentos em processamento ou sem cobrança necessária. A URL pode conter {CHECKOUT_SESSION_ID} e o Pharos o substitui. Destinos localhost são admitidos apenas no Sandbox.

O redirecionamento não confirma pagamento: pode acontecer antes do resultado final de uma forma de pagamento assíncrona.

Interpretar o resultado

Uma página de sucesso ou checkout_session.completed não comprova recebimento de fundos.

Problemas frequentes

• Link não encontrado: confira slug, ativação, exclusão e expiração.
• Falta preço, moeda ou forma de pagamento: confira catálogo, carrinho e rotas habilitadas.
• Alterações recentes não aparecem: inicie nova tentativa; a sessão anterior mantém seu snapshot.
• Comprador parado: consulte estado, resultado do pagamento e expiração antes de pedir nova tentativa.
• Seu sistema não entregou a compra: confira assinatura, duplicados, entregas e recebimento de invoice.paid.

Continuar

• Cart Checkout
• Webhooks de Collections
• Faturas