Disabling the Escrow Account

Disabling the Escrow Account stops the fund retention flow for a subaccount, causing new incoming payments to no longer go through the guarantee period.

This operation is recommended when the subaccount no longer needs to use the retention flow or when the platform wants new incoming payments to be automatically made available directly in the balance again.

When to use

Disabling the Escrow Account is recommended when:

• the subaccount will no longer use fund retention;
• the platform's financial flow no longer requires a guarantee period for incoming payments;
• it is necessary to permanently stop the retention of new charges for that subaccount.

If the intention is only to wait for the existing guarantees to be terminated, there is no need to disable the feature.

How to disable

To disable the Escrow Account, use the same subaccount configuration endpoint, changing only the enabled field to false.

POST /v3/accounts/{id}/escrow
See the complete endpoint reference

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

What happens after disabling

After the Escrow Account is disabled:

• new charges and installments no longer enter the retention flow;
• new incoming payments become normally available in the subaccount's balance;
• all existing guarantees are terminated;
• the amounts that were blocked become available in the subaccount.

These effects occur regardless of the remaining period configured for the guarantees to expire.

Best practices

Before disabling the Escrow Account, it is recommended to:

• verify that the immediate release of all guarantees complies with the platform's business rules;
• consider that this operation simultaneously affects all amounts still retained for the subaccount;
• update internal controls and financial reconciliation processes after the guarantees are released;
• avoid repeatedly disabling and re-enabling the feature while new charges are being processed.

If the platform only wants to monitor the natural expiration of the existing guarantees, it is recommended to keep the Escrow Account enabled until they are automatically terminated.