Verify a completed Razorpay payment

Request: application/json

Client-side callback after the Razorpay Checkout widget completes. Verifies the HMAC signature and activates the matching purchase. Pass razorpay_order_id for a one-time purchase, or razorpay_subscription_id for a recurring plan mandate - not both. These map 1:1 to what Checkout.js's own success handler gives you back for each checkout_type - see POST /subscriptions/checkout's description for the full field contract per flow. Passing razorpay_order_id for what was actually a checkout_type: "subscription" purchase (or vice versa) fails lookup with 404.

Idempotent - safe to call more than once: if the purchase is already active this is a no-op that just returns the current state. This matters because the webhook (payment.captured/subscription.charged) performs the exact same activation as a server-side backstop in case this call never fires (app killed, network drop) - both can run for the same purchase without side effects.

If verification never gets called at all (killed app, closed tab): there's no need to retry this specific call - the webhook backstop activates the purchase on its own once Razorpay processes the payment. Use GET /subscriptions/{purchase_key} afterward to confirm the purchase went through.

Body: razorpay_payment_id, razorpay_signature, razorpay_order_id or razorpay_subscription_id

Success: 200 - purchase flipped to active

Errors: 422 - signature verification failed | 404 - purchase not found

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "razorpay_payment_id": "pay_00000000000001",
    "razorpay_signature": "9ef4dffbfd84f1318f6739a3ce19f9d85851857ae648f114332d8401e0949a3d",
    "razorpay_subscription_id": "sub_00000000000001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "status": "active",
        "purchase_key": "Purchase-83921"
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠406

🟠422Parameter Error

🟠429