Create a payment link
Create a shareable payment link to collect payments via SMS and email. Supports standard links (all payment methods) and UPI-only links (set upi_link=true). UPI links are not available in test mode. Partial payments are not supported for UPI links. Links expire after 6 months by default.
Request body
Amount in smallest currency unit (paise for INR). Example: 50000 for ₹500.
ISO 4217 currency code. UPI links support INR only.
Set true to create a UPI-only Payment Link. Not available in test mode.
Enable partial payments. Not supported for UPI links.
Minimum first partial payment amount in paise.
Unix timestamp for link expiry. Max 6 months from creation. Must be at least 15 minutes in the future.
Your unique tracking reference. Max 40 characters. Must be unique.
Brief description shown on the payment page. Max 2048 characters.
Send automatic payment reminders.
Redirect URL after payment completion.
Required when callback_url is set.
Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.
Response
Payment link created.
Unique payment link identifier. Prefix: plink_
Payment amount in smallest currency unit (paise for INR). Three-decimal currencies (KWD, BHD, OMR): drop last decimal digit (e.g. 295.991 KWD → 295990). Zero-decimal currencies (JPY): pass value as-is.
Total amount paid by customer.
ISO 4217 currency code. UPI Payment Links only support INR.
Allow partial payments. Not supported for UPI links.
Minimum amount required for the first partial payment.
Brief description. Max 2048 characters.
Your unique tracking reference. Max 40 characters. Must be unique per link.
Unix timestamp when link expires. Default: 6 months from creation. Must be at least 15 minutes in the future.
Unix timestamp when link actually expired.
Unix timestamp when link was cancelled.
created: awaiting payment. partially_paid: one or more partial payments received. expired: past expiry with no full payment. cancelled: manually cancelled. paid: fully paid.
true if this is a UPI Payment Link, false for standard.
Shareable short URL for the payment link.
Redirect URL after payment completion.
Send automatic payment reminders.
Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.
Identifier for the user role that created the link.