Pagamento imediato x Pagamento agendado

Pagamento imediato

Se você não enviar o campo scheduleDate, o pagamento será processado no momento da requisição.

  • O boleto é enviado para compensação automaticamente;
  • Se o pedido for feito após as 18h, o pagamento será executado no próximo dia útil. Contas de consumo, imposto ou com o valor acima de 250 mil só poderão ser pagas até às 16h;
  • Se o boleto for pago em um sábado, domingo ou feriado, o sistema também agenda automaticamente para o próximo dia útil.

Exemplo

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

Pagamento agendado

Para programar um pagamento futuro, utilize o campo scheduleDate.

  • O agendamento deve ser feito com no mínimo +1 dia útil de antecedência;
  • Se for enviado scheduleDate igual à data atual, o sistema retornará erro;
  • O formato aceito é YYYY-MM-DD.

Exemplo

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

Atenção

Boletos vencidos não podem ser agendados. Caso envie uma linha digitável com data de vencimento anterior à data atual e informe um scheduleDate, o sistema retornará erro.