Pass-Through Charges
A pass-through charge is a cost you pass on to the customer at cost, such as an SMS carrier fee or a third-party data fee. It is rated like any other line, but it is marked on the order, the invoice and the invoice PDF. You also decide, on the plan, whether pass-through lines carry GST.
When to use it
Use pass-through when you buy something on the customer’s behalf and pass the cost on: a carrier fee of ₹1 for each SMS, a licence fee, a courier cost. Do not use it for your own margin. Pass-through amounts are cost recovery, so they are not MRR.
Mark a piece as pass-through
Open the piece
In the rate plan builder, open or add a Usage piece, a Per-event fee, or a One-time fee.
Tick Pass through at cost
The checkbox is under the usage piece and under each per-event fee. For a one-time fee the pass-through flag is set through the API (passThrough).
Set the GST switch
Once any piece is pass-through, a checkbox appears at the bottom of the pieces: Charge GST on pass-through lines. It is ticked by default.
Publish
Click Publish plan.
Settings
| Setting | Where | API field | Allowed values | Default | Rules |
|---|---|---|---|---|---|
| Pass through at cost | Component | passThrough | true or false | false | Only on USAGE, EVENT or ONE_TIME components. Error: Component N passThrough is only allowed on USAGE, EVENT or ONE_TIME components. A non-boolean gives Component N passThrough must be true or false. |
| Charge GST on pass-through lines | Rate plan price and add-on price | passThroughTaxable | true or false | true | A non-boolean gives passThroughTaxable must be true or false. |
| Pass-through on an ad-hoc charge | Charges API | passThrough | true or false | false | passThrough must be true or false. |
The default of passThroughTaxable is true, so nothing escapes GST unless you say so.
The GST switch
| Switch | What happens to the pass-through lines |
|---|---|
| On (default) | Taxed like any other line, at the line’s tax profile. |
| Off | No GST on those lines (no CGST, SGST or IGST). Their value stays out of the taxable value, and they still count in the invoice total. GST is still worked out per line for the other lines. |
The switch is on the rate plan price, so it covers every pass-through line of that price, including usage, events, one-time fees and pass-through pending charges.
Examples (acceptance checks)
A plan with a ₹15 base fee and a usage piece “Carrier fee” at ₹1 per SMS, marked pass-through. The customer sends 500 SMS. GST 18%.
| Line | GST switch off | GST switch on |
|---|---|---|
| Rate plan ₹15.00 | GST ₹2.70 | GST ₹2.70 |
| Carrier fee, 500 SMS ₹500.00 | GST ₹0.00 | GST ₹90.00 |
| Total GST | ₹2.70 | ₹92.70 |
| Invoice total | ₹517.70 | ₹607.70 |
How it appears on the invoice and PDF
- The line carries a pass-through mark on the order and the invoice.
- On the invoice PDF, pass-through lines come after the other lines, under the heading Pass-through charges.
- An untaxed pass-through line keeps its place in the GST table with a GST amount of 0, and adds nothing to the taxable value. Its total is what it charges.
Example invoice, switch off
| # | Description | Taxable value | GST 18% | Total |
|---|---|---|---|---|
| 1 | Rate plan | ₹15.00 | ₹2.70 | ₹17.70 |
| Pass-through charges | ||||
| 2 | Carrier fee (500 SMS) | ₹0.00 | ₹0.00 | ₹500.00 |
| Total | ₹15.00 | ₹2.70 | ₹517.70 |
Edge cases
- A pass-through line is still rated at cost by the engine, with its model, included quantity, minimum and cap, as any usage or event line.
- A pass-through line after a renewal-mode End of Term change takes its GST setting from the cart’s price.
- A pass-through line can be paid from prepaid credits when its component has Paid from credits. The builder ticks that by default for pass-through pieces.
- The v1 API shows such a price but cannot change it. See v1 is read-only for these settings.