Regras importantes

Antes de criar um pagamento, valide as regras abaixo. Elas determinam quais campos enviar e quando o boleto pode ser processado.

Identificação do boleto

O campo identificationField é obrigatório e deve conter a linha digitável do boleto.

A partir dela, o Asaas identifica e valida as informações disponíveis no título, como emissor, tipo de conta, vencimento e valor.

Quando o próprio boleto não fornecer alguma informação necessária, utilize os campos adicionais previstos no endpoint.

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

Juros, multa e desconto

Envie interest, fine e discount somente quando forem aplicáveis ao pagamento.

Horários para compensação no mesmo dia

Em dias úteis, a compensação no mesmo dia depende do tipo e do valor do boleto:

Fora da janela aplicável, não considere que o pagamento será compensado no mesmo dia.

Para definir corretamente quando enviar scheduleDate, consulte Pagamento imediato x Pagamento agendado.

Boletos vencidos

O pagamento após o vencimento depende de o emissor permitir compensação pós-vencimento.

Quando o boleto vencido for aceito:

• não envie scheduleDate;
• solicite o pagamento no mesmo dia;
• respeite o horário operacional aplicável ao boleto.

Se scheduleDate for enviado para um boleto vencido, a requisição poderá ser recusada com a mensagem Contas vencidas não podem ser agendadas.

Acompanhe o processamento

A aceitação da requisição não confirma a conclusão do pagamento.

Utilize os Eventos para Pague Contas para acompanhar automaticamente as alterações de estado. Prefira Webhooks a consultas periódicas da API.

Quando ocorrer uma falha, trate o motivo retornado antes de realizar uma nova tentativa.

Próximos passos

• Pagamento imediato x Pagamento agendado
• Status possíveis
• Erros e exceções comuns — Pague Contas
• Eventos para Pague Contas
• Testando no Sandbox