Razorpay

Interact with Razorpay payment gateway API

Actions10

Order Actions
- Fetch All
Payment Link Actions
- Create
- Fetch
Payment Actions
- Fetch Payment
- Fetch All
Refund Actions
- Fetch All
Settlement Actions
- Fetch Settlement
- Fetch All
Invoice Actions
- Fetch Invoices for Subscription
Dispute Actions
- Fetch All

Overview

This node enables creating a Payment Link using the Razorpay API. A Payment Link is a URL that can be shared with customers to collect payments easily without requiring an online store or complex checkout integration. This operation is useful for businesses that want to quickly generate payment requests for invoices, services, or products and send them via email, SMS, or other channels.

Practical examples include:

Sending a payment request link to a customer for a policy renewal.
Generating a payment link for event registration fees.
Creating links for partial payments or deposits.

Properties

Name	Meaning
Amount	The amount to be paid through the Payment Link, specified in the smallest currency unit (e.g., paise for INR). For example, ₹1000 should be entered as 100000.
Currency	The ISO currency code for the payment (e.g., INR, USD, EUR). Supported currencies include AED, AUD, CAD, EUR, GBP, INR, MYR, SGD, THB, USD.
Description	A brief description of the Payment Link purpose, up to 2048 characters. Example: "Payment for policy no #23456".
Reference ID	A unique reference number for the Payment Link, max 40 characters. Used to identify the payment link externally.
Customer Details	Collection of customer information including: - Customer Name - Customer Email - Customer Contact (phone number)
Additional Options	Various optional settings: - Accept Partial Payment (boolean): Allow customers to pay partially. - Callback Method (GET only if callback URL provided). - Callback URL: Redirect URL after payment completion. - Enable Reminders (boolean): Send reminders. - Expire By: Expiry timestamp for the link. - First Min Partial Amount: Minimum first partial payment amount (required if partial payments enabled). - Notes: Key-value pairs for additional info (max 15 pairs). - Send Email Notification (boolean): Notify customer by email. - Send SMS Notification (boolean): Notify customer by SMS.

Output

The node outputs a JSON object representing the created Payment Link details as returned by the Razorpay API. This typically includes fields such as the payment link ID, status, short URL, amount, currency, description, expiry, and customer details.

No binary data output is produced by this operation.

Dependencies

Requires an active Razorpay account and an API key credential configured in n8n for authentication.
Internet access to call Razorpay's REST API endpoints.
Properly configured webhook/callback URLs if using callback features.

Troubleshooting

Common issues:
- Invalid or missing API credentials will cause authentication errors.
- Providing an invalid currency code or amount format may result in validation errors.
- Duplicate Reference IDs will cause the API to reject the creation request.
- Incorrect callback URL format or unsupported HTTP method for callbacks will cause failures.
- If partial payments are enabled but minimum partial amount is not set, the request will fail.
Error messages:
- "Unknown operation": Indicates the selected operation is not supported; ensure "Create Payment Link" is chosen under Payment Link resource.
- API error responses usually contain descriptive messages about what went wrong (e.g., invalid parameters).
Resolution tips:
- Double-check all required fields and their formats.
- Ensure unique Reference IDs for each payment link.
- Validate URLs and enable necessary options consistently.
- Review Razorpay API documentation for limits and constraints.