Updating Wallet Balances
Every Wallet Asset Line Item (WALI) has two fields showing the balance - Total Balance (Wallet), and Available Balance (Wallet).
- Total Balance (Wallet): The total balance reflects the total amount added to the wallet.
- Available Balance (Wallet): Available balance reflects the amount available for consumption in the wallet.
The wallet balance is updated either as soon as the WALI is created, or after the billing schedules are invoiced, as shown in the following scenarios:
Scenario 1: Existing functionality
The wallet's total and available balances are updated as soon as the wallet asset is created.
Suppose you have created a wallet with the following details:
|
Asset Name |
Start Date |
End Date |
Selling/Billing Frequency |
Selling Term |
Quantity |
Charge Type |
Price Type |
TCV |
Net Unit Price |
|---|---|---|---|---|---|---|---|---|---|
|
Wallet |
01 Apr 2024 |
31 Mar 2028 |
Yearly |
4.00 |
1.00 |
Standard Price |
Recurring |
USD 40,000.00 |
USD 10000.00 |
When billing is initiated, four billing schedules are created in a Pending Billing status.
|
Billing Schedule ID |
Period Start Date |
Period End Date |
Fee Amount |
Type |
Status |
|---|---|---|---|---|---|
|
BS-001 |
01 Apr 2024 |
31 Mar 2025 |
USD 10,000.00 |
Contracted |
Pending Billing |
|
BS-002 |
01 Apr 2025 |
31 Mar 2026 |
USD 10,000.00 |
Contracted |
Pending Billing |
|
BS-003 |
01 Apr 2026 |
31 Mar 2027 |
USD 10,000.00 |
Contracted |
Pending Billing |
|
BS-004 |
01 Apr 2027 |
31 Mar 2028 |
USD 10,000.00 |
Contracted |
Pending Billing |
After Wallet creation, the WALI page displays the balance as:
- Total Balance (Wallet) = USD 40,000.00 and
- Available Balance (Wallet) = USD 40,000.00
This demonstrates the existing functionality, which states that when a wallet is created, the wallet’s available balance is equal to WALI TCV.
Scenario 2: Additional functionality (available from Feb'24)
The custom setting, Wallet’s Balance based on its invoicing = True
When this setting is enabled, the wallet balance is updated only when the billing schedules of that WALI (Wallet Asset Line Item) are marked as Invoiced. The Total Balance field of the WALI is updated based on the fee amount of the invoiced billing schedules.
Considering the example from scenario 1, when billing is initiated, four billing schedules are created in a Pending Billing status.
|
Billing Schedule ID |
Period Start Date |
Period End Date |
Fee Amount |
Type |
Status |
|---|---|---|---|---|---|
|
BS-001 |
01 Apr 2024 |
31 Mar 2025 |
USD 10,000.00 |
Contracted |
Pending Billing |
|
BS-002 |
01 Apr 2025 |
31 Mar 2026 |
USD 10,000.00 |
Contracted |
Pending Billing |
|
BS-003 |
01 Apr 2026 |
31 Mar 2027 |
USD 10,000.00 |
Contracted |
Pending Billing |
|
BS-004 |
01 Apr 2027 |
31 Mar 2028 |
USD 10,000.00 |
Contracted |
Pending Billing |
Even after the wallet is created, the WALI page displays the balance as:
- Total Balance (Wallet) = USD 0.00 and
- Available Balance (Wallet) = USD 0.00
After invoicing the first two billing schedules:
|
Billing Schedule ID |
Period Start Date |
Period End Date |
Fee Amount |
Type |
Status |
|---|---|---|---|---|---|
|
BS-001 |
01 Apr 2024 |
31 Mar 2025 |
USD 10,000.00 |
Contracted |
Invoiced |
|
BS-002 |
01 Apr 2025 |
31 Mar 2026 |
USD 10,000.00 |
Contracted |
Invoiced |
|
BS-003 |
01 Apr 2026 |
31 Mar 2027 |
USD 10,000.00 |
Contracted |
Pending Billing |
|
BS-004 |
01 Apr 2027 |
31 Mar 2028 |
USD 10,000.00 |
Contracted |
Pending Billing |
The WALI page displays the balance as:
- Total Balance (Wallet) = USD 20,000.00 and
- Available Balance (Wallet) = USD 20,000.00
This is in accordance with the new functionality which states that the Wallet balance is updated only when the billing schedules are invoiced and the Total Balance is equal to the fee amount of the invoiced billing schedules.
