Skip to main content

​
Visão Geral

As rotas de subcontas permitem criar e gerenciar contas completas para seus clientes, incluindo usuário, empresa e integração com processador de pagamentos.

​
🔐 Autenticação

Todas as rotas utilizam autenticação com os headers:
  • api_key: Chave de API do usuário
  • api_secret: Secret de API do usuário

​
Endpoints Disponíveis

Documentos Obrigatórios

Lista completa dos documentos necessários para criação de subcontas

Criar Subconta

Cria uma nova subconta completa com usuário e empresa

Upload Documento Pessoal

Upload de documentos pessoais (RG, CNH, Selfie)

Upload Documento Empresa

Upload de documentos empresariais (Contrato Social)

Abrir Conta Completa

Inicia processo de abertura de conta no processador

​
Fluxo Recomendado

1

1. Verificar Documentos

Consulte a lista de documentos obrigatórios antes de começar
2

2. Criar Subconta

Use POST /sub-accounts para criar a subconta com todas as informações básicas
3

3. Upload Documentos

Faça upload dos documentos pessoais e empresariais obrigatórios
4

4. Abrir Conta

Use POST /sub-accounts/open-full-account para iniciar o processo de análise
5

5. Monitorar

Acompanhe o status através de webhooks e consultas de status

​
Códigos de Erro Comuns

{
  "message": "Tipo de documento inválido.",
  "statusCode": 400
}

{
  "message": "Api Key não encontrada.",
  "statusCode": 401
}

{
  "message": "Email já cadastrado.",
  "statusCode": 409
}

{
  "message": "Erro ao registrar conta.",
  "statusCode": 500
}