Running on Razorpay?

Razorpay signatures failing or UPI timing out? We sort it out.

Razorpay is the default for Indian payments and has its own set of surprises when you plug it in from a US codebase. Signature verification that passes in the sandbox and fails in production, UPI collect flows that time out at thirty seconds because the shopper opened the wrong app, settlements held pending KYC a fortnight after approval. We bring the webhooks, the Checkout and the subscription contracts back in step.

  • Since 2015Fixing technology
  • FreeEstimates
  • US teamReal engineers

razorpay-events.log

mismatched

What it is

Razorpay at a glance

Razorpay is India's most widely used payment gateway, founded in 2014 by Harshil Mathur and Shashank Kumar, and headquartered in Bangalore. It offers card payments, UPI, net banking, wallets, EMI, pay-later and recurring subscriptions, along with a payout product, a payroll product, and a business banking offering called RazorpayX.

The platform's main value for a non-Indian merchant is access to the UPI rail, which handles the majority of consumer payments in India. Razorpay runs its own gateway with acquiring relationships across the major card networks and most Indian banks, and supports international cards with the usual regulatory caveats.

Type
Indian payments gateway with payouts, subscriptions and banking
First released
2014
License
Proprietary API, percentage plus fixed pricing
Maintained by
Razorpay Software Pvt. Ltd.
Typically used for
UPI payments, cards and net banking in India, subscriptions, marketplace split payments, payouts to bank accounts

The honest version

Razorpay pros and cons

No technology is all upside. This is where Razorpay earns its place and where it tends to cause trouble.

Where Razorpay is strong

  • UPI coverage is first classUPI collect and intent flows work across every major app, and the Checkout handles the deep-link mechanics for GPay, PhonePe and Paytm without you writing per-app logic.
  • Standard Checkout saves weeksThe hosted Checkout handles card, UPI, net banking, wallets and EMI from one modal, which would otherwise be a dozen separate integrations.
  • Subscriptions and plans built inPlans, trials, addons and mandate-based recurring work against Indian regulations, including the e-mandate flow that is required for recurring over the standing instruction limit.
  • RazorpayX payouts are reliableBank transfers to vendors, salaries, and marketplace splits run from the same account and clear predictably with IMPS, NEFT and RTGS options.
  • Dashboard is better than most Indian competitorsSearchable transactions, clear refund flow, and reporting that works without a BI tool make day-to-day operations less painful.

Where Razorpay bites

  • KYC and settlement holds appear without warningA risk review can hold settlement for days with limited visibility, and the resolution is a support ticket rather than a dashboard action. Teams that rely on T+2 cash flow have to plan for exceptions.
  • International card support is unevenSome issuers go through fine, others require OTP that the shopper never receives. The approval rate on international cards is notably lower than domestic UPI.
  • Documentation has gaps for non-Indian developersThe docs assume familiarity with the Indian payment ecosystem, RBI rules and local acronyms, which US-based engineers hit cold on their first integration.
  • Signature verification is a common bug surfaceThe order-id, payment-id and signature trio has specific concatenation rules, and a stray space or a wrong secret in production produces a signature error that looks identical to a stale request.
  • Recurring over the standing instruction limit needs e-mandateA straightforward recurring flow becomes a longer dance with bank authentication and amount caps once you cross the RBI limit.
  • Support quality variesLow-tier accounts share the general support queue and can wait days for a response to a transaction-specific question, which is painful when a shopper is waiting on a refund.

Sound familiar?

Common Razorpay problems we fix

The Razorpay problems that bring people to us, and what you have once each one is fixed.

Signature verification failed for webhook payload

Webhook signatures never pass in production

The webhook secret stored in the handler is the Checkout key, not the webhook secret, or the raw body was modified by a middleware before verification. Both produce the same error with no useful detail.

Signatures that verify every time

UPI collect request expired after 30s

UPI collect flows time out

The shopper's bank is slow to deliver the notification, the UPI app was not active on the device, or the shopper opened the wrong app. The order sits as attempted and never completes.

UPI flows with retry and clear UX

payment.failed: Payment method not enabled

Payment methods disappear in Checkout

A method that is enabled in the dashboard but not activated on the merchant account, or an EMI tenure that is not on the current plan. Checkout silently filters it out with no banner.

Methods present for the full shopper base

order.paid webhook retried 7 times

Order paid handler is failing

A handler that returns 500 under load, a schema mismatch after a Razorpay API bump, or an idempotency key that is colliding with a refund event. Razorpay retries for days and the inbox fills up.

Handlers idempotent and fast

KYC document under review

Settlements are held pending KYC

A document that was uploaded but marked for review, a business address change that triggered re-KYC, or a director update that was not reflected on the account. Cash flow stops until it clears.

KYC path cleared and documented

Signature verify: razorpay_payment_id missing

Client callback is missing fields

The success callback from Checkout did not forward every expected field, usually because a redirect landed on the wrong route, or the form POST stripped keys the handler expects.

Callbacks that carry every field

Subscriptions: addon charge failed

Subscription addons quietly fail

An addon charge that exceeded the e-mandate cap set at subscription creation, or a customer bank that declined the standing instruction. The subscription stays active, the addon is unpaid.

Subscription billing that reconciles

What we do

Razorpay help, from rescue to upkeep

Call us for one broken signature verification, or let us run the Razorpay integration alongside your Indian operations.

Rescue
Signatures failing in production, UPI timing out, or settlements stuck on hold. We stabilise the integration and chase the support ticket if needed.
Webhook reliability
Secrets verified, raw body preserved end to end, handlers idempotent on the right key, and dead-letter capture so Razorpay's retry loop does not drown you.
Checkout and UPI
Checkout configured per payment method, UPI flows with retry hints and clear UX, and card routing aligned with your shopper base.
Subscriptions and e-mandate
Plans, addons and mandates set up against the RBI limits, with the e-mandate flow handled properly for high-value recurring.
Managed Tech
Ongoing watch on settlements, dispute response, KYC renewals, webhook health and a person to call when the dashboard changes between releases.

How it works

From first message to fixed

  1. Look Free estimate

    Tell us what's going wrong. We look at it, then tell you plainly what's wrong and what it will cost.

  2. Fix

    We fix the cause, not the symptom. If something is down, getting it back up comes first.

  3. Harden

    Backups, monitoring, updates and access, so the same problem can't quietly come back.

  4. Hand back or stay on

    You get a plain-language write-up. Or we stay on for hosting, upkeep and new work.

Often found together

Running Razorpay alongside something else?

We work on the whole stack, so the problem can be wherever it actually is.

Questions

Razorpay questions

Something else? Call+1 737 727 7327

Why is Razorpay signature verification failing in production?

Three common causes. The handler is using the Checkout key instead of the webhook secret. A middleware is parsing the body and the HMAC is being computed on the parsed form rather than the raw bytes. Or a trailing newline in the stored secret makes the HMAC differ. We isolate which one applies by replaying a known payload against the handler end to end.

Why do UPI collect requests time out?

UPI collect gives the shopper a window, usually thirty seconds, to approve on their bank app. If the notification is delayed, the device is locked, or the shopper opened the wrong UPI app, the window closes. Pushing to UPI intent where possible, and showing a clearer retry path, materially improves completion on consumer flows.

Can we use Razorpay for recurring subscriptions?

Yes, through Razorpay Subscriptions. Under the RBI standing instruction limit it works with a card or UPI mandate out of the box. Above the limit you need the e-mandate flow, which adds a bank authentication step. Teams that do not know about the limit discover it when charges above the cap start failing.

Why are settlements on hold?

Usually KYC, risk review, or a dispute spike. The dashboard shows the status, and the resolution is almost always a direct response with supporting documents rather than another support ticket. We handle the back-and-forth so the engineering team can keep shipping.

Do international cards work on Razorpay?

Yes, but the approval rate is lower than for domestic UPI and Indian cards. Many issuers require OTP that the shopper does not receive if their phone is on a foreign network. For a non-India target market, Stripe or Adyen is usually the better choice; for payments from Indian shoppers, Razorpay is the standard.

How much does Razorpay help cost?

The quote is free. Send over the account, the pattern of failures and whether you are US-based or local, and we come back with a price before any work begins.

Free estimate

Razorpay integration giving you trouble?

Share the account, the recent event logs and which flows are failing. A real person reads it and comes back with an estimate.

  • No charge to find out what it will take
  • If it's urgent, say so

Replies come from a person. By sending, you authorize us to email you back. No marketing.