Onboarding conta escrow

Etapa 1: Preparação e Upload de Documentos

Para cada pessoa (Física ou Jurídica) que fará parte da conta (Titular, Securitizadora, Administrador, etc.), os documentos devem ser preparados e carregados antes do cadastro:

1. Solicitar Link Pré-Assinado (Pre-Signed URL):

• Endpoint: POST /v1/documents/upload

• Ação: Envie o nome do arquivo (fileName) para avisar o sistema sobre o arquivo que será carregado.

• Retorno: A API retorna o uploadUrl (para fazer o POST do arquivo) e a key (ou ID do documento).

2. Upload do Arquivo:

• Ação: Faça o POST do arquivo binário (documento) para o uploadUrl recebido.

3. Resultado:

• Retorno: A key (ID) do documento será usada no payload da Criação de Pessoa na Etapa 2.

Etapa 2: Cadastro de Todas as Pessoas (Partes Relacionadas)

Para o Titular e para cada Parte Relacionada (Securitizadora, Fundo, etc.):

1. Endpoint: POST /v1/persons

2. Payload: Inclua os dados obrigatórios (nome, e-mail) e os IDs dos documentos (obtidos na Etapa 1).

3. Retorno: O personId (ID da Pessoa) para cada pessoa criada.

Etapa 3: Criação da Conta Escrow

Use o ID da Pessoa Titular e os IDs das outras Partes Relacionadas para criar a conta.

1. Endpoint: POST /v1/accounts

2. Payload Essencial:

   1. accountType: Defina como ESCROW.

   2. personId: O ID da pessoa titular.

   3. parties (Partes Relacionadas): Liste todas as pessoas que farão parte da conta (Titular, Fundo, Gestor, etc.).

   4. permissions: Defina o array de permissões para cada Parte Relacionada (ex: POSTING_CREATE, POSTING_REVIEW, VIEW_ACCOUNT). As permissões são cruciais e não podem ser alteradas via API após a criação.

   5. accountStatusChangeWebhookUrl (Opcional, mas Recomendado): Defina uma URL para receber eventos de onboarding (ex: "em análise", "aprovado").

3. Resultado: A conta é criada e entra no fluxo de análise (onboarding - KYC, etc.), e os eventos de status são enviados para o webhook configurado.

Etapa 4: Preparação para Movimentação de Fundos (Destinatários)

Use o ID da Pessoa Titular e os IDs das outras Partes Relacionadas para criar a conta.

1. Endpoint: POST /v1/accounts/:accountId/destinations

2. Ação: Cadastre os dados bancários (banco, agência, conta) das contas para as quais a Conta Escrow fará Pix/TED.

3. Retorno: O accountDestinationId, que será usado para realizar as transferências (POST /v1/postings).

Etapa 5: Configuração de Funcionalidades Adicionais (Cobrança e Retenção)

Dependendo das necessidades do contrato Escrow:

📘

API reference

Para um entendimento completo dos casos de uso, chamadas e exemplos de retorno acesse nossa  API Refrence.

👩‍💻

Suporte Técnico

Para esclarecimento de dúvidas técnicas, reporte de erros ou acompanhamento de integrações, o canal de suporte da cel_credit está disponível durante todo o processo através do e-mail [email protected]