Scheduled invoices

Create invoices on a schedule

Invoices → Scheduled invoices creates payment links at a fixed 24-hour, 7-day or 30-day interval. Each buyer still approves payment in their wallet. No automatic wallet debit, subscription charge or product delivery is performed.

Each creation costs the normal invoice duration plus 1 automation credit: 2 credits for one hour, 3 for one day, 4 for five days. The normal success-fee reserve is additionally required. Saving a paused schedule is free; enabling it authorizes future credit spending.

PUT /invoice-schedules/{id}              # invoices:create
{"name":"Monthly service","template":{"amount":"25","expiresIn":86400},"intervalSeconds":2592000,"nextRunAt":1900000000,"enabled":false,"budgetCredits":30,"revision":0}
GET /invoice-schedules                  # invoices:read

Use a 16–64-character URL-safe ID. At most 25 schedules per workspace, 1000 runs per schedule and a lifetime budget of 1–100000 creation/automation credits. The recipient is always the workspace wallet. API times are Unix UTC; the UI displays local time. Updates require the returned revision. Identical retries of the last save return the same schedule; after a conflict, read it back before retrying.

Only one unpaid invoice is allowed per schedule. Low balance, budget exhaustion, an outstanding invoice, changed tariffs or creation failure pause it. Resume explicitly with a future run time and sufficient budget. Spent credits cannot be reset. Downtime never triggers a catch-up burst; the next run is calculated from the actual execution. Pausing leaves existing invoices intact.

The live signed webhook invoice.scheduled provides the generated invoice ID. Fetch it and distribute the payment link through your own channel. This event is not payment confirmation; only payment_intent.succeeded confirms a live payment.