Business OS · Documentação

#Pagamento vencido ou esquecido

São dois casos diferentes, com eventos diferentes.

#Caso 1: Pix ou boleto que a pessoa gerou e não pagou

Sequência normal de uma venda não paga:

  1. payment.pending: o Pix ou boleto foi gerado. Serve de lembrete, com o copia-e-cola em data.object.pix.code ou a linha do boleto em billet.line e billet.url, e a validade em pix.expires_at / billet.expires_at.
  2. payment.expired: venceu sem pagar. Fim do lembrete.

O que fazer:

Fluxo de decisão:

async function onPending(evt) {
  const key = evt.delivery.sale_key;
  if (await wasApproved(key)) return;     // já pagou, não cobre
  await scheduleReminder(key, evt.data.object.pix?.expires_at);
}
async function onExpired(evt) {
  await cancelReminders(evt.delivery.sale_key);
  await offerNewPayment(evt.data.object.customer.email);
}
async function onApproved(evt) {
  await cancelReminders(evt.delivery.sale_key); // aprovado cancela qualquer lembrete
}

Observações por plataforma:

#Caso 2: cobrança de assinatura que atrasou

subscription.past_due avisa que a cobrança de uma assinatura da plataforma está em atraso. Traz o link da fatura em invoice_payment_url (quando a plataforma manda), para uma régua de cobrança.

Não tire o acesso aqui. O Business OS dá a tolerância do plano (grace_days) antes de encerrar. Quem decide o fim é o access.ended (com end_reason: "not_renewed") ou, no fluxo de pagamentos, o subscription.ended (só a Guru gera).

Se a pessoa pagar durante a tolerância, vem payment.approved e, no fluxo de acesso, access.renewed: o acesso continua, sem ter sido interrompido.

#Porém


← Tirar acesso no reembolso ou chargeback  ·  Renovação →