Skip to main content
POST
Depois de criar a subconta, a Finvia precisa dos documentos da empresa e do representante legal para fazer o credenciamento (KYC). Esta rota recebe esses arquivos direto do seu servidor, autenticada com a chave secreta da conta master. Os documentos de pessoa enviados aqui ficam sempre ligados ao representante legal (principal).

Quando usar

Se a subconta tem só um representante (sem additionalRepresentatives), esta rota é tudo o que você precisa. Integrações que já usam esta rota continuam funcionando sem mudança.

Antes de chamar

  • Tenha o id da subconta, devolvido em Criar subconta.
  • Autentique com a chave secreta (sk_) da conta master (Credenciais e ambientes).
  • Os arquivos precisam estar em JPEG, JPG, PNG, GIF, BMP, WEBP ou PDF, com no máximo 50 MB cada.
  • Envie antes da aprovação: depois que a subconta é aprovada, novos uploads são bloqueados (422).
  • Confira quais documentos o credenciamento exige em Regras de credenciamento.

Parâmetros de caminho

string
required
Identificador único da subconta. Ex.: 36OO3bcGjhPjjF3tzrqOGcmQuKo.

Corpo da requisição

Formato multipart/form-data, obrigatório. O nome de cada campo é o tipo do documento. Nenhum campo é obrigatório sozinho, mas a requisição precisa ter pelo menos um arquivo (minProperties: 1). Você pode enviar vários documentos na mesma chamada ou um por chamada.
file
Cartão CNPJ da empresa (tipo string, formato binary). Documento de empresa.
file
Contrato social da empresa (tipo string, formato binary). Documento de empresa.
file
Frente do documento de identificação do representante legal (tipo string, formato binary). Documento de pessoa.
file
Verso do documento de identificação do representante legal (tipo string, formato binary). Documento de pessoa.
file
Selfie do representante legal segurando o documento (tipo string, formato binary). Documento de pessoa.
file
IRS letter, usada no fluxo de cadastro de LLC (tipo string, formato binary). Documento de empresa.
Qualquer outro nome de campo é recusado com 400 Invalid document name. Não há campo para o certificado de MEI: para enviar esse documento, fale com o suporte da Finvia.
Esta rota não diferencia sócios. Documentos de pessoa enviados aqui sempre ficam no representante legal. Se você enviar aqui a identidade de um sócio adicional, ela será registrada como documento do representante principal. Para sócios, use o fluxo com token.

Respostas

A resposta 201 não tem corpo. O sucesso é indicado pelo código HTTP. Esta rota usa o corpo de erro padrão (statusCode, message, error), sem os códigos próprios da rota com token. Trate o erro pelo código HTTP.
Cada arquivo foi aceito quando a resposta é 201. Para conferir os documentos de pessoa e o status de análise de cada um, use Listar representantes com include=documents.
Para o negócio: no roteiro de homologação, o cenário FC-02 pede um envio por tipo: contrato social, cartão CNPJ, documento do responsável (frente e verso) e selfie com documento. Peça esses arquivos ao vendedor já no cadastro, para enviar tudo logo depois de criar a subconta.

Erros comuns

Veja também

Sócios e documentos

Quando usar a rota direta e quando usar o token.

Criar token de upload

Token para sócios e uploads pelo navegador.

Listar representantes

Status de análise de cada documento.

Subcontas e KYC

Fluxo completo de credenciamento.