Introdução - Conta Escrow

A Conta Escrow permite reter temporariamente valores recebidos por uma subconta até o encerramento da garantia.

Enquanto a garantia estiver ativa, o recebimento existe, mas o valor não fica disponível no saldo da subconta. Após a liberação, o recurso passa a compor o saldo disponível.

Quando utilizar

Use a Conta Escrow quando sua plataforma precisar controlar quando um recebimento ficará disponível para a subconta, por exemplo:

• marketplaces que liberam o valor após a confirmação da entrega;
• plataformas que aguardam a conclusão de um serviço;
• operações com período de garantia;
• modelos White Label que controlam a disponibilização dos recursos das subcontas.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Configurar a Conta Escrow"] --> B["Receber cobrança ou parcelamento"]
    B --> C["Manter o valor sob garantia"]
    C --> D["Encerrar a garantia"]
    D --> E["Disponibilizar o valor no saldo"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

    class A inicio
    class B,C,D validacao
    class E sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

A garantia pode ser encerrada:

• automaticamente, após o período configurado;
• manualmente pela plataforma;
• ao desabilitar a Conta Escrow para a subconta.

Antes de utilizar

A Conta Escrow precisa estar disponível para sua conta.

Cada subconta que participará do fluxo deve possuir a funcionalidade habilitada. A configuração pode ser realizada individualmente ou definida como padrão para novas subcontas.

Regras que afetam a integração

• Somente cobranças e parcelamentos recebidos após a habilitação entram no fluxo da Conta Escrow. Recebimentos anteriores permanecem inalterados.
• O período de retenção é definido por daysToExpire.
• Um recebimento sob garantia deve ser considerado recebido, mas ainda indisponível no saldo da subconta.
• A liberação da garantia torna o valor disponível no saldo.
• Ao desabilitar a Conta Escrow, todas as garantias existentes da subconta são encerradas e os valores são liberados.
• Após a desabilitação, a Conta Escrow só poderá ser habilitada novamente quando todas as garantias em processo de liberação tiverem sido encerradas.

Para consultar valores retidos, a integração pode utilizar as informações do objeto escrow retornado nas cobranças ou os endpoints específicos da Conta Escrow.

Cobrança da funcionalidade

A Conta Escrow possui cobrança recorrente para as subcontas com a funcionalidade habilitada.

Durante a configuração, a plataforma pode definir se a mensalidade será debitada da conta principal ou da própria subconta.

Consulte Cobrança da taxa por subconta configurada para entender o ciclo de cobrança e o responsável pelo pagamento.

Próximos passos

• Configure a Conta Escrow para as subcontas
• Entenda a cobrança da taxa por subconta configurada
• Consulte os valores sob garantia
• Entenda como liberar valores em garantia
• Desabilite a Conta Escrow