Create your account
1
Sign up at dashboard.razorpay.com/signup
Go to dashboard.razorpay.com/signup and enter your business email and a password. Razorpay will send a verification email — click the link to confirm your address.
2
Enter your business details
Provide your business name, type (individual, partnership, private limited, etc.), and the category that best describes your business. These details determine which payment methods are available to you.
3
Log in to the Dashboard
After verification, log in at dashboard.razorpay.com. Your account starts in Test Mode, which means you can build and test your integration immediately without KYC.
Complete KYC for Live Mode
Test Mode lets you build without any paperwork, but you must complete KYC verification before accepting real payments. The approval process typically takes 24–48 hours after you submit all required documents.1
Open the KYC section
In the Dashboard, click Account & Settings and then select Business KYC (or look for the banner prompting you to activate your account).
2
Submit business and owner documents
Upload the documents Razorpay requests for your business type. Common requirements include:
- PAN card (business and personal)
- Address proof (utility bill, bank statement)
- Bank account details for settlements
- Certificate of incorporation (for companies)
3
Wait for verification
Razorpay’s team reviews your submission and notifies you by email. Once approved, your account switches to Live Mode and your
rzp_live_ keys become active.You can continue building in Test Mode while KYC is under review. Your integration does not change when you go live — you only swap your API keys.
Navigate the Dashboard
The Dashboard sidebar groups your tools into these main sections:- Transactions — view payments, refunds, transfers, and disputes.
- Orders — track orders and their associated payments.
- Settlements — see your settlement schedule and download reports.
- Payment Links — create and manage links for no-code payment collection.
- Subscriptions — manage recurring billing plans and subscribers.
- Account & Settings — manage API keys, webhooks, team members, and business profile.
Generate API keys
API keys authenticate your server-side requests tohttps://api.razorpay.com/v1. You need a Key ID and a Key Secret for each environment.
1
Go to API Keys settings
In the Dashboard, click Account & Settings, then select API Keys.
2
Generate a key for your environment
Select the environment (Test or Live) and click Generate Key. The Dashboard displays your Key ID and Key Secret.
3
Copy and store your Key Secret
Copy the Key Secret immediately and store it in a secure location such as a secrets manager or environment variable. The Dashboard does not show the Key Secret again after you close the dialog.
Only team members with the Owner or Admin role can view and generate API keys. Members with other roles do not have access to this section.
Add team members
1
Open team management
Go to Account & Settings → Business settings → Manage Team.
2
Invite a new member
Click Invite New Member, enter the person’s email address, and select a role.Available roles include Owner, Admin, Manager, Operations, Finance, and Developer. Each role has a different permission set — assign the least-privileged role that covers the person’s responsibilities.
3
Member accepts the invitation
Razorpay sends an invitation email. The invitee must accept it to gain access to the Dashboard.
Configure webhooks
Webhooks let Razorpay notify your server when events occur — such as a payment being captured, a refund being processed, or a subscription renewing. This keeps your backend in sync without requiring you to poll the API.1
Open webhook settings
Go to Account & Settings → Webhooks, then click Add New Webhook.
2
Enter your endpoint URL
Provide the HTTPS URL on your server that will receive webhook payloads. Razorpay sends a POST request with a JSON body to this URL when events occur.
3
Select events to subscribe to
Choose the event types relevant to your integration, such as
payment.captured, refund.created, or subscription.charged. Subscribing only to the events you need reduces noise.4
Save your webhook secret
Razorpay generates a webhook secret for signature verification. Store this secret securely and use it to validate that incoming webhook requests originate from Razorpay.
Configure payment capture settings
By default, Razorpay authorizes and captures payments in a single step. If your workflow requires manual review before capturing funds, you can enable manual capture. Go to Account & Settings → Payment Capture Settings and choose one of the following:- Automatic — payments are captured immediately upon authorization. This is the default and suits most integrations.
- Manual — payments are authorized but not captured. You must explicitly capture each payment within the capture window (typically 5 days), after which it is automatically reversed.