Link de pagamento

Toda cobrança tem uma página para o cliente pagar e acompanhar a situação, que atualiza sozinha. Se você não escolher uma forma ao criar, o cliente escolhe entre as disponíveis nas suas contas. No Pix, a página mostra o QR Code e o botão de copiar. No boleto, mostra a linha digitável e o arquivo quando disponíveis. Para cartão pela Stripe, abre o Checkout seguro da Stripe e volta à página da SuyPay com o resultado.

É o jeito mais rápido de cobrar sem site: crie a cobrança no painel e mande o link pelo WhatsApp.

Onde pegar

• No painel: escolha O cliente, pelo link e crie a cobrança. O link vai para a área de transferência e fica na página da cobrança.
• Na API: omita method ao criar a cobrança; o campo payment_url vem na resposta.

{
  "id": "pay_3kXy...",
  "status": "requires_method",
  "payment_url": "https://pay.SEU-DOMINIO/pay_3kXy...?t=Qm9..."
}

O que o cliente vê

• O nome da sua empresa e a descrição da cobrança.
• As formas disponíveis e, depois da escolha, o QR Code, a linha do boleto ou o botão para abrir o checkout seguro do cartão.
• Quanto tempo o Pix ainda vale.
• Pagamento confirmado assim que a conta confirmar.

Para cartão escolhido pelo cliente, a Stripe coleta os dados no Checkout dela. Apple Pay e Google Pay podem aparecer ali quando a Stripe considerar a carteira elegível para a conta, dispositivo e navegador. Cobranças de cartão criadas diretamente pela API continuam usando token da conta. A página da SuyPay não recebe número ou código de segurança do cartão.

A página não mostra dados do cliente nem qual conta recebeu. O link tem um código que não dá para adivinhar: só quem recebeu o link consegue abrir.

Os links novos da página da SuyPay usam pay.SEU-DOMINIO/<id>. Os links antigos em /pay/<id> continuam abrindo. O subdomínio precisa estar ligado ao mesmo projeto da SuyPay; em testes locais, use pay.localhost:5173.

Página da própria conta

A página da SuyPay é igual para todo mundo: não dá para mudar cores, logo ou textos. Se você quer uma página com a sua marca, use a da própria conta. Asaas, Mercado Pago, Stripe, Woovi e Efí Bank (boleto) têm uma, e você personaliza no painel delas.

Para usar, abra a conta em Contas conectadas › Editar e, em Página de pagamento, escolha Da própria conta. A partir daí, o payment_url das cobranças de Pix e boleto que passarem por essa conta aponta para a página dela. A SuyPay continua acompanhando o pagamento do mesmo jeito. Cartão continua na página da SuyPay para mostrar a situação e eventual confirmação bancária.

Pela API, mande "checkout": "provider" ao conectar ou editar a conta ("suypay" volta para a página da SuyPay). Cobranças já criadas não mudam. Se a conta não devolver uma página para alguma cobrança (o Pix da Efí, por exemplo), o link continua sendo o da SuyPay.