API v1FiatPe Home
FiatPeDocs

Payment Link

Create and manage secure payment links to collect payments from customers. Configure amounts, partial payments, expiry, customer details, reminders, callbacks, and custom metadata, then share the generated link across channels such as SMS, email, or messaging apps.

Entity

idstring

The unique identifier of the payment link.

entitystring

The type of entity represented by this object.

amountinteger

The total payment link amount in the smallest currency sub-unit. For INR, ₹100.00 should be provided as 10000.

amount_paidinteger

The total amount successfully paid against the payment link, in the smallest currency sub-unit.

amount_pendinginteger

The remaining amount yet to be paid against the payment link, in the smallest currency sub-unit.

currencystring

The three-letter ISO currency code for the payment link amount.

reference_idstring

A unique identifier assigned by the merchant to track and reconcile the payment link. It can contain up to 40 characters and must be unique.

descriptionstring

A brief description of the purpose of the payment link, displayed to the customer during the payment process.

allow_partialboolean

Indicates whether the customer can pay the payment link amount in multiple partial payments.

min_partial_amountinteger

The minimum amount the customer must pay in each transaction when partial payments are enabled, in the smallest currency sub-unit.

statusstring

The current status of the payment link. Possible values are CREATED, PARTIAL_PAID, PAID, EXPIRED, and CANCELLED.

expires_atinteger

The Unix timestamp indicating when the payment link will expire.

enable_remindersboolean

Indicates whether automatic payment reminders are enabled for the customer before the payment link expires.

cancelled_atinteger

The Unix timestamp indicating when the payment link was cancelled. This field is null if the payment link has not been cancelled.

customer_idstring

The unique identifier of the customer associated with the payment link.

customerjson object

The customer details associated with the payment link, such as name, email address, and phone number.

notificationjson object

Specifies the communication channels used to send the payment link notification to the customer.

allow_upi_linkboolean

Indicates whether a UPI-compatible payment link is enabled.

allow_whatsapp_linkboolean

Indicates whether a WhatsApp-compatible payment link is enabled.

short_urlstring

The shortened URL that can be shared with the customer to complete the payment.

metadatajson object

Additional key-value information associated with the payment link for internal tracking, reporting, or reconciliation.

updated_atinteger

The Unix timestamp indicating when the payment link was last updated.

created_atinteger

The Unix timestamp indicating when the payment link was created.