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: