API ReferenceIntegrationsKnowledge Base

Razorpay Custom Checkout Integration - Best Practices

Custom Checkout is an integration provided by Razorpay where you can completely customize the checkout as per your requirements and use it as a white label solution.

You can configure payment methods, orders, company logo and also select custom color based on your convenience. This checkout supports all the major browsers (IE 9 and above).

Given below are some of the best practices to be followed for a smoother integration and payment experience:

1. Integrate the Payments Rainy Day Kit🔗

While Razorpay strives to provide a positive payment experience to every customer, they might face payment exceptions such as:

  • Late Authorization
  • Payment Downtime
  • Payment Errors

To overcome such exceptions and provide a smooth payment experience to your customers, use the Payments Rainy Day kit.

5. Implement Webhooks🔗

Implement webhooks or the query API to avoid any cases of callback failure (drop offs could be connectivity or network failure) and to verify the payment details via an S2S call. Some of the webhook events you should enable are:

  • payment.captured
  • payment.failed
  • order.paid

Read more: Learn more about Webhooks.

6. Implement Callback URL🔗

Implement callback_url if your customer's make online payments on browsers such as Instagram, Facebook Messenger, Opera, UC browsers and so on. This is because, these browsers do not support i-frame.

8. Implement VPA Saving and Validation Features🔗

Follow these best practices if you accept UPI collect payments from customers:

  1. Validate the VPA before initiating the payment request. Learn more about VPA Validation.
  2. Add a custom UPI Collect expiry based on the business requirement to provide enough time for the customer to complete the payment.
  3. Use the Saved VPA feature provided by Razorpay to provide a better customer experience and avoid payment failures.