Skip to main content

Account Suspension

Delinquent accounts are automatically suspended when the grace period is exceeded.

Suspension Worker

Runs daily at 02:00 UTC and:

  1. Synchronizes the status of delinquent accounts
  2. Gets the gracePeriodDays from the dunning configuration (default: 3 days)
  3. Finds delinquent accounts with:
    • Stage warning or final
    • Oldest overdue date > grace period
    • Not yet suspended
    • Not recovered
  4. For each account:
    • Changes the billing account status to suspended
    • Updates the delinquency stage to suspended
    • Pauses all active subscriptions
    • Sends a suspension notification

Suspension Effects

  • Billing account status: suspended
  • All active subscriptions are automatically paused
  • The suspension reason is recorded (e.g., "Delinquency for X+ days")
  • Notification sent to the account holder

Suspension Notification

Type: account_suspended

Available variables:

  • Organization name
  • Total overdue amount
  • Suspension date

Reactivation

Reactivation is done manually after payment is settled:

  1. Operator accesses the billing account
  2. Clicks "Reactivate"
  3. Status returns to active
  4. Suspension fields are cleared
  5. Paused subscriptions can be resumed individually