Auto Top-up

Auto top-up automatically adds funds to your account when your balance falls below a set threshold, ensuring your calls and campaigns never stop unexpectedly.

How It Works

1. Your balance drops below the threshold you set
2. Auto top-up triggers immediately
3. Your saved card is charged for the refill amount
4. Balance is updated automatically

Setting Up Auto Top-up

Prerequisites

• [ ] Owner role (only Owners can configure)
• [ ] Valid payment method saved in Stripe
• [ ] Decide on threshold and refill amounts

Step-by-Step Setup

1. Go to Settings → Billing
2. Find the Auto-Fill section
3. Toggle Enable Auto Top-up
4. Configure:

Setting	Description	Recommended
Threshold	Balance level that triggers a refill	Enough to cover a few hours of usage
Refill Amount	How much to add when triggered ($10–$10,000)	Enough to cover a campaign or day's usage

5. Ensure a payment method is saved
6. Click Save Settings

Configuration Options

Threshold Amount

When your balance falls below this amount, auto top-up triggers.

Set the threshold high enough that you won't run out of balance between the trigger and when the payment completes.

Refill Amount

How much to add when triggered. Set this high enough to cover your typical usage between top-ups.

Payment Method

Manage your saved card:

1. Click Payment Methods in billing settings
2. Add or update your card via the Stripe portal
3. The same card is used for manual top-ups and auto top-ups

When Auto Top-up Triggers

Auto top-up activates when:

• Balance falls below your threshold, and
• Auto top-up is enabled, and
• A valid payment method exists

An idempotency check prevents duplicate charges if the balance drops and recovers rapidly.

Managing Auto Top-up

Viewing Status

In billing settings, see:

• Current status (enabled/disabled)
• Current threshold and refill amounts

Changing Settings

1. Go to Settings → Billing
2. Modify the threshold or refill amount in the Auto-Fill section
3. Click Save Settings
4. Changes take effect immediately

Disabling Auto Top-up

1. Go to Settings → Billing
2. Toggle off Enable Auto Top-up
3. Manual top-ups are still available at any time

Troubleshooting

Auto Top-up Not Triggering

Issue	Solution
Not enabled	Enable in settings
No payment method saved	Add a card via payment methods
Balance still above threshold	Working as expected

Card Declined

If your card is declined:

1. Check the card is valid and not expired
2. Ensure sufficient funds on the card
3. Try a different card
4. Contact your bank if persistent

Wrong Amount Charged

Verify your settings:

1. Check the refill amount in settings
2. Review recent transactions
3. Contact support if there is a discrepancy

Best Practices

For Campaigns

Before running a bulk campaign:

1. Enable auto top-up as a safety net
2. Set the threshold above your expected hourly spend
3. Set a sufficient refill amount to cover multiple hours
4. Also add manual funds so you start with a comfortable buffer

Recommended Settings

Scenario	Threshold	Refill
Just testing	$10	$25
Small team	$25	$50
Growing team	$50	$100
Heavy usage	$100	$200

Monitoring

Even with auto top-up enabled:

• Check your balance and transaction history regularly
• Watch for failed charge notifications
• Adjust settings as your usage grows

Security

Card Security

• Card details are stored securely by Stripe
• Voxifi never sees your full card number
• PCI-compliant payment processing

Next Steps

• Prepaid Balance - Manual balance management
• Usage Tracking - Monitor your spending
• Invoices - Access payment receipts