Create payment links

This documentation will guide you to create payment link via API.

NOTE

  • A payment link can only be created when the API is set to live mode.

  • For multi currency payment , "allow_multi_currency" must be enabled for the merchant. If not , please contact Foloosi's support team.

Basic Requirements

// Create Payment Link
POST API LINK: https://api.foloosi.com/merchant/v1/payment-links/create

// Header
secret_key : YOUR_SECRET_KEY

// Post Body Fields
{
    "amount": "0.1",
    "currency": "AED",
    "link_type": "single",
    "notify_sms": "No",   // "Yes" || "No"
    "notify_email": "No",  // "Yes" || "No"
    "customer_email": "[email protected]",
    "phone_code": "",
    "customer_mobile": "",
    "receipt_no": "",
    "description": ""
}

//Sample response
{
     "message":  "Payment link created successfully",
     "data" : {
        "payment_link_reference" : "FLSPL0068417d39ab70c" //Newly created reference number
      }
}

TO GET THE PAYMENT LINK LIST

// Get Payment Link List
GET API LINK: https://api.foloosi.com/merchant/v1/payment-links/list

HEADERS:
secret_key : YOUR_SECRET_KEY

// PARAMS
q : {  
        "page":"1",
        "limit":"10",
        "link_type":"",   // "single" || "multiple"
        "payment_status":"",   // "success" || "pending"
        "from_date":"",    //dd-mm-yyyy
        "to_date":""    //dd-mm-yyyy
    }

SAMPLE RESPONSE:
{
    "message": "Payment links are",
    "data": {
        "payment_links": [
            {
                "reference_id": "FLSPL006819ba189c578",
                "transaction_amount": 0.1,
                "currency_code": "AED",
                "payment_description": "test",
                "customer_email": "",
                "customer_mobile": "",
                "receipt_no": "",
                "link_type": "single",
                "payment_status": "expired",
                "status": 1,
                "created": "2025-05-06T07:28:24+00:00"
            },
        ],
        "total_count": 2385  //total number of links created
    }
}

TO GET THE PAYMENT LINK DETAILS

// Get Payment Link Details
GET API LINK: https://api.foloosi.com/merchant/v1/payment-links/details/Your reference_id

HEADERS:
secret_key : YOUR_SECRET_KEY

SAMPLE RESPONSE:
{
    "message": "Payment Link details",
    "data": {
        "reference_id": "FLSPL0068417d39ab70c",
        "transaction_amount": 0.1,
        "currency_code": "AED",
        "payment_description": "",
        "customer_email": "",
        "customer_mobile": "+916379335488",
        "receipt_no": "",
        "notify_type": "sms",
        "link_type": "single",
        "payment_status": "expired",
        "status": 1,
        "created": "2025-06-05T11:19:21+00:00"
    }
}

FOR PAYMENT LINK STATUS CHANGE

// Payment Link Status Change, Use PUT Method
PUT API LINK: https: https://api.foloosi.com/merchant/v1/payment-links/change-status

HEADERS:
secret_key : YOUR_SECRET_KEY

// POST Body Feilds
{
    "payment_link_reference": "FLSPL0068417d39ab70c"
}

SAMPLE RESPONSE:
{
    "message": "Link status changed successfully",
    "data": {
        "status": "active" || "inactive"
    }
}

NOTE

Supports 170 World Currencies

Properties

List of properties available:

Name
Type
Required
Description

amount

string

true

Amount for transaction

currency

string

true

Valid 3-letter currency code (e.g., AED, INR, USD).

description

string

true

Reason/note for creating payment link

link_type

string

true

single/multiple usage payment link

notify_sms

string

true

If "Yes", sms notification will be sent to the number provided under customer_mobile.

notify_email

string

true

if "Yes", email will be sent to the emaiId provided under customer_email

customer_email

string

false [Required when notify_email is "Yes"]

email notification will be sent to the given email id

phone_code

string

false

[Required when customer_mobile field is not empty]

The country phone code in international format. Examples: +971,971,91,+91

customer_mobile

string

false

[Required when notify_sms is "Yes"]

Sms notification will be sent to the given mobile number

receipt_no

string

false

Any (self reference for each payment link)

Support

Visit https://www.foloosi.com for support requests or email to [email protected].

Developed by

Foloosi Technologies Pvt Ltd.

License

Copyrights (c) 2025 Foloosi

Last updated

Was this helpful?