Selling to Indian customers from your own Laravel app? Skip two weeks of billing plumbing.
Laravel Cashier and Spark support Stripe and Paddle, but not Razorpay. Razorpay's Invoices API only creates non-GST invoices; GST-compliant invoices have to be made in its Dashboard. So most Indian developers end up hand-building the same pieces: order creation, signature checks, webhook retries, CGST/SGST vs IGST, financial-year invoice numbers and a PDF template. Then they debug "signature mismatch" at 2 AM.
India Billing Kit is a Laravel package that does all of that in one place:
- Razorpay orders, created server-side. The amount is calculated on your server and never trusted from the browser.
- Verified webhooks. The raw-body HMAC check runs with the webhook secret. Duplicate events are dropped by event id, mismatched amounts are blocked, and the endpoint fails closed if the secret is missing. It handles payment.captured, order.paid, payment.failed and refund.processed.
- Exactly one invoice per order, even when the checkout callback and two webhooks all arrive at once (row-locked and idempotent).
- GST calculation:
- CGST + SGST within a state, CGST + UTGST for Chandigarh and other UTs without a legislature, and IGST between states.
- Tax-inclusive or tax-exclusive prices, discounts, multiple rates, an HSN/SAC summary, reverse charge and round-off.
- All money is handled as integer paise, so there are no float bugs.
- GSTIN validation (format and check digit, offline). For B2B buyers, the place of supply is taken from their GSTIN.
- Invoice numbers like INV/26-27/0001: gap-free, reset every 1 April, and checked against the GST 16-character rule.
- Tax invoice template: HTML plus PDF (with dompdf), amount in words in lakh/crore style, and signed, expiring links you can email to customers.
- php artisan india-billing:doctor catches common setup mistakes: a wrong secret, test keys in production, a GSTIN/state mismatch, or a non-HTTPS URL.
- Docs written for humans: a 20-30 minute quick start, a plain-English GST explainer, troubleshooting, security notes, honest limitations, and a go-live QA checklist.
- 12 AI prompts for extending the kit safely with ChatGPT or Claude (monthly renewals, credit notes, Filament admin, invoice emails and more), even if you've never used AI for coding.
Tested before release: 29 unit tests and 18 Laravel feature tests passed on PHP 8.4 / Laravel 13. A live HTTP webhook run was also done locally. The full test log is included. Razorpay's API was mocked in the tests; no live payment was made.
What's in the zip:
- Source: src/Core is framework-free PHP; src/Laravel is the integration layer.
- Config, migration, Blade views and routes.
- Tests.
- Examples: a checkout controller, an access-granting listener, a local signed-webhook sender, and two real sample invoices (PDF/HTML).
- Docs, the AI prompt pack, the license and the changelog.
Not included in v1 (being honest): Razorpay Subscriptions (recurring mandates), credit-note generation, e-invoicing (IRN/QR), exports/LUT/SEZ, cess, multi-currency and an admin UI. Feature tests ran on Laravel 13 only; Laravel 11/12 should work but were not tested.
This is a developer tool, not tax advice. Confirm your SAC/HSN, GST rate and invoice format with your CA.
FAQ
Does it handle Razorpay Subscriptions? Not in v1. It handles one-time orders. AI prompt #3 shows how to do monthly renewals with one-time orders.
Is it GST-compliant? It produces the fields CGST Rule 46 asks for and applies the standard intra/inter-state split. It isn't tax advice, and correctness depends on the SAC/HSN and rate you configure. Ask your CA to review your first invoices.
E-invoicing (IRN/QR)? Not supported.
Exports or foreign customers? Not supported in v1 (INR only).
Do I need the Razorpay PHP SDK? No. It uses Laravel's HTTP client.
Was it tested with real money? No. Tests mock Razorpay's API and send signed webhooks locally. Do a small live payment and refund before launch (see the QA checklist).
Can I use it for clients? Yes, in unlimited projects. You can't resell the kit itself.
Refunds? Digital download. If the kit doesn't work as described and we can't fix it, email within 14 days.
Support? Email raghavji2050@gmail.com (best effort).
Debugging a webhook signature right now? Start with the free Razorpay Webhook Debug Kit: https://topmate.io/raghavji/2362733