SDK Instance

You can find our SDK here:

https://posapi.s3.amazonaws.com/flexiti-pos-api-js-sdk-v2.esm.js
- To be used with frameworks that require ESM modules
https://posapi.s3.amazonaws.com/flexiti-pos-api-js-sdk-v2.js
https://posapi.s3.amazonaws.com/flexiti-pos-api-js-sdk-v2.zip

In order to create a widget instance through the FlexitiSDK, you should use the following:

var FlexitiSdk = new FlexitiSdk({
  clientId: {{your_client_id}},
  accessToken : {{access_token}},
  iframeContainer: {{container_id}},
  env:"training", // use 'mi' for Merchant Integration, use 'prod' for Production
  failureCallback: handleCallbackFailure,
  cancelCallback: handleCallbackCancel,
  successCallback: handleCallbackSuccess,
});

function handleCallbackSuccess (data) {
  console.log("successCallback:", data);
  alert('Success');
}

function handleCallbackFailure (data) {
  console.log("failureCallback:", data);
  alert('Failure');
}

function handleCallbackCancel (data) {
  console.log("cancelCallback:", data);
  alert('Cancel');
}

Parameters

Parameter	Required	Details

Parameter	Required	Details
clientId	Yes	ASCII string (100) From the Developer Portal account settings.
accessToken	Yes	ASCII string OAuth token given by the POST /oauth/token, it should be called by the merchant on server side. For more information click here.
iframeContainer	Yes	ASCII string ID of the html element used as the container `<div id=”{{iframeContainer}}”> //this is where the iframe will be created by the FlexitiSDK init method, and where the widget will be rendered. </div>`
env	Yes	ASCII string Determines which API environment is accessed by the SDK - Training or Production Available values: training, prod
failureCallback	Yes	ASCII string Function to handle flow failures to be implemented by the Merchant
cancelCallback	Yes	ASCII string Function to handle flow cancellations to be implemented by the Merchant
successCallback	Yes	ASCII string Function to handle flow successes to be implemented by the Merchant

Access Token Notes:

In order to control the data flow Flexiti takes the access_token as a referential value of the entire flow. Usually there are several steps before and after reaching this widget implementation so:

Once you need to call to the first POS-API method, usually the GET /information, you must to call to the oAuth POST /token to get access.
You have to ensure to use a refreshed token in order to have all the time available to complete the flow once you reach the widget page.
Please refer to the Oauth 2 Authorization Method and Refresh Token documentation for refreshing tokens.