Configurando a Conta Escrow para as subcontas

Utilize a API para realizar as configurações da Conta Escrow para as subcontas. Isso pode ser feito configurando individualmente uma subconta ou criando uma configuração padrão que será aplicada para todas as subcontas.

Após habilitar a Conta Escrow para uma subconta, todas as novas cobranças e parcelamentos recebidos por ela passarão a seguir o fluxo de retenção de valores durante o período configurado.

Pré-requisitos

Antes de configurar a Conta Escrow para uma subconta, verifique se:

• a funcionalidade Conta Escrow está disponível para sua conta;
• a subconta já foi criada no Asaas;
• você possui o identificador (id) da subconta que será configurada.

Caso a Conta Escrow não esteja disponível para sua conta, não será possível habilitar a funcionalidade para as subcontas.

Configurando uma subconta

POST /v3/accounts/{id}/escrow
Confira a referência completa deste endpoint

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

Configurações disponíveis

Os campos possuem as seguintes finalidades:

enabled — Define se a Conta Escrow ficará habilitada para a subconta.

Quando definido como true, os novos recebimentos passam a seguir o fluxo de retenção de valores.

Quando definido como false, novas cobranças deixam de entrar no fluxo da Conta Escrow.

isFeePayer — Define quem será responsável pelo pagamento da mensalidade da Conta Escrow.

• true: a mensalidade será debitada da própria subconta.
• false (ou campo não informado): a cobrança será realizada na conta principal.

daysToExpire — Define por quantos dias os valores permanecerão bloqueados antes da liberação automática.

Durante esse período, os valores permanecem sob garantia e não ficam disponíveis no saldo da subconta.

Configuração padrão para todas as subcontas

Também é possível criar uma configuração padrão para que novas subcontas utilizem automaticamente as mesmas definições de:

• habilitação da Conta Escrow;
• responsável pelo pagamento da mensalidade;
• período de retenção (daysToExpire).

Caso deseje replicar automaticamente essas configurações para todas as subcontas existentes, entre em contato com o suporte do Asaas.

Boas práticas

Antes de habilitar a Conta Escrow para uma subconta, recomenda-se:

• validar se a subconta realmente deve utilizar retenção de valores;
• definir cuidadosamente o período de retenção (daysToExpire), pois ele impacta diretamente quando o saldo ficará disponível;
• configurar quem será responsável pelo pagamento da mensalidade da funcionalidade;
• realizar testes em ambiente Sandbox antes de habilitar a funcionalidade em Produção.

Esses cuidados ajudam a evitar impactos inesperados no fluxo financeiro das subcontas.