> ## 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.

# Onboarding (KYB)

> Verifique sua empresa antes de cobrar pagamentos reais.

A Caratuva é infraestrutura regulada para pagamentos B2B internacionais. Antes da sua empresa receber um único centavo real em BRL, rodamos a verificação **Know-Your-Business** — confirmando identidade jurídica, estrutura societária e beneficiários finais.

A boa notícia: enquanto você espera, pode rodar o fluxo inteiro de ponta a ponta em **modo teste** sem trava. O KYB só bloqueia o modo produção.

## O que pedimos

| Item                                                                                                     | Por quê                                                                        |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Razão social e CNPJ                                                                                      | Identifica a entidade verificada.                                              |
| País de incorporação, endereço registrado                                                                | Exigências jurisdicionais.                                                     |
| Contrato social ou estatuto (PDF)                                                                        | Prova de que a entidade existe e que você está autorizado a representá-la.     |
| Beneficiários finais (qualquer pessoa com 25%+ de controle)                                              | Regras antilavagem exigem que saibamos quem ultimamente possui e se beneficia. |
| Documento de identidade de cada beneficiário                                                             | Verificação de identidade.                                                     |
| Comprovante de endereço da empresa (conta de consumo, contrato de aluguel, extrato bancário, \< 3 meses) | Liga o endereço registrado a um local real.                                    |

Se sua empresa tem estrutura societária complexa (holdings, matriz estrangeira, fundos), podemos pedir documentos adicionais durante a análise. Tentamos manter o pedido enxuto.

## Como enviar

O KYB é o **Passo 2 do fluxo de Repasses** no painel. (Para o KYB de *produção*, sua
Solicitação de Acesso à Produção já precisa estar aprovada e você precisa ter mudado para o
modo produção — veja [Modos teste e produção](/pt-BR/environments). No modo teste ele fica disponível a partir do cadastro.)

1. Entre em [dashboard.caratuva.com](https://dashboard.caratuva.com).
2. Vá em **Repasses** na barra lateral.
3. **Aceite os termos de serviço do nosso parceiro de liquidação** (Passo 1) — você é redirecionado para a página hospedada do parceiro e de volta. O KYB não fica acessível até que você faça isso.
4. **Verifique sua empresa** (Passo 2): preencha os dados da entidade e envie os documentos da tabela acima. Cada upload usa um link seguro de uso único, então o arquivo trafega e fica armazenado criptografado.
5. Liste os beneficiários finais. O sistema solicitará o documento de cada um.
6. Envie.

Os documentos enviados persistem conforme você avança, mas os campos do formulário não são salvos no servidor até você enviar.

## O que acontece em seguida

O envio passa por estes estados, exibidos ao vivo na tela de onboarding:

| Status      | Significado                                                                                                   |
| ----------- | ------------------------------------------------------------------------------------------------------------- |
| `pending`   | Você começou o envio mas ainda não o mandou para análise.                                                     |
| `submitted` | Seu envio chegou e está na fila de análise.                                                                   |
| `verifying` | Estamos analisando o envio. A maioria é resolvida em poucas horas.                                            |
| `approved`  | Você está liberado para pagamentos em produção. Uma conta virtual é provisionada automaticamente.             |
| `rejected`  | Não conseguimos onboardar essa empresa. A tela explica o motivo e o que (se algo) você pode fazer em seguida. |

O status atual é exibido ao vivo na página de Repasses (ela consulta atualizações periodicamente) — hoje não há um e-mail separado de mudança de status.

## Após a aprovação

Quando o KYB é aprovado:

1. Uma **conta virtual** é provisionada para sua organização. É a conta interna que mantém os fundos do comprador no breve intervalo entre coleta e repasse em BRL. Você não precisa gerenciá-la — ela é invisível na operação normal.
2. Você pode **transacionar em produção**. (O modo produção em si tornou-se selecionável antes, assim que sua Solicitação de Acesso à Produção foi aprovada; a aprovação do KYB é o que permite a liquidação real em BRL.)
3. Registre seu **destino de repasse PIX** — Passo 3 do fluxo de Repasses, veja [Repasses](/pt-BR/payouts).

Pode criar a primeira fatura em produção imediatamente. A primeira liquida de ponta a ponta exatamente como o fluxo de modo teste que você já praticou.

## Reexecutando o KYB

Se a estrutura jurídica da empresa mudar (renomeação, mudança de endereço, alteração de quadro societário, novo beneficiário), avise — pode ser necessário re-verificar. Vamos exibir um banner no painel se uma nova verificação for exigida, com link de volta para o formulário de onboarding.

## Privacidade

Os documentos enviados ficam armazenados criptografados, são acessíveis apenas a revisores de compliance autorizados e ficam retidos pelo prazo exigido pela regulação antilavagem brasileira e internacional. Nunca os compartilhamos com outros clientes da Caratuva.

## Travas comuns

* **Beneficiário sem documento** — todo indivíduo com 25%+ de controle precisa do próprio documento. Se você tem dez sócios, cada um com 10%, não precisamos do documento de nenhum.
* **Qualidade da imagem do documento** — fotos de celular funcionam, mas o documento inteiro precisa estar visível, em foco, com os quatro cantos. Reflexos e cortes derrubam o envio.
* **Razão social divergente** — a razão social no nosso formulário precisa bater exatamente com o contrato social, incluindo pontuação. "ABC Trading Ltda" e "ABC Trading LTDA." precisam ser iguais nos dois lugares.
* **Endereço divergente** — o endereço no comprovante precisa bater com o que você digitou no formulário. Se mudou recentemente, registre a alteração na Junta Comercial primeiro.

Se o envio ficar travado por mais de um dia útil, fale com o suporte pelo painel e destravamos diretamente.
