Pagamento imediato x Pagamento agendado

Ao criar um pagamento de conta, defina se a operação deve seguir para processamento no mesmo dia ou se precisa ser programada para uma data específica.

Utilize o endpoint POST /v3/bill nos dois casos. A diferença principal está no uso de scheduleDate.

Consulte a referência completa do endpoint Criar um pagamento de conta.

Pagamento no mesmo dia

Para solicitar o processamento sem programar uma data futura, envie a linha digitável em identificationField sem scheduleDate.

O processamento no mesmo dia depende do tipo e do valor do boleto e deve ser solicitado em dia útil dentro do horário aplicável.

Fora da janela aplicável, não considere o pagamento concluído no mesmo dia. Acompanhe o processamento da operação até o status conclusivo.

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Obter a linha digitável"] --> B["Criar pagamento sem scheduleDate"]
    B --> C{"Dentro da janela do mesmo dia?"}

    C --> CSim(("Sim"))
    C --> CNao(("Não"))

    CSim --> D["Processar no mesmo dia"]
    CNao --> E["Processar conforme próxima janela disponível"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef decisao fill:#FEF3C7,stroke:#D97706,color:#78350F,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

    classDef respostaSim fill:#22C55E,stroke:#15803D,color:#FFFFFF,stroke-width:3px
    classDef respostaNao fill:#EF4444,stroke:#B91C1C,color:#FFFFFF,stroke-width:3px

    class A inicio
    class B validacao
    class C decisao
    class D,E sucesso
    class CSim respostaSim
    class CNao respostaNao

    linkStyle default stroke:#94A3B8,stroke-width:2px
    linkStyle 2 stroke:#22C55E,stroke-width:4px
    linkStyle 3 stroke:#EF4444,stroke-width:4px

Exemplo

{
  "identificationField": "23793369089519200016448005645600411990000034130",
  "externalReference": "pedido-5463"
}

Pagamento agendado

Para definir a data do pagamento, informe scheduleDate no formato YYYY-MM-DD.

A data não pode ser anterior à data atual. A aceitação de um agendamento para o mesmo dia depende das regras do boleto e da janela operacional. Para boletos não vencidos, a data programada também deve respeitar o vencimento.

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Obter a linha digitável"] --> B["Definir scheduleDate"]
    B --> C["Criar o pagamento"]
    C --> D["Validar a data"]
    D --> E["Aguardar a data programada"]
    E --> F["Processar o pagamento"]

    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,E validacao
    class F sucesso

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

Exemplo

{
  "identificationField": "34191090570404959480975279260006611980000081488",
  "scheduleDate": "2025-09-11",
  "description": "Pagamento de fornecedor",
  "externalReference": "pedido-4870"
}

Como escolher o fluxo

Consulte Regras importantes para validar condições específicas do boleto antes de criar o pagamento.

Acompanhe o processamento

A criação ou o agendamento não confirma a conclusão do pagamento.

Utilize os Eventos para Pague Contas para receber as mudanças de estado automaticamente e atualizar sua operação.

Prefira Webhooks a consultas periódicas da API. Consulte Status possíveis para definir como tratar cada etapa do processamento.

Próximos passos

• Regras importantes
• Status possíveis
• Eventos para Pague Contas
• Erros e exceções comuns
• Testando no Sandbox