Callback URL

Q: 2. What are all the field names posted to the callback page, and can I add custom fields?

Razorpay posts only three fields to the callback page: razorpay_payment_id , razorpay_order_id , and razorpay_signature . Custom fields cannot be added to the callback response.

If you reuse your web integration of Razorpay Curlec Checkout inside a web view on Android or iOS, the checkout form may not open. Issues like this are handled in our

Android SDK

and

iOS SDK

, with the SDKs being the preferred method of integration.

Callback URL is not the same as a Webhook URL

The callback URL is a Checkout option for WebView and redirect flows. It receives the payment result synchronously after the customer pays.

A webhook URL is a server endpoint you configure on the Razorpay Dashboard to receive asynchronous event notifications (like order.paid or payment.failed). If you are looking to track payment status on your server after the customer pays, use webhooks — not callback_url.

If you want to reuse the web integration for any reason, you can pass the following callback_url along with other

checkout options

to process the desired payment:

callback_url needs to accept incoming POST requests. For a successful payment, the callback URL will have razorpay_payment_id, razorpay_order_id and razorpay_signature as the request parameters.

For failed payments, the request parameter are explained in the table below:

error

object The error object.

code

string Type of the error.

description

string Descriptive text about the error.

field

string Name of the parameter in the API request that caused the error.

Handy Tips

You can set query parameters with callback_url, to map it with entities at your side. For example, following is a valid callback URL:

https://your-site.com/callback?cart_id=12345

FAQs

1. Is the handler function not supported in WebView?

The handler function is not supported in WebView environments due to the inherent limitations of WebView in executing certain JavaScript functions.

2. What are all the field names posted to the callback page, and can I add custom fields?

Razorpay posts only three fields to the callback page: razorpay_payment_id, razorpay_order_id, and razorpay_signature. Custom fields cannot be added to the callback response.