Pro-rated wallet credits are not supported

Lago doesn't currently support pro-rating wallet credit grants. When a wallet top-up is triggered, whether manually, on a recurring interval, or by a threshold, the full configured credit amount is granted regardless of where the customer is in their billing cycle. There's no automatic calculation to reduce the granted credits proportionally based on remaining days in the period.

What to do

Pro-ration has to be handled in your application layer. One option is to calculate and issue a manual top-up: determine the days remaining in the billing period, calculate the prorated credit amount, and issue a top-up for only that quantity via POST /api/v1/wallet_transactions. The other is to set the grant dynamically at subscription creation, adjusting the wallet's rate_amount and credit grant quantity at creation time based on the days remaining in the period.

The Lago product team is tracking a wallet allocation initiative to address this limitation natively.

This article reflects guidance drawn from customer case resolutions. It is not officially supported documentation and may not apply to all situations.