Prepaid credits increase predictability as they allow you to collect payments in advance and then monitor the evolution of the balance of your customer’s wallets.

​
Create wallets

To create a wallet for one of your customers through the user interface:
  1. Access the “Customers” section via the side menu;
  2. Select a customer from the list;
  3. Open the “Wallets” and click “Add a wallet & credits” on the right;
  4. Choose a name for the wallet (optional);
  5. Set the credit value (e.g. 1 credit = $5);
  6. Enter the number of credits to be purchased and/or granted for free;
  7. Define transaction metadata (optional & available only via API);
  8. Determine whether the wallet transaction generates an invoice after a top-up or only following a successful payment;
  9. Set the expiration date (optional); and
  10. Click “Add wallet & credits” to confirm.
If the currency of the customer is already defined, the currency of the wallet must be the same.
Creation of a wallet via the user interface Free credits are added to the customer’s wallet instantly, while purchased credits are added to the wallet when payment is confirmed (see below). Each customer can only have one active wallet.

​
Real time wallet balance

PREMIUM FEATURE ✨This feature is only available to users with a premium license. Please contact us to get access to Lago Cloud and Lago Self-Hosted Premium.
Keep track of your wallet’s real-time balance. Lago provides two types of balances for your wallet:
  1. Balance: invoiced balance, which reflects the remaining prepaid credits in your wallet. It updates each time an invoice is finalized for the customer.
  2. Ongoing Balance: balance accounted for current usage, including taxes and draft invoices offering a real-time estimate of your balance’s consumption. It refreshes every 5 minutes or upon the finalization of an invoice for the customer.

​
Application scope

Prepaid credits settled in a wallet are applied to upcoming subscription invoices. They are deducted from the post-tax subtotal, after any credit notes have been applied. 
## EXAMPLE OF INVOICE

All subscriptions fee    $50.00
All usage-based fees     $20.00
Coupons                 -$10.00
-------------------------------
Subtotal (excl. tax)     $60.00
Tax (10%)                $ 6.00
-------------------------------
Subtotal (incl. tax)     $66.00
Credit notes             $20.00
Prepaid credits          $30.00
-------------------------------
Total                    $16.00
Prepaid credits do not apply to one-off invoices.
By default, prepaid credits apply to all fee types—subscriptions, charges, and commitments. You can refine this behavior by configuring limitation rules directly in the wallet.
To limit the scope of prepaid credits through the user interface:
  1. Create or edit an existing wallet;
  2. In the “Limit wallet credits to specific object” section, add one or more object limitations;
  3. You can also limit wallet prepaid credits to specific billable metrics; and
  4. Keep in mind: selecting all items has the same effect as selecting none. For this reason, we recommend leaving all options unselected unless a specific restriction is needed.

Limit wallet prepaid credits to specific objects

​
Invoicing after successful payment option

When enabled, this option delays issuing an invoice for a wallet top-up until a successful payment is made. If disabled, the invoice is issued immediately upon the wallet top-up, regardless of the payment status. This setting applies to all transactions for the wallet, but can be overridden for individual transactions or recurring rules.

​
Expiration date and termination

By default, if you don’t set an expiration date, prepaid credits are carried over to the next billing period until the wallet balance is zero. If you define an expiration date, when the date is reached, all remaining credits are automatically voided. To modify the expiration date of the prepaid credits through the user interface:
  1. Open the “Wallets” tab and click “Edit wallet” on the right;
  2. Select “Edit information”;
  3. Modify the expiration date; and
  4. Click “Edit information” to confirm.
The expiration date displayed in the app is based on the organization’s timezone. You also have the ability to terminate a wallet manually, before its expiration date:
  1. Open the “Wallets” tab and click “Edit wallet” on the right;
  2. Select “Terminate wallet”; and
  3. Click again to confirm.
Terminating a wallet will instantly void all remaining credits. This action cannot be undone.