Make Payment

Step 1 - Initiate SDK

var initData = {
          "merchantKey": "Your Merchant Key",
          "customColor": "#1E8449",
        };
   await FoloosiPlugins.init(json.encode(initData));

sample escape string

merchantKey: 'key_\$2\$1\$1xxxxxxxxxxxxxxxxxxxxx'

Important Note - You can Follow any one of the methods below to initiate payment widget

a. Make Payment with order object

Create Order Data Object with necessary inputs

You can create the order data or payment input with our OrderData Model class. Here you need to provide order id, title, description, currency code, order amount and customer details like name, email and mobile number.

var orderData = {
          "orderId": "521",
          "orderDescription": "Order Description",
          "orderAmount": double.parse(amountTextField.text),
          "state": "",
          "postalCode": "",
          "country": "ARE",
          "currencyCode": "AED",
          "customerUniqueReference": "",
          "customer": {
            "name": "Foloosi Test",
            "email": "[email protected]",
            "mobile": "501234567",
            "code": "",
            "address": "",
            "city": "",
          },
        };
var result = await FoloosiPlugins.makePayment(json.encode(orderData));
if (kDebugMode) {
          print("Payment Response: $result");
}

*Important Note*

orderData.customerUniqueReference = "Unique value"

// Unique value must be customer id/email/mobile number for saved card feature.

Now make payment with order data you created above.

b.make Payment with 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
transaction_amount*	Double
customer_unique_identifier	String
customer_mobile*	String
customer_email*	String
customer_name*	String
currency*	String
billing_state	String
customer_city	String
customer_address	String
billing_country	String
billing_postal_code	String
source*	String (ios_sdk)	For apple pay "ios_sdk" should be passed

200: OK success response

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

401: Unauthorized Invalid Api mode

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

401: Unauthorized Invalid Header response

{
    "message": "Invalid secret key"
}

404: Not Found Invalid request type

{
    "message": "No routes found"
}

var referenceToken = "YOUR REFERENCE TOKEN";
var result = await FoloosiPlugins.makePaymentWithReferenceToken(referenceToken);
if (kDebugMode) {
          print("Payment Response: $result");
}

Api Specification

• Request call must be in POST.

• With this api only your going to confirm which feature you are using.

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

Post Request Body

​

Name	Description
customer_unique_identifier	It is mandatory when you are using saved card payment. It must be Unique like email id,customer id, etc.,

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