> ## 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. # Repasses > Onde o BRL liquidado cai e como cadastrar o destino. Quando o pagamento do comprador é compensado, a Caratuva repassa o equivalente em BRL para uma conta bancária brasileira que você indica. Este guia cobre como cadastrar o destino, quando os repasses chegam e o que fazer se algo parecer estranho. ## Como funcionam os repasses Toda empresa aprovada ganha uma conta virtual interna que mantém os fundos do comprador no breve intervalo entre coleta e repasse. Você não gerencia essa conta — ela é invisível na operação normal. Quando uma fatura liquida, a Caratuva inicia uma transferência PIX da conta virtual para o destino cadastrado. O PIX é o trilho de pagamento instantâneo do Brasil; as transferências geralmente caem em segundos e são irrevogáveis no recebedor uma vez compensadas. ## Cadastrando seu destino No painel, abra a página de **Repasses** e conclua o **Passo 3 — cadastre sua chave PIX**. O formulário de destino recebe um único valor: * A **chave PIX** registrada na sua conta bancária brasileira — informe-a como um único campo, e nosso parceiro de liquidação detecta automaticamente o tipo da chave. Não há um campo separado para o nome do banco. O nome jurídico da conta recebedora precisa bater com a entidade verificada no seu KYB; essa correspondência é garantida pelo KYB (coletado mais cedo no fluxo de Repasses), e não neste formulário. A Caratuva aceita todos os tipos de chave PIX: | Tipo de chave | Formato | Notas | | --------------- | --------------------------- | ----------------------------------------------------- | | CPF | 11 dígitos | Use o CPF do representante legal da entidade. | | CNPJ | 14 dígitos | Recomendado — vínculo direto com a entidade jurídica. | | E-mail | E-mail padrão | Precisa ser o e-mail registrado no banco. | | Telefone | E.164 (ex.: +5511999999999) | Precisa ser o telefone registrado no banco. | | Aleatória (EVP) | UUID | A "chave aleatória" emitida pelo app do seu banco. | Recomendamos fortemente uma **chave CNPJ** — é o mapeamento mais limpo entre sua entidade jurídica e a conta recebedora. ## Destino precisa bater com a entidade do KYB O nome jurídico da conta recebedora precisa ser igual ao nome jurídico que verificamos no KYB. Isso é regulatório: não podemos repassar para uma entidade que não verificamos. Se você precisar trocar a entidade recebedora (ex.: adquiriu uma operadora diferente), refaça o KYB a partir da página de **Repasses** primeiro. O novo destino fica disponível depois que a nova entidade for aprovada. ## Múltiplos destinos A maioria das empresas usa um único destino. Se você opera várias entidades jurídicas dentro de uma organização, fale com a gente — configuramos destinos por entidade. ## Tempo de repasse Para faturas que liquidam dentro do horário bancário brasileiro, o repasse inicia assim que a transferência bancária do comprador liquida no trilho de origem (o tempo depende do país e do trilho do comprador — ACH, wire ou SEPA). Para faturas que liquidam fora do horário bancário, o repasse pode entrar em fila até o próximo ciclo PIX. O PIX roda 24/7 em condições normais, mas cortes bancários eventualmente introduzem uma pequena latência. A linha do tempo da fatura mostra o timestamp exato de quando o repasse foi iniciado e quando foi confirmado. ## Confirmando o recebimento Quando a transferência PIX compensa no recebedor, a fatura vai para `settled` e dispara um webhook `payment_intent.settled` (ou `invoice.settled`). A linha do tempo do painel mostra o ID end-to-end do PIX, que você pode bater contra o extrato bancário. Se seu banco mostra o crédito mas a Caratuva ainda mostra `offramp_pending`, aguarde alguns minutos — reconciliamos confirmações de PIX entrante em cadência curta. Se a divergência continuar após 30 minutos, contate o suporte. ## Repasses falhos Um repasse pode falhar se: * A chave PIX de destino foi desativada ou transferida para outra conta bancária. * A conta recebedora foi encerrada. * O banco recebedor recusa a transferência (raro, geralmente divergência de nome). Quando isso acontece, a fatura vai para `offramp_failed` com o motivo, e os fundos permanecem na sua conta virtual. Você pode atualizar o destino e tentamos de novo — ou, se o problema de destino é estrutural, entramos em contato direto. ## Tarifas As tarifas da Caratuva são deduzidas do pagamento do comprador, antes do líquido em BRL ser repassado. O detalhe da fatura no painel mostra a quebra: ``` Buyer paid (USD) 12,500.00 FX rate 5.05 BRL gross 63,125.00 Caratuva fee -631.25 Network / banking fee -15.00 BRL paid out 62,478.75 ``` A estrutura exata de tarifas depende do seu contrato. Fale com seu account manager se precisar de uma quebra detalhada para a contabilidade. ## Relatórios fiscais Para vendedores brasileiros, toda fatura liquidada gera uma entrada no seu relatório de preços de transferência, disponível via API (`GET /v1/reports/transfer-pricing`) em JSON, CSV ou PDF, com corte trimestral. (Ainda não há uma tela de relatórios no painel.) Entregue diretamente ao seu contador. A Caratuva não declara seus impostos. Mas entregamos exatamente os dados que seu contador precisa. ## Trocando seu destino Atualizar a chave PIX é um clique na página de **Repasses**. A nova chave passa a valer para qualquer fatura que ainda não entrou em `offramp_pending`. Faturas já em trânsito repassam para o destino anterior — não desviamos no meio do caminho. Ação de `admin` (administrador). Os papéis `treasurer` (financeiro) e `viewer` (leitor) podem visualizar, mas não trocar. ## Boas práticas * **Use uma conta com chave CNPJ** — trilha de auditoria mais limpa. * **Mantenha sua chave PIX ativa** — registrar uma chave CPF numa conta corporativa funciona, mas adiciona fricção na reconciliação. * **Reconcilie pelo ID externo** — se você cria faturas com um ID externo / referência estável, todo crédito PIX volta ao pedido original em segundos. * **Não agrupe destinos** — uma organização, um destino, com raras exceções. Agrupar torna a reconciliação dolorosa para todo mundo.