Integrating Razorpay
Auth: API key · Partner program: not required · Setup time: about 10 minutes · Last verified: 2026-05-15
India-focused full-stack payments — UPI, netbanking, cards, wallets, EMI, subscriptions, invoicing, payouts.
Auth model
Section titled “Auth model”
rawis opt-in. The upstream payload is withheld unless an operator enablesdata_store.raw_payload.paymentsin Admin → Settings → Data store. It is off by default because across the payments adapters it declares bank account numbers, IBANs and card numbers the canonical schema does not expose.
api_key (Basic-auth derived from key_id:key_secret). Submit both via the Connect Link form; the adapter base64-encodes them.
Configure in admin
Section titled “Configure in admin”- Sign in at https://dashboard.razorpay.com.
- Settings → API Keys → Generate Key. Copy
Key ID(rzp_live_…orrzp_test_…) and the secret. - Open
/platforms→ Payments → Razorpay → Configure and submit:keyIdkeySecret
Webhooks
Section titled “Webhooks”Set up at Settings → Webhooks. Subscribe to:
payment.*,refund.*subscription.*,invoice.*payout.*dispute.*(where enabled)
Razorpay signs deliveries with X-Razorpay-Signature (HMAC-SHA-256 of the raw body with the webhook secret).
Quirks
Section titled “Quirks”- Money in minor units already (
amount: 50000for ₹500.00). The adapter passes amounts through unchanged. created_atis a Unix timestamp (seconds). The adapter converts to ISO-8601 RFC 3339.- PaymentMethod stays raw. Razorpay’s tokenisation flow follows RBI compliance rules — saved card semantics differ from Western gateways and the canonical schema doesn’t model them.
- Disputes (chargebacks) only on live keys with sufficient volume — test keys won’t see them.
References
Section titled “References”- API reference: https://razorpay.com/docs/api/
- Webhooks: https://razorpay.com/docs/webhooks/
- Subscriptions: https://razorpay.com/docs/api/payments/recurring-payments/subscriptions/
opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.