Prepaid CreditsDrawdown and GST

Drawdown and GST

Drawdown is the step where the wallet pays for an invoice. It happens when an invoice is created: a renewal, a boundary invoice, a plan change or the final bill.

How a drawdown works

  1. The invoice lines are rated as usual. Each line keeps its component.
  2. The eligible amount is the pre-tax sum of the lines whose component is ticked Paid from credits. Pass-through lines are eligible if their component is ticked.
  3. Drawn = the smaller of the eligible amount and the wallet balance.
  4. The drawn amount is spread across the eligible lines in line order: the first eligible line is filled up to its pre-tax amount, then the next.
  5. One drawdown is recorded for each wallet entry that was used. The invoice’s balance goes down by the amount drawn, and the invoice is marked Paid when its balance reaches 0.

Amounts are worked out in whole paise. The last covered line takes the rounding remainder.

The order credits are spent in

Credits are spent oldest expiry first. Entries that never expire come last. Ties are broken by the entry’s effective date.

In practice a customer’s free and bonus credits (which can expire) are used before the credits they paid for (which never expire). An entry that expires before the invoice date is not used.

GST rules

GST is charged once, on the top-up invoice. A drawdown is not taxed again.

WhatGST
The top-up invoiceTaxed like any normal line, based on the price’s tax-inclusive setting and the customer’s GST state. The top-up line uses the rate plan price’s tax settings.
Bonus, grants and adjustmentsNo GST. They are not a tax document and carry no credit note number.
A line fully covered by creditsNo GST at all
A line partly coveredGST only on the uncovered part
Lines not paid from creditsNormal GST on their full amount

A covered line carries no GST even when its own tax profile has a different rate from the top-up. GST is still worked out per line, on the line’s taxable base: the line amount minus what credits paid.

The order’s amount due

The order’s amount due goes down by the credits drawn plus the GST those credits remove. A renewal that credits pay in full is marked Payment Received at once, with nothing to collect.

On an invoice that has GST, the header subtotal stays the same for covered tax-inclusive invoices, so subtotal plus tax still equals the total.

How it appears on the invoice and PDF

  • Each covered line shows Paid from credits ₹X under it.
  • A summary row shows Credits used ₹X · balance after ₹Y.
  • On a Tax Invoice with GST the covered line’s total adds the credits back, so the line total is still the full line value. The balance due shows what is left to pay.
  • The invoice preview in the portal shows the same rows.
⚠️

Your own custom PDF templates do not print the credit rows yet. The standard template does. The amounts on the invoice are correct either way.

Example invoice, a month fully paid from credits (Scale plan, balance ₹105):

LineAmountPaid from creditsGST
Phone numbers (3)₹4.50₹4.50₹0.00
Minutes (600)₹30.00₹30.00₹0.00
AI₹12.00₹12.00₹0.00
SMS (2,000)₹16.60₹16.60₹0.00
Campaign₹15.00₹15.00₹0.00
Invoice total₹78.10
Credits used ₹78.10 · balance after ₹26.90
Balance due₹0.00

Worked examples (acceptance checks)

All with GST at 18% exclusive.

CaseSetupResult
Partial cover, bill the overageBalance ₹20, eligible ₹50₹20 is drawn and spread over the lines in order. The remaining ₹30 is taxed: ₹5.40 GST. Invoice balance ₹35.40.
A base fee that does not drawPlan fee ₹29 (not paid from credits) plus usage ₹10, balance ₹105₹10 is drawn from credits. ₹29 plus ₹5.22 GST is invoiced: ₹34.22.
Ordinary credits unaffectedA cancellation credit of ₹50 and a wallet of ₹105 on one account, a renewal of ₹40 that does not drawThe cancellation credit pays the ₹40, as before. The wallet stays ₹105. A refund after a cancel never includes wallet credit.

Partial cover in detail. Eligible lines: Usage A ₹30 and Usage B ₹20. Balance ₹20.

LineAmountPaid from creditsTaxable baseGST 18%
Usage A₹30.00₹20.00₹10.00₹1.80
Usage B₹20.00₹0.00₹20.00₹3.60
Total₹50.00₹20.00₹30.00₹5.40

Amount due: ₹30.00 + ₹5.40 = ₹35.40.

Drawdown is safe to retry

Before drawing, the step reads the drawdowns already recorded for the invoice and draws only the difference, and a marker on the order says it was done. A retry never spends credits twice.

Discounts

  • On an invoice without GST, a discount is spread pro-rata over the lines before the drawdown.
  • On an invoice with GST, the drawdown uses each line’s discounted taxable value.

Plan changes, voids and the final bill

  • Plan change. Usage from the old plan still draws from the wallet, even if the new plan has no wallet.
  • Voided or replaced invoice. The credits it used go back to the wallet (as negative drawdowns). They do not become refundable credit.
  • Final bill on cancel and expire. The final invoice is drawn down first, as usual. What is left stays on the subscription. See carry-over.

Edge cases

⚠️
  • A plan change can return paid credit twice. When a plan change replaces a renewal invoice that the wallet paid, the existing Plan Downgrade credit for the unused period is worked out on the invoice’s gross amount. The wallet-paid part can then come back twice: once to the wallet, and again as ordinary credit that can be refunded. This is a known issue.
  • A returned drawdown can land on an entry that has since expired or been charged back.
  • A large invoice discount on an invoice with an untaxed drawing line can over-draw. This is rare.
  • Ordinary credits that fully pay a renewal invoice do not mark the order paid. With Auto Collect off, the subscription can then expire. This was already so before prepaid credits.