Skip to main content

Automatic top-up

PUT 
/api/v3/billing/auto-topup

Owner/admin: automatic top-up. When prepaid credit drops below below_usd, a one-time charge of amount_usd (plus tax) on the subscription's card buys more; the credit lands with Paddle's webhook, and no second top-up is sent before it does. Saving it while credit is already below below_usd sends the first top-up at once, on the queue: the answer shows it as pending at most, so poll GET /billing for the outcome (credit landed, enabled: false with error when declined, pending_usd with error when unconfirmed). A declined card turns it off and notifies the account. Saving clears the last error/paused, unless a top-up is still pending. below_usd: null turns it off. An approved refund or chargeback turns it off too. GET /billing returns the state as auto_topup { enabled, below_usd, amount_usd, pending_usd, last_at, error, paused: { action: refund | chargeback, invoice } | null, available }

Request​

Responses​

Same as GET /billing