Pular para o conteúdo principal
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 chaveFormatoNotas
CPF11 dígitosUse o CPF do representante legal da entidade.
CNPJ14 dígitosRecomendado — vínculo direto com a entidade jurídica.
E-mailE-mail padrãoPrecisa ser o e-mail registrado no banco.
TelefoneE.164 (ex.: +5511999999999)Precisa ser o telefone registrado no banco.
Aleatória (EVP)UUIDA “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.