Foloosi
  • INTRODUCTION
  • FEATURES
  • Get Started
    • Create Api Credentials
    • Checkout Page Customization
  • Payment Methods
    • Popup Payment Method
    • Hosting Payment Method
    • Saved Card Payment Method
  • CLIENT SIDE INTEGRATIONS
    • Javascript Integration
      • Create Payment Token
      • Payment Widget Initialization
      • Payment Response Handling
      • Additional Setup
      • Sample Integrations
    • PHP Integration
      • Create Payment Token
      • Payment Widget Initialization
      • Payment Response Handling
      • Additional Setup
      • Sample integrations
    • React JS Integration
      • Create payment Token
      • Payment Widget Initialization
      • Payment Response Handling
      • Additional Setup
    • Angular JS Integration
      • Create payment Token
      • Payment Widget Initialization
      • Payment Response Handling
      • Additional Setup
  • ECOMMERCE INTEGRATIONS
    • WooCommerce
    • CS Cart
    • Ecwid
    • Opencart
    • Magento
    • Prestashop
  • MOBILE SDK INTEGRATIONS
    • Android SDK
      • Initiate Payment
      • Payment Response Handling
    • iOS SDK
      • Initiate Payment
      • Payment Response Handling
    • React Native SDK
      • Make Payment
    • Flutter SDK
      • Installation
      • Make Payment
      • Sample Dart Program
  • SUBSCRIPTIONS
    • Foloosi Subscription for WooCommerce
    • Api Subscription
      • Sample Integration
    • Subscription
  • WEBHOOKS
  • PARTNER PAYOUT
  • CARD DETAILS
    • Test Cards
Powered by GitBook
On this page
  • a. Make Payments via order object
  • b.Make Payments with reference token
  • Get Reference Token
  • Support
  • Developed by
  • License

Was this helpful?

  1. MOBILE SDK INTEGRATIONS
  2. Android SDK

Initiate Payment

This Section briefs about how to initiate a payment !

Foloosi's Android SDK provides easy payment collections.

You can use it on the front-end to open payment page or use the actual flow to create Payment Token

Step - 1 - Add Dependency

We distribute our SDK from the Maven Central Repository. To begin with this SDK opens your build.gradle file of Module:app and adds the following dependency.

implementation 'com.foloosi:FoloosiSDK:2.0.28'

Step - 2 - Initialize SDK

To initialize the SDK add the codes below with the merchant key (Taken from foloosi merchant panel). If you do not have a merchant key create a new one and customize the checkout page to your liking.

 InitData initData = new InitData();
 initData.setMerchantKey(merchantKey); //YOUR MERCHANT KEY
 initData.setCustomColor(customColor); // SDK CUSTOM COLOR

 FoloosiPay.init(this, initData);

Step - 3 - Implement Payment Listener

Set and Implement our payment listener to receive payment results for every payment.

//Setting payment listener (paste this line after init() method)
FoloosiPay.setPaymentListener(this);

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

a. Make Payments via order object

Create Order Data Object with Necessary Inputs

You can create the OrderData 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.

OrderData orderData = new OrderData(); // Foloosi Order Data Model Class Instance
orderData.setOrderAmount(Double.parseDouble(amount)); // in double format ##,###.##
Random rand = new Random();
int orderId = rand.nextInt(100000);
orderData.setOrderId(String.valueOf(orderId)); // unique order id. 
orderData.setOrderDescription("Mobile Phone");  // any description.
orderData.setCurrencyCode(currencyCode);
orderData.setCustomerUniqueReference(""); //Customer Unique Reference value should be email/mobile no/uniqueCustomer id from your DB
Customer customer = new Customer();
customer.setName("name");
customer.setEmail("[email protected]");
customer.setMobile("1234567890");
orderData.setCustomer(customer);

*Important Note*

orderData.setCustomerUniqueReference("") value MUST be customer id/email/mobile number for saved card feature.

Now make payments with order data you created above.

 FoloosiPay.makePayment(orderData);

b.Make Payments 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

{
 "message": "Application setup successfully",
 "data": {
   "reference_token":
   "U0sjdGVzdF8kMnkkMTAkM21LRi0xZGliVDhldTV4NHlZSm9tZXZobnZxWTNEVnZmay1MdHNndTNFenNBTDU0clhWYkccVE4jRkxTQVBJNWM3Njk2ZDkwOWIzNxxSVCMkMnkkMTAkQXZ4ay9wdjlpTFlYLzRSZ2FjSkxpZWhHb2o0U0wvTFpZNXAyVjRGOVFycWNQZ2lHQ3VEZ08="
  }
 }
{
    "message": "Invalid Integration settings! Kindly check both foloosi merchant application settings and your integration keys"
}
{
    "message": "Invalid secret key"
}
{
    "message": "No routes found"
}

Make the payment with order reference token.

String referenceToken = "Your Reference Token";
FoloosiPay.makePaymentWithReferenceToken(referenceToken);

Api Specification

  • Request call must be on POST.

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

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

Post Request Body

customer_unique_identifier

  1. This is mandatory when you are using saved card payment.

  2. This data must be Unique like email id,customer id, etc.,

Support

Developed by

Foloosi Technologies Pvt Ltd.

License

Copyrights (c) 2025 Foloosi

PreviousAndroid SDKNextPayment Response Handling

Last updated 1 month ago

Was this helpful?

Visit for support requests or email to [email protected].

https://www.foloosi.com