> ## Documentation Index > Fetch the complete documentation index at: https://docs.caratuva.com/llms.txt > Use this file to discover all available pages before exploring further. # Links de pagamento > O que seu comprador vê em pay.caratuva.com e como ele vai da fatura ao pago. 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. ## Como o link se parece ``` https://pay.caratuva.com/r/ ``` 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. ### 2. Login por magic link no e-mail 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](/pt-BR/buyer-kyc) 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 aconteceu | O 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](/pt-BR/api-reference/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.