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