Tax (Nepal VAT)

PayBridgeNP supports per-merchant tax configuration on subscription invoices. Nepal VAT is 13%.

Quick start

Enable tax and set your PAN:

curl -X PATCH https://api.paybridgenp.com/v1/billing/settings/tax \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "rateBps": 1300,
    "label": "VAT",
    "registrationNumber": "301XXXXXXX"
  }'

Rate is stored in basis points: 1300 = 13.00%. Label defaults to "VAT" (rendered as "VAT (13.00%)" on invoices).

Rate changes and past invoices

Existing invoices retain the tax rate and registration number used when they were created. The JSON invoice object returned by GET /v1/billing/invoices/:id does not currently expose that rate and registration number as separate fields.

Math - discount before tax

PayBridgeNP applies discount before tax. Customers pay tax on the discounted price, not the list price:

subtotal       = 50000 paisa (500 NPR plan)
discount_total = 5000 paisa (50 NPR promo)
taxable_base   = max(0, 50000 - 5000) = 45000 paisa
tax_total      = round(45000 * 1300 / 10000) = 5850 paisa
amount_due     = 50000 - 5000 + 5850 = 50850 paisa (508.50 NPR)

All integer math internally - amounts stored as paisa (1 NPR = 100 paisa).

What the customer sees

The hosted invoice page and the invoice email show a breakdown:

Subtotal         NPR 500.00
Discount         -NPR 50.00
VAT (13.00%)     +NPR 58.50
─────────────────────────────
Total            NPR 508.50

When taxRegistrationNumber is set, it prints in the invoice footer (e.g. "PAN: 301XXXXXXX").

Disabling tax

Set enabled: false. Disabling tax affects future invoices only.

Getting Started

Accepting Payments

Checkout

Providers

Subscriptions & Billing

Branding

Operations

Integrations

Quick start

Rate changes and past invoices

Math - discount before tax

What the customer sees

Disabling tax

​Quick start

​Rate changes and past invoices

​Math - discount before tax

​What the customer sees

​Disabling tax

Quick start

Rate changes and past invoices

Math - discount before tax

What the customer sees

Disabling tax