Create payment Token

Let's see how to create a payment reference token

Initialize Api

Get Reference Token

POST https://api.foloosi.com/aggregatorapi/web/initialize-setup

Headers

Name	Type	Description
secret_key*	String	Your Merchant Key get from Foloosi Panel

Request Body

Name	Type	Description
currency*	String
transaction_amount*	Double
customer_name	String
site_return_url	String
customer_unique_identifier	String
billing_country	String
billing_postal_code	String
billing_state	String
customer_city	String
customer_address	String
customer_mobile	String
customer_email	String
partner_unique_reference	String	partner unique ID

200: OK Success Response

{
 "message": "Application setup successfully",
 "data": {
   "reference_token":
   "U0sjdGVzdF8kMnkkMTAkM21LRi0xZGliVDhldTV4NHlZSm9tZXZobnZxWTNEVnZmay1MdHNndTNFenNBTDU0clhWYkccVE4jRkxTQVBJNWM3Njk2ZDkwOWIzNxxSVCMkMnkkMTAkQXZ4ay9wdjlpTFlYLzRSZ2FjSkxpZWhHb2o0U0wvTFpZNXAyVjRGOVFycWNQZ2lHQ3VEZ08="
  }
 }

401: Unauthorized Invalid Header response

{
    "message": "Invalid secret key"
}

401: Unauthorized Invalid Api mode

{
    "message": "Invalid Integration settings! Kindly check both foloosi merchant application settings and your integration keys"
}

404: Not Found Invalid request type

{
    "message": "No routes found"
}

Api Specification

• Request call must be on POST.

• This Api will be used to confirm the feature you are about to Use.

• For Hosting Payment Method, You need to pass your callback URL in site_return_url.

• For Saved Card Payment Method, You need to pass your customer unique details like email,etc. to customer_unique_identifier.

Post Request Body

Request Body	Description
site_return_url	If you are using hosting payment, this is mandatory. Otherwise, this is an optional field. It must be a String. Get's the payment response after payment complete. click here to learn about Hosting Payment Page.
customer_unique_identifier	This is mandatory when you are using saved card payment. This data must be Unique like email id,customer id, etc.,
partner_unique_reference	This is mandatory when the tarnsaction is based on partner flow.

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