Wallet & Top-Ups
Pre-fund Lead Distro AI buyer accounts with the wallet model. Top up via Stripe, configure auto top-up, handle payment failures, and FAQs.
What is the Wallet?
The wallet is a pre-funded balance held per buyer. Each lead delivered to that buyer draws down the wallet. When the wallet runs low, you can top up via Stripe, set up auto-top-up, or fall back to the card on file. Useful for agencies that want clients to fund their lead spend upfront rather than billing after the fact.
When to Use the Wallet
- Prepay agencies — clients fund a balance upfront, you bill against it as leads deliver
- Multi-buyer accounts — top up one wallet for the account, fund all buyers from a shared balance
- Pay-as-you-go — buyers add credit when they need volume, no monthly invoicing required
- Risk management — prepaid means you never deliver leads on credit that doesn't exist
Adding Credit
- Open the buyer detail page.
- Click Add Credit.
- Enter the amount — Stripe charge runs against the card on file (configurable).
- Choose: wallet-only top-up, OR top up + charge buyer (their card on file is charged, not yours).
- Confirm. The wallet balance updates immediately on successful charge.
Wallet vs Direct Card Charge
| Mechanism | Best for |
|---|---|
| Wallet (prepay) | Clients who prefer fixed upfront commitments. Predictable spend, no surprise bills. |
| Direct card charge per lead | Clients who want pay-as-you-go without funding a balance. Higher Stripe fees per transaction. |
| Net terms (postpay) | Established clients with credit. Lead delivery now, invoice settled later. [See Net Terms](/docs/billing-net-terms). |
| Manual billing mode | Custom invoicing flows outside Stripe. [See Manual Billing Mode](/docs/billing-manual-mode). |
Payment Failure Policies
Configure per-buyer behavior when a wallet top-up or card charge fails: pause lead delivery until resolved, or continue delivering and queue the failed charge for retry. Default is pause — protects against silently delivering leads that can't be paid for.
Smarter billing safety nets (May 2026 release) flag suspicious charge patterns and silent failures earlier — reducing the chance of delivery continuing against a card with stale info. Configure in Settings → Billing → Safety Nets.
Frequently Asked Questions
How is Lead Distro AI's wallet different from a regular subscription?
Can I set up auto-top-up?
What happens when a buyer's wallet runs to zero?
Can I charge a buyer's card directly without touching the wallet?
Do wallet top-ups show on Stripe invoices?
Can I refund a wallet top-up?
Related Articles
If you have any questions, send us an email at support@leaddistro.ai