Skip to main content
Auto top-up keeps your purchased balance from running out. You choose a threshold and an amount, and whenever the balance falls below the threshold, Keenable charges your saved card that amount and adds the credits it buys. A monthly limit caps how much can be charged in one month. Auto top-up is off until you turn it on under Billing in the console.

Settings

A top-up buys credits at the same price as a purchase in the console, and the console shows how many requests each amount buys. Change the settings at any time while auto top-up is on: Edit, then Save.

Turn on auto top-up

The first time, the console sends you to Stripe to add a card. If your balance is already below the threshold, Stripe takes the first top-up in the same step. Otherwise, Stripe only saves the card. When you come back, auto top-up is on. Once a card is saved, turning auto top-up on or saving new settings takes effect at once. If your balance is already below the threshold when you turn auto top-up on or save new settings, Keenable charges your card straight away. The console says so above the button before you confirm.

When your card is charged

The threshold applies to your purchased balance, the dollar balance shown on the Billing page. The free monthly allowance doesn’t count toward it. Keenable uses free requests first. While you have some left, your purchased balance doesn’t go down and Keenable charges nothing. Every charge creates an invoice. An automatic top-up appears in the console’s invoice list, like any purchase. The monthly limit counts whole top-ups. Keenable charges a top-up only if all of it fits under what is left of the limit. Once the next top-up would go over, Keenable charges nothing more until the limit resets. The limit resets on the same day as the free allowance, and the console shows how much you’ve been charged this month and when the limit resets. If the balance and the allowance both run out before then, requests return 402, as described in Credits.

When a charge fails

If the card is declined, or the bank asks to confirm the payment (3-D Secure, which cannot happen while you are away), auto top-up turns off. Nothing is retried. The person who turned it on gets an email, and the Billing page shows Off · payment failed with the reason. To start again, check the card, or replace it with Manage payment methods at the top of the Billing page, then turn auto top-up back on. If your balance is below the threshold at that point, the first top-up is charged straight away. If a charge fails for a reason other than the card, such as an outage at Keenable or Stripe, auto top-up stays on and tries again the next time the balance is low.

Change the card or turn it off

While auto top-up is on, Change card opens Stripe to set a different card. Turn off stops all further charges at once. The credits already added stay on your balance and never expire. Automatic charges are covered by the Automatic Top-Ups section of the Terms of Service. Turning auto top-up on authorizes charges for exactly the amounts you set.