Top up credits automatically

If you run a lot of checks, you can otherwise run out of credits in the middle of the month, and a running check stops at that point. The automatic top-up prevents this: when your balance falls below a threshold you set, Rankion buys a credit package and credits it to your account immediately. You pay by invoice.

Where to set it up

At rankion.ai/billing in the Automatic top-up section. You only see the section if payment by invoice is available for your team and you are allowed to edit your team's billing. The top-up stays switched off until you switch it on yourself.

Three fields define how it works:

Tick Switch on automatic top-up and click Save. The confirmation appears right next to the button.

Requirements

• Complete billing details under /settings/billing-data: company, address, postcode, city, country. If they are missing, the section shows a notice with the link Add billing details.
• A German VAT ID. For now, only businesses with a German VAT ID can switch on the automatic top-up. Support for businesses from other EU countries will follow later. If you later remove the VAT ID from your billing details, no further top-ups are made.
• Your consent when switching it on. The first time you switch it on, a checkbox with this text appears: »I expressly agree that automatically purchased credits are made available immediately after purchase, and I acknowledge that I thereby lose my right of withdrawal for the respective purchase.« Without ticking it, the top-up cannot be switched on. If you later only change the threshold, package or limit, you are not asked again.

When a purchase is made

The top-up is triggered at the moment a charge pushes your balance below the threshold.

• One purchase per drop below the threshold. If your balance is still below the threshold after the purchase, the next top-up only happens once it has been above the threshold again. This happens, for example, when the package is smaller than the gap to the threshold.
• Monthly limit. Counting is per calendar month in German time. When the limit is reached, you get an email and a notice in the bell, once per month. In the following month it continues on its own.
• Pause when a top-up invoice is overdue. As long as an invoice from an automatic top-up is overdue, the top-up is paused. You get one email about this per invoice. As soon as the invoice is recorded as paid, the top-up resumes with the next charge below the threshold. Other open invoices do not pause it.

What you get after a purchase

• The credits are available immediately, not only after payment is received.
• A real invoice from our accounting software Lexware Office, sent by email to your billing address. The amount is the package price from the price list, the same amount as when buying by card. You pay by bank transfer. Every top-up invoice carries the waiver text from above.
• A notice in the bell with the credits, invoice number and amount.

If a purchase fails, nothing is charged and nothing is credited. You get an email about it.

History

Below the form you will find Recent automatic top-ups: for each purchase the date, time and credits, plus the status.

Over the API

GET /v1/billing/auto-topup shows the setting, PUT /v1/billing/auto-topup changes it, GET /v1/billing/auto-topup/purchases lists the purchases (filter status, pages with page and per_page). If the VAT ID is missing, PUT responds with vat_id_missing; with a VAT ID from another country, with vat_id_not_german.

Read more

• [[modules/billing]]: payment method, invoice documents and your right of withdrawal
• Credits & Rate Limits: balance and usage over the API