Regras importantes

  • O campo linhaDigitavel (identificationField) é obrigatório e identifica o boleto a ser pago.

  • O Asaas valida automaticamente os demais dados (banco emissor, convênio, tipo de conta, valor original, etc.) conforme as informações disponíveis no boleto e no emissor parceiro.

  • Não envie campos como interest, fine ou discount se não forem aplicáveis — e nunca envie discount em contas de consumo ou impostos (o sistema rejeita).

  • O horário-limite para pagamentos imediatos é dinâmico e depende do tipo e valor do boleto:

    • Para boletos comuns, o limite costuma ser próximo das 18h em dias úteis;
    • Para contas de consumo, impostos ou valores acima de R$ 250 mil, o limite é até 16h;
    • Após o horário-limite, a compensação ocorre no próximo dia útil.
  • Boletos vencidos só podem ser pagos se o emissor permitir compensação pós-vencimento. Nesse caso:

    • O scheduleDate deve ser igual à data atual (não é permitido agendar para ontem ou amanhã);
    • O pagamento precisa ocorrer dentro do horário-limite do dia.