Introdução

O que é o Pague Contas

O Pague Contas permite realizar pagamentos de boletos diretamente pela API do Asaas a partir da linha digitável do título.

Ao enviar a linha digitável, o sistema interpreta automaticamente as informações do boleto, como valor, vencimento e emissor, eliminando a necessidade de envio manual desses dados.

Essa abordagem simplifica a integração e reduz a possibilidade de inconsistências durante o processamento.

Como funciona na prática

O fluxo de pagamento é baseado em uma única requisição, onde você informa os dados necessários para identificar o boleto e, opcionalmente, define quando o pagamento deve ocorrer.

De forma geral:

• A linha digitável é enviada no campo identificationField
• O Asaas valida e interpreta os dados do boleto automaticamente
• O pagamento é processado imediatamente ou agendado
• O status pode ser acompanhado via API e webhooks

Esse fluxo permite automatizar pagamentos de forma simples, sem necessidade de múltiplas etapas ou conciliações manuais.

Pagamento imediato ou agendado

O comportamento do pagamento depende do envio (ou não) do campo scheduleDate:

• Sem scheduleDate: o pagamento é processado imediatamente (respeitando regras de horário e dias úteis)
• Com scheduleDate: o pagamento é agendado para a data informada

As regras completas de agendamento, horários e limitações são detalhadas na próxima seção.

Acompanhamento do pagamento

Após a criação, o pagamento passa por diferentes etapas até sua conclusão.

Você pode acompanhar esse processo de duas formas:

• Consultando o endpoint de pagamentos (/v3/bill)
• Recebendo atualizações automáticas via webhooks

O uso de webhooks é altamente recomendado para garantir que seu sistema reaja rapidamente a mudanças de status.

O que considerar antes de implementar

Antes de iniciar a integração, é importante considerar:

• O comportamento pode variar conforme o tipo de boleto (comum, consumo, imposto, vencido, etc.)
• Existem regras específicas para horários e dias de processamento
• Alguns cenários podem exigir tratamento de erros ou reprocessamento
• O ambiente Sandbox simula o fluxo, mas não realiza compensação real

Esses pontos são detalhados nas próximas páginas para garantir uma implementação segura e consistente.

Próximo passo

Agora que você já entende o funcionamento geral, siga para:

➡️ Pagamento imediato x Pagamento agendado

Nessa etapa, você verá as diferenças práticas entre os dois tipos de processamento, incluindo regras, exemplos e limitações.