dunning

Turn on a dunning retry ladder.

Source: packages/paykit/src/Subscription/Dunning.policy.ts Kind: Layer

Turn on a dunning retry ladder. Without this layer the policy still owns grace and expiry, but it never charges a saved method; the vendor’s own retries are the only attempts, exactly as before.

Each entry is measured from the first failure of the run, not from the preceding attempt, so a late policy run does not move the rest of the ladder. A retry at or after the standing’s graceUntil is not scheduled: the grace deadline remains the hard stop. The retry is made against the account’s saved method through Payments.charge and is keyed by the run and the attempt, so a redelivered policy run is the charge it already took. A deployment that turns this on should turn the vendor’s own dunning off, or both schedules will attempt the same collection.

Retrying a declined card three times

const layer = Paykit.ModelHandlers.pipe(
  Layer.provideMerge(Paykit.paymentsRouter(provider)),
  Layer.provideMerge(
    Paykit.dunning({
      retries: [Duration.days(1), Duration.days(3), Duration.days(7)],
    }).pipe(Layer.orDie),
  ),
);