Skip to main content
Auto top-up charges your saved card and adds prepaid credit when your API balance falls below a threshold you choose. The feature is off by default. An organization admin can open Developers, select Billing, then manage it from Auto top-up.

​
How it works

  1. Save a card from the billing page and make it your default payment method.
  2. Turn on Enable Auto top-up.
  3. Enter a balance threshold: the balance below which a top-up can run.
  4. Choose a top-up amount: $10, $25, $50, $100, or a custom amount from $10 to $5,000. The threshold must be lower than this amount.
  5. Check the monthly limit. It starts at three times the top-up amount, capped at $10,000. You can change it, but it must cover at least one top-up.
  6. Select Save Auto top-up to authorize automatic charges to your saved card.
Auto top-up is available for prepaid accounts. It always uses your organization’s billing card, including when you are viewing Sandbox in the dashboard.

​
Monthly spending and limits

This month shows the amount charged automatically against your monthly limit. The limit resets each UTC calendar month. A top-up that would exceed it is not charged. Manual top-ups do not count toward this limit. Balance checks run periodically, so a top-up is not instant. If your credit runs out before the top-up arrives, or after you reach the monthly limit, API requests stop until credit is available again. You can add credit manually from the billing page.

​
Emails you receive

Every active organization admin receives these notifications:
  1. Top-up receipt: amount, updated balance when available, card details, monthly total, and monthly limit
  2. Monthly limit reached: sent once per organization each month when another top-up would exceed the limit
  3. Auto top-up paused: explains what to do when the card is declined, requires authentication, or cannot be used
Stripe also emails a payment receipt for the card charge.

​
Pause and resume

A card problem pauses Auto top-up. The panel shows Paused and explains why. Nothing retries while paused. Update or replace the saved card, then save the settings again with Auto top-up enabled.

​
Turn it off

Turn off Enable Auto top-up, then select Save Auto top-up. Jinko keeps the saved settings for later. Turning it off does not refund earlier top-ups.