Skip to Content
Links de pagamentoVisão geral
View as Markdown

Links de pagamento — Visão geral

Um Link de pagamento é uma URL compartilhável que coloca um comprador num checkout hospedado que você já configurou. Sem SDK, sem integração de servidor — emita no dashboard, compartilhe e o mesmo webhook payment.settled dispara quando os fundos confirmarem on-chain.

Por baixo dos panos, um Link de pagamento é uma CheckoutSession — “Link de pagamento” é só o nome do lado do dashboard para uma sessão que não foi criada por um fluxo de SDK dirigido pelo comprador. Mesmo contrato de webhook, mesma liquidação on-chain, mesmas taxas.

Usos comuns:

  • Faturar um cliente avulso sem escrever código
  • Páginas de venda em que você não tem um carrinho customizado
  • Follow-ups B2B: cole o link num e-mail
  • Páginas de gorjeta de valor fixo no estilo “Buy me a coffee”

Crie um

Crie links de pagamento no dashboard:

  1. Entre no dashboard do lojista 
  2. Payments → Payment Links → + New link
  3. Escolha um dos dois caminhos:
    • New order — informe itens, moeda, dados do cliente e metadata opcional. O dashboard cria o Order e o Link de pagamento numa única chamada.
    • Existing order — escolha um pedido PENDING (por exemplo, o comprador abandonou o link anterior). Re-emite um link novo apoiado pelo mesmo pedido, mantendo o histórico de pedido intacto.
    • Em New order você pode mudar para Somente valor para cobrar um valor fixo sem listar produtos.
  4. Salve → o dashboard mostra a URL https://checkout.infraio.xyz/cst_… com botão de copiar e download de QR code. Links em modo de teste usam checkout-dev.infraio.xyz para que o ambiente fique codificado no hostname.

Cada Link de pagamento é de uso único hoje: assim que um comprador paga, a sessão é COMPLETED. Se uma sessão expirar antes do pagamento (TTL padrão de 30 minutos), abra a página de detalhe do pedido e clique em Re-create link para emitir um novo contra o mesmo pedido.

O que o comprador vê

  1. Ele aterrissa em checkout.infraio.xyz/<session_key> — a mesma UI hospedada de checkout que você teria a partir de uma sessão emitida pelo SDK.
  2. Ele segue o fluxo padrão escolher-ativo → enviar fundos → esperar confirmação descrito em Checkout — Visão geral.
  3. payment.settled dispara no seu webhook com o pedido, o intent, o recibo, o tx hash on-chain e a contagem de confirmações — o mesmo payload de qualquer outro pagamento liquidado. Veja Webhooks para o schema.

O que o dashboard te dá

A superfície de Links de pagamento hoje vem com:

  • Visão de lista — todo link que você emitiu, com paginação por cursor, status, valor, número do pedido pai, cliente, expiração e uma abertura com um clique para a URL do comprador.
  • Filtros — status (ACTIVE / COMPLETED / EXPIRED / CANCELED), faixa de datas e busca em texto livre por número do pedido, nome do cliente, e-mail ou referência externa.
  • Exportação CSV — um clique, respeita os filtros atuais.
  • Faixa de KPIs — contagens por status para o ambiente atual (live ou test), batendo com o que a tabela mostra.
  • Página de detalhe — resumo do pedido, histórico de sessões (cada tentativa para este pedido), histórico on-chain com links para o block explorer e uma ação Re-create link para sessões que expiraram antes do pagamento.

Limitações hoje

  • Sem API programática — os links precisam ser criados no dashboard. Você pode criar sessões de uso único equivalentes via POST /b2b/v1/checkout-sessions/quick (veja Referência da API), mas links compartilháveis só são criados no dashboard.
  • Sem autenticação por comprador — qualquer um com a URL pode pagar. Cada link é de uso único, o que limita isso.
  • Branding é global — o link usa o logo do lojista, a cor da marca e o raio das bordas configurados em Settings → Branding. Overrides de branding por link não estão disponíveis.

Veja também

Visão geralShopify