Razorpay Connection Setup

​

Overview

• Creating customers in Razorpay
• Processing payment links via Razorpay Checkout
• Receiving webhook notifications from Razorpay
• Synchronizing customer data between systems
• Syncing invoices to Razorpay for payment collection

​

Prerequisites

1. Active Razorpay Account - Sign up at razorpay.com
2. API Keys - Available in your Razorpay Dashboard
3. Webhook Endpoint - Configured in Razorpay Dashboard
4. Tirdad Environment - Valid tenant and environment IDs

​

Step 1: Gather Razorpay Credentials

​

Required Credentials

​

Finding Your Credentials

1. API Keys:
   • Go to Razorpay Dashboard → Settings → API Keys
   • Copy your Key ID
   • Copy your Secret Key
   • Use test keys for development
2. Webhook Secret:
   • Go to Razorpay Dashboard → Settings → Webhooks
   • Create or select your webhook endpoint
   • Copy the webhook secret (used for signature verification)

​

Step 2: Configure Webhook Endpoint in Razorpay

​

Webhook URL Format

https://api.tirdad.ai/v1/webhooks/razorpay/tenant_01K1TJDVNSN7TWY8CZY870QMNV/env_01K1TJJF0CJR410C6QVPYQTNV0

​

Required Webhook Events

​

Setting Up the Webhook

1. Go to Razorpay Dashboard → Settings → Webhooks
2. Click + Add New Webhook
3. Enter your webhook URL
4. Select the required events listed above
5. Click Create Webhook
6. Copy the Webhook Secret for your connection

​

Step 3: Create Razorpay Connection

​

Using Tirdad Dashboard

​

Webhook Configuration

​

API Request

​

API Request

Content-Type: application/json
Authorization: Bearer your_api_key
X-Tenant-ID: your_tenant_id
X-Environment-ID: your_environment_id

{
  "name": "Razorpay Production",
  "provider_type": "razorpay",
  "encrypted_secret_data": {
    "key_id": "rzp_live_...",
    "secret_key": "rzp_live_...",
    "webhook_secret": "..."
  }
}

​

Response

{
  "id": "conn_1234567890abcdef",
  "name": "Razorpay Production",
  "provider_type": "razorpay",
  "status": "active",
  "created_at": "2024-01-20T10:30:00Z",
  "updated_at": "2024-01-20T10:30:00Z"
}

​

Security Best Practices

​

Credential Management

1. Environment Separation: Use different keys for test/production
2. Key Rotation: Regularly rotate your Razorpay API keys
3. Access Control: Limit API key permissions in Razorpay
4. Encryption: All credentials are encrypted at rest in Tirdad

​

Webhook Security

1. HTTPS Only: Always use HTTPS for webhook endpoints
2. Signature Verification: Tirdad verifies all webhook signatures
3. Secret Management: Keep webhook secrets secure and rotate regularly
4. Rate Limiting: Implement rate limiting on webhook endpoints

​

Troubleshooting

​

Common Issues

​

Debug Steps

1. Check Razorpay Dashboard: Verify API keys and webhook configuration
2. Test API Keys: Use Razorpay API to test key validity
3. Monitor Webhooks: Check webhook delivery logs in Razorpay
4. Review Logs: Check Tirdad application logs for errors

​

Next Steps

1. Test Customer Sync: Create a test customer and sync to Razorpay
2. Create Payment Links: Test payment link creation and flow
3. Monitor Webhooks: Ensure webhook events are being received
4. Go Live: Switch to production keys when ready