Pular para o conteúdo principal
Um link de pagamento é a URL que a Caratuva gera para cada fatura aprovada. Ele aponta para uma página de pagamento hospedada em pay.caratuva.com que leva seu comprador de “devo USD 12.500” a “pago” — sem instalar nada, sem criar conta na Caratuva, sem ter uma carteira digital. Você pode entregar o link:
  • Pelo botão “Convidar comprador” do painel, que envia um magic link por e-mail a partir da Caratuva.
  • Pelo seu próprio canal — CRM, ERP, WhatsApp, mensagem no app. Copie o link na página de detalhe da fatura.
Os dois caminhos levam o comprador para a mesma página hospedada. 
https://pay.caratuva.com/r/<publicId>
O publicId é não-adivinhável. A página é segura para compartilhar por qualquer canal — ela sozinha não dá acesso. Para realmente pagar, o comprador precisa comprovar a posse do endereço de e-mail da fatura.

​
O que o comprador vê

​
1. O resumo da fatura

A página inicial mostra:
  • Seu nome fantasia e logo (se houver um cadastrado para a sua organização).
  • O cabeçalho da fatura, valor e moeda.
  • Os itens e qualquer observação que você escreveu.
  • Um botão “Entrar para pagar”.
Se o comprador chega sem sessão, ele vê o resumo em modo somente-leitura e clica para entrar. O comprador informa o endereço de e-mail para o qual a fatura foi endereçada. A Caratuva envia por e-mail um link de login de uso único que expira em 15 minutos e só pode ser usado uma vez. Clicar no link faz o login e o encaminha para a próxima etapa do fluxo dele — verificação de identidade, pagamento ou acompanhamento, dependendo de onde ele está (não o leva de volta à página de resumo). A sessão é um cookie httpOnly de 30 dias escopado em pay.caratuva.com. Se o e-mail não bater com o e-mail do comprador da fatura, a solicitação de login é rejeitada imediatamente — nenhum e-mail de magic link é enviado e o comprador vê um erro no formulário de login. Isso impede que qualquer pessoa que tenha recebido o link encaminhado ganhe acesso.

​
3. KYC (apenas na primeira vez)

Se for o primeiro pagamento desse comprador na Caratuva, ele faz a verificação de identidade. O KYC é obrigatório em toda superfície de pagamento — não há caminho para pular, mesmo em valores muito baixos ou em faturas criadas via API. Um comprador que voltou e já se verificou — incluindo a partir da fatura de outro vendedor — reaproveita o KYC existente e pula essa etapa. Geralmente paga em segundos. Veja KYC do comprador para o que pedimos.

​
4. Pagamento (cotação de câmbio + transferência bancária)

Em uma única página, o comprador escolhe a moeda de envio e um trilho bancário (ACH, wire ou SEPA — cartão não é oferecido atualmente) e então trava uma cotação de câmbio: exatamente quanto pagará na própria moeda, a taxa de câmbio e quaisquer tarifas. A cotação travada tem TTL de 10 minutos — se o comprador demorar demais, ele trava uma cotação nova (que pode ser diferente). Após confirmar, o comprador recebe instruções de transferência bancária (nome do banco, número da conta, routing/IBAN/SWIFT e um código de referência) e paga a partir do próprio banco. Assim que esses fundos chegam, nós os transferimos internacionalmente e fazemos o repasse em BRL para a sua chave PIX cadastrada.

​
5. Confirmação

Quando a coleta termina, o comprador é redirecionado para sua returnUrl (se você a configurou ao criar a fatura). Caso contrário, vê uma página de confirmação da Caratuva com o recibo da fatura. A linha do tempo do lado do vendedor segue avançando a partir daí — fiat_received, offramp_pending, settled — tudo assincronamente, sem envolvimento do comprador. Para o comprador, a parte dele acaba assim que os fundos são coletados.

​
Marca

A página do comprador mostra o nome fantasia da sua organização (no cabeçalho e no template de e-mail do magic link) e o logo, quando houver um cadastrado. Configurar o logo ou uma cor da marca ainda não é self-service no painel — entre em contato com o suporte para configurá-los. Mantemos o resto da página consistente entre vendedores deliberadamente — essa consistência é o que faz compradores recorrentes confiarem na página. Eles já estiveram aqui antes.

​
Idiomas

A página detecta automaticamente o idioma do navegador do comprador e serve em português, inglês ou espanhol (mais idiomas a caminho). O comprador pode trocar pelo seletor no rodapé.

​
Mobile

A página funciona em qualquer celular ou tablet moderno. A captura de documento de KYC usa a câmera do dispositivo diretamente — compradores não precisam mandar screenshots por e-mail.

​
O que NÃO está na página

Para manter o comprador focado em pagar:
  • Sem propaganda, upsell ou cross-promotion.
  • Sem links para o marketing da Caratuva.
  • Sem pedido para o comprador “criar uma conta” — ele já tem uma, em virtude de ter clicado no link.

​
Modos de falha

O que os compradores veem quando algo dá errado:
O que aconteceuO que o comprador vê
Magic link expirou”Este link expirou. Solicite um novo.”
E-mail não confere”Esta fatura foi enviada para outro endereço.”
KYC rejeitado”Não conseguimos verificar sua identidade. Contate o suporte.”
Cotação de câmbio expirou”Esta cotação expirou. Trave uma nova para continuar.”
Fatura cancelada pelo vendedor”Esta fatura foi cancelada. Contate o vendedor.”
Fatura expirou”Esta fatura expirou em [data]. Contate o vendedor.”
Todos esses também disparam um webhook para o seu ERP — veja Webhooks.

​
Personalizando além

A maioria dos vendedores não precisa personalizar além da marca. Se você quer um checkout totalmente embutido — seu domínio, seu estilo, seu comportamento de “voltar” — fale com a gente sobre a opção de checkout embutido.