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

# KYC do comprador

> O que pedimos aos compradores, por quê, e como isso afeta a experiência de pagamento.

Todo comprador que paga pela Caratuva passa por verificação de identidade uma única vez. Depois disso, paga as faturas seguintes — de qualquer vendedor da Caratuva — em segundos.

Esta página explica o que o comprador vê, o que distingue KYC pessoa física de pessoa jurídica e como um vendedor pode ajudar um comprador travado.

## Por que o KYC é obrigatório

Infraestrutura de pagamentos internacionais é regulada. Regras antilavagem, contraterrorismo e triagem de sanções exigem que saibamos quem está pagando antes de movimentar dinheiro em nome da pessoa. A Caratuva não oferece caminho para pular o KYC — em qualquer valor, qualquer país, qualquer superfície de pagamento, incluindo faturas criadas via API. É um design deliberado, não negociável.

A troca é assimétrica: alguns minutos de fricção no primeiro pagamento, depois experiência sem fricção em todos os pagamentos seguintes.

## Pessoa física vs. pessoa jurídica

O fluxo de KYC bifurca conforme o comprador esteja pagando como pessoa ou em nome de uma empresa.

* **Pessoa física** — autônomos, MEIs, freelancers, ou qualquer pessoa pagando com fundos próprios.
* **Pessoa jurídica** — empresas. Acionado quando o nome do comprador na fatura parece ser uma entidade legal, ou quando o comprador se identifica como empresa no primeiro passo do KYC.

O comprador pode trocar entre os dois no início do fluxo.

## KYC pessoa física

Para um comprador pessoa física, coletamos:

| Etapa             | O que pedimos                                                                                                                                                                                                           |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Termos de serviço | Aceite dos termos do comprador (um clique).                                                                                                                                                                             |
| Identidade        | Nome completo, data de nascimento, país de residência.                                                                                                                                                                  |
| Endereço          | Endereço residencial.                                                                                                                                                                                                   |
| Documentos        | Documento oficial com foto (passaporte, RG ou habilitação), mais uma selfie curta capturada pela câmera do dispositivo — ambos coletados na mesma etapa — para confirmar que o documento pertence a quem está enviando. |

A maioria dos KYCs pessoa física é resolvida em minutos.

## KYC pessoa jurídica

Para um comprador pessoa jurídica, coletamos tudo do KYC pessoa física para o *representante assinante*, mais:

| Etapa                 | O que pedimos                                                                                                   |
| --------------------- | --------------------------------------------------------------------------------------------------------------- |
| Identidade da empresa | Razão social, número de inscrição/registro fiscal (ex.: CNPJ), site da empresa, país de incorporação, endereço. |
| Beneficiários finais  | Qualquer pessoa com 25%+ de controle.                                                                           |
| Documentos            | Contrato social, comprovante de titularidade e comprovante de endereço da empresa.                              |
| Documento dos sócios  | Documento oficial de cada beneficiário final.                                                                   |

KYC pessoa jurídica leva mais tempo que pessoa física — geralmente algumas horas, às vezes até um dia útil para estruturas de propriedade complexas.

## O que o comprador vê

A página guia o comprador pelos passos um de cada vez, com progresso salvo entre passos. Ele pode:

* Pausar e retomar — sessões ficam salvas no servidor e voltam no próximo login.
* Refazer fotos direto no navegador se a primeira saiu tremida.
* Voltar para corrigir um erro antes de enviar.

Cada upload de documento usa uma URL segura de uso único. Os arquivos trafegam e são armazenados criptografados, e ficam acessíveis apenas a revisores de compliance autorizados.

## Fluxo de status

O comprador (e você, no painel) vê um destes:

| Status        | Significado                                                     |
| ------------- | --------------------------------------------------------------- |
| `not_started` | O comprador ainda não começou o KYC.                            |
| `pending`     | O comprador enviou; aguardando verificação.                     |
| `verifying`   | Em análise ativa.                                               |
| `approved`    | Aprovado. O comprador pode pagar esta e qualquer fatura futura. |
| `rejected`    | Não conseguimos verificar este comprador. A fatura falha.       |

Você vê o mesmo status na página de detalhe da fatura. Os webhooks disparam apenas nos resultados **terminais** do KYC — `payment_intent.buyer_kyc_approved` / `payment_intent.buyer_kyc_rejected` (e os equivalentes `invoice.buyer_kyc_*`) — não nas transições intermediárias `pending` / `verifying`.

## Reuso entre vendedores

O KYC é por comprador, não por fatura ou por vendedor. Uma vez aprovado para qualquer vendedor da Caratuva, ele reaproveita em todo pagamento subsequente, com qualquer vendedor. Não re-envia documentos. Não refaz selfie. Clica e paga.

É o efeito de plataforma — cada novo comprador aprovado reduz a fricção para a rede inteira.

## Quando o comprador pergunta "por que isso é necessário?"

Uma resposta curta que funciona:

> "A Caratuva é infraestrutura de pagamentos internacionais regulada. Somos obrigados a verificar todo mundo que paga pela plataforma. É um processo único — você nunca mais precisará fazer, conosco ou com qualquer outro vendedor que use a Caratuva."

A maioria dos compradores profissionais conhece a exigência; muitos bancos pedem os mesmos documentos. A selfie é a única etapa distinta, e existe porque KYC só com documento é facilmente fraudável.

## Quando o comprador não consegue passar

Se o KYC falhar ou o comprador não conseguir completar (perdeu documento, problema jurisdicional, etc.), a fatura vai para `buyer_kyc_rejected` e você vê o motivo no painel. Cenários comuns:

* **Jurisdição sancionada** — não onboardamos compradores em países com sanções abrangentes.
* **Pessoa politicamente exposta (PEP)** — sinalizada para due diligence reforçada; podemos ou não onboardar.
* **Qualidade do documento** — fotos de celular funcionam, mas o documento precisa estar em foco, bem iluminado e sem corte. A maioria das rejeições nessa etapa é recuperável: contate o suporte e o comprador pode reenviar.

Se um comprador específico está travado, fale com o suporte pelo painel com o e-mail dele. Vamos mostrar o que falta sem te colocar no meio.

## O que comprador vê vs. o que vendedor vê

| Superfície                       | O que aparece                                                                           |
| -------------------------------- | --------------------------------------------------------------------------------------- |
| Página de pagamento do comprador | Passo a passo do KYC. Os dados pessoais são dele.                                       |
| Detalhe da fatura do vendedor    | Apenas o status. Vendedores nunca veem documentos, endereço ou identidade do comprador. |
| Webhooks                         | Apenas transições de status. Dados pessoais não trafegam em payloads de webhook.        |

Essa separação é deliberada — vendedores não devem ter acesso aos documentos privados dos compradores, e a Caratuva impõe isso na camada de dados.
