Desabilitando a Conta Escrow

Desabilite a Conta Escrow quando uma subconta não precisar mais reter novos recebimentos sob garantia.

A desabilitação também inicia a liberação de todas as garantias existentes da subconta.

Antes de desabilitar

Use este fluxo somente quando a subconta não precisar mais utilizar a retenção de novos recebimentos.

Se a intenção for apenas aguardar a expiração das garantias existentes, mantenha a Conta Escrow habilitada. As garantias serão encerradas conforme o fluxo de liberação configurado.

Desabilite uma subconta

Utilize o mesmo endpoint de configuração da Conta Escrow:

POST /v3/accounts/{id}/escrow

Defina enabled como false e envie os demais campos necessários para a configuração.

{
	"enabled": false,
	"isFeePayer": true,
	"daysToExpire": 10
}

O parâmetro {id} corresponde ao ID da subconta.

Consulte o endpoint Salvar ou atualizar configuração da Conta Escrow para a subconta.

Resultado esperado

Uma resposta 200 OK confirma que a atualização da configuração foi aceita.

A partir da desabilitação:

• novas cobranças e parcelamentos deixam de entrar no fluxo da Conta Escrow;
• novos recebimentos passam a seguir o fluxo financeiro normal da subconta;
• todas as garantias existentes entram em processo de encerramento;
• os valores retidos são liberados para o saldo da subconta.

A liberação das garantias ocorre independentemente do período restante até expirationDate.

A irreversibilidade se aplica às garantias que foram encerradas: uma habilitação posterior da Conta Escrow não restaura essas garantias.

Desabilite para todas as subcontas

Utilize:

POST /v3/accounts/escrow

Ao definir enabled como false, a configuração padrão é aplicada às subcontas existentes e também será herdada pelas novas subcontas.

Como essa operação pode atualizar um grande número de subcontas, sua conclusão pode levar alguns instantes.

Consulte o endpoint Criar configuração padrão da Conta Escrow para todas as subcontas.

Como validar a configuração

Para confirmar a configuração de uma subconta:

GET /v3/accounts/{id}/escrow

Consulte o endpoint Recuperar configuração da Conta Escrow para a subconta.

Para confirmar a configuração padrão:

GET /v3/accounts/escrow

Consulte o endpoint Recuperar configuração padrão da Conta Escrow.

Use essas consultas para validação ou reconciliação da configuração, não como polling.

Próximos passos

• Consulte os valores sob garantia da Conta Escrow
• Entenda a liberação dos valores em garantia
• Configure novamente a Conta Escrow para as subcontas
• Consulte o endpoint de configuração da subconta