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
- 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.
You can also do this from a campaign: open Edit on a destination. Under Payout, next to the price, you see Billing Mode (Wallet, or Lead Count where you bill the destination yourself) and Wallet Balance: the balance, about how many leads (or appointments) it covers at the current price, and Add funds. When a card is on file, a line below says how auto-recharge is set, with an Edit link to the destination's page. Changing the billing mode there changes it on every campaign that destination is on.
Where the wallet lives: Destinations, open the destination, Overview tab, Wallet & Billing card. Actions there holds Add Credit. It is not under Settings, Billing, which is your own Lead Distro AI subscription. The AI assistant can read a destination's balance and wallet history with get_destination_wallet. Inside the app it can also add credit you ask for: it shows the destination, the amount and the balance before and after, and adds it only when a teammate with Billing permission approves. That records credit you are granting and charges no card. An AI tool connected from outside (MCP or an API key) can read the wallet but cannot add credit.
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. |
| Manual billing mode | Custom invoicing flows outside Stripe. See Manual Billing 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?
Lead Distro AI wallet top-up — Buyer XYZ). One-click receipts are available from the wallet transaction detail page. Useful for accounting reconciliation between Lead Distro AI's ledger and Stripe's transaction history.Can I refund a wallet top-up?
Related Articles
If you have any questions, send us an email at support@leaddistro.ai