A wallet cannot have a negative balance.
Hyperline debits a wallet when it pays an invoice, not each time your customer uses your product. To deduct usage from a prepaid balance as it occurs, use credits.
Wallet settings
Configured at the account level (in the Settings > Wallets page), these settings apply to all customer wallets. By default, the wallet feature is disabled. To activate it, navigate to your settings.
Default wallet name
This name applies to all new wallets. You can still rename a wallet afterwards.Free top-up
This option allows you to add funds directly to your customers’ wallets at no additional cost. When you add free funds to the wallet, Hyperline generates a corresponding credit note for accounting purposes.Top-up from customer portal
This option allows your customers to add funds directly through their portal. Customers need an active credit card as their payment method for the top-up to succeed. See From the customer portal for the steps and limits.
Eligible products
You can select the products to which you want the wallets to apply when paying invoices. By default, the wallets apply to all products (i.e., the full invoice amount).Create a wallet for a customer
Now that you have enabled wallets on the settings page, you can create wallets for your customers in Hyperline. To do this, go to the Customers page in Hyperline’s main menu. Navigate to the Wallet tab and click Create wallet.Manage wallet
You can edit the configuration of a customer wallet. Go to a customer page > Wallet tab > Actions > Edit wallet.
Update name
You can update the wallet name. Use this name to identify the wallet depending on your use case. This name appears on the final invoice when the wallet is used as a payment method to pay the invoice.Auto top-up
You can top up a customer’s wallet automatically. Turn on Enable auto top-up, then configure:- Type: Paid for funds your customer pays for, or Free for free funds. Like a free top-up, a free auto top-up generates a credit note.
- Amount: the amount added at each top-up.
- Triggers: choose one or both:
- At a regular interval: set the interval and the date of the next top-up.
- When projected balance reaches a threshold: Hyperline tops up the wallet when its projected balance falls below the threshold.

Pause wallet
You can pause the use of a wallet for a specific customer. Go to a customer page > Wallet tab > Actions > Pause wallet consumption. Hyperline no longer uses a paused wallet to pay future invoices and charges the customer’s active payment method instead. You can reactivate the wallet at any time.Managing zero balances
If you allow your customers to top up their wallets, consider a flow to warn them before their wallet balance reaches 0. This is especially relevant if reaching a zero balance interrupts their services. To be warned early, set a Low projected balance notification threshold when you edit the wallet. Hyperline sends thewallet.low_projected_balance webhook when the projected balance falls below this threshold.
You can use our webhooks to monitor wallet activity.
