Razorpay

Introduction

Razorpay is a comprehensive payment gateway that enables businesses to accept and process payments through various methods, including credit/debit cards, UPI, and net banking.

Supported Countries

• India in

Available Payment Methods

Razorpay currently only supports INR currency.

Miscellaneous Details

• Webhooks are source of truth for razorpay
• For setting back url you can use custom params in Initiate Payment api request object.
  json

  {
    ...
    "custom_params": {
     	"razorpay_back_url": "YOUR_BACK_URL"
    }
  }
  

  
  

Webhooks Configuration

To ensure we never miss important payment events and to reconcile payments reliably, you must configure webhooks in the Razorpay Dashboard. Webhooks act as your source of truth for payment state changes (e.g. captures, failures, refunds) and are mandatory for a robust, production-ready integration.

1. Navigate to Webhooks in Dashboard

1. Log in to your Razorpay Dashboard
2. Go to Accounts & Settings
3. Click Webhooks under Website and App Settings

2. Add a New Webhook Endpoint

• Click: + Add New Webhook
• Webhook URL: Your public HTTPS endpoint (e.g. https://dev-api.portone.cloud/webhook/razorpay/YOUR_PORTONE_KEY)
• Secret: A strong, unguessable string (could be your PORTONE_SECRET)
• Alert Email: Email address to receive failure/deactivation alerts

3. Select Events to Subscribe

At a minimum, subscribe to the following events:

• payment.captured – when a payment succeeds and the amount is captured
• payment.failed – when a payment attempt fails
• refund.processed – when a refund is successfully issued
• (Optional) payment.refunded – for partial or full refund notifications

Razorpay Webhook Docs: Link

Sandbox

Credentials

• Create a account from razorpay website
• Get key id and key secret from settings -> api-keys

Use following values in embedded JS code to pay via Global Payments channel

    "pmt_channel": "RAZORPAY",
    "pmt_method": "RAZORPAY_ALL",

Reference links

• API Docs
• Test Cards
• Test UPI