React JS

react-foloosi-widget
Foloosi Payment Gateway for your Online Business.
Install
with npm
npm install --save react-foloosi-widget
Usage
Foloosi Payment Gateway uses sensible defaults, so only minimal configuration via props is necessary.
Basic configuration
How to do configuration in your React Project?
Step 1
Initialize the Foloosi Payment like below.
import {Foloosi} from 'react-foloosi-widget';
​
class App extends Component {
 state = {
 foloosiOpen: false,
 reference_token:'YOUR_REFERENCE_TOKEN',
 merchant_key:'YOUR_MERCHANT_KEY'
 };
 foloosiHandler(e){
 if(e.data.status == 'success'){
 console.log(e.data);
 console.log(e.data.data.transaction_no);
 }
 if(e.data.status == 'error'){
 console.log(e.data);
 console.log(e.data.data.payment_status);
 }
 }
 componentDidUpdate(){
 window.addEventListener('message', this.foloosiHandler);
 }
 foloosiOpen(){
 this.setState({foloosiOpen: true});
 }
 render() {
 return (
 <div>
 <span onClick={e => this.foloosiOpen(e)}>Foloosi</span>
 <Foloosi foloosiOpen={this.state.foloosiOpen} foloosiClose={true} reference_token={this.state.reference_token} merchant_key={this.state.merchant_key}
 />
 </div> 
 );
 }
}
Step 2
Post the following data's in below API link to requesting reference token for accessing the payment gateway.
 POST API LINK :
 https://api.foloosi.com/aggregatorapi/web/initialize-setup
​
 HEADERS:
 merchant_key : YOUR_MERCHANT_KEY
​
 BODY:
 redirect_url : YOUR_REDIRECT_URL
 transaction_amount : YOUR_TRANSACTION_AMOUNT
 currency : YOUR_CURRENCY_CODE
 customer_name : OPTIONAL /*note : auto render in payment popup*/
 customer_email : OPTIONAL /*note : auto render in payment popup*/
 customer_mobile : OPTIONAL /*note : auto render in payment popup*/
 customer_address : OPTIONAL /*note : minimize form fields in card detail page*/
 customer_city : OPTIONAL /*note : minimize form fields in card detail page*/
Supported Currencies areas follows : AED, USD, EUR, INR If you need optional parameters, you can add it your own data option name and values in Body. The above POST request returns the Response like below. In that response, you will get Reference Token. After that you need to assign this Reference token variable globally as mentioned in Step 1.
Response
 {
 "message": "Application setup successfully",
 "data": {
 "reference_token" : "YOUR_REFERENCE_TOKEN",
 "payment_qr_data" : "YOUR_PAYMENT_QR_DATA",
 "payment_qr_url" : "YOUR_PAYMENT_QR_URL"
 }
 }
Step 3
When you click place order button our popup will be loaded so you can use test card credentials from test card section to complete the order.
note: Test card is valid only for test mode
Step 4 (Optional)
For Transaction List details, you can use the below Get request to get the transaction based on your merchant key.
 GET API LINK:
 https://api.foloosi.com/v1/api/transaction-list
​
 HEADERS:
 secret_key : YOUR_SECRET_KEY
For Transaction Details, you can use the below Get request to get the transaction detail.
 GET API LINK:
 http://api.foloosi.com/v1/api/transaction-detail/YOUR_TRANSACTION_ID
​
 HEADERS:
 secret_key : YOUR_SECRET_KEY
Note
If you want to fetch customer detail and customer card details along with transaction details change the above API v1 to v2. 
Props
React Foloosi default props to provide a dynamic experience to open a payment widget and allow user to make a payment via Credit/Debit Card.
foloosiOpen - Boolean - toggles the popup open state (see above example)
foloosiClose - Boolean - Enables the popup close option state (see above example)
reference_token - String - sets the Reference Token as reference_token state (Check our Foloosi API in your Merchant Panel)
merchant_key - String - sets your Merchant Key as merchant_key state (Check your Profile in Foloosi Merchant Panel to know the Merchant Key)
Success and Error Handlers
React Foloosi gives you the handlers for Payment status and details.
After Payment done, the below line sends the Payment details and status to foloosiHandler function.
window.addEventListener('message', this.foloosiHandler);
You can get the Payment status in the below function, it may be success or error.
 foloosiHandler(e){
 if(e.data.status == 'success'){
 console.log(e.data);
 console.log(e.data.data.transaction_no);
 }
 if(e.data.status == 'error'){
 console.log(e.data);
 console.log(e.data.data.payment_status);
 }
 }

CLIENT SIDE INTEGRATIONS - Previous

Javascript Integration

Next - CLIENT SIDE INTEGRATIONS

Angular JS

Last modified 3mo ago

Copy link

On this page

react-foloosi-widget

Install

Usage