Calling the SDK | API Developer Portal

Step1: How to call SDK?

Intent intent = new Intent(MainActivity.this, MorefunServiceActivity.class); Gson gson = new Gson(); String getdata = gson.toJson(dataModel); intent.putExtra("data", getdata); intent.putExtra("supportEncryption", true); startActivity(intent)

Notes:

The Login Id, ApiUserName, ClientID, ClientSecret, PassKey and Encryption key will be provided by iServeU which contains the user id and password details, please check the below example of the ClientID and ClientSecret.
skipReceipt field default value is false. If user wants to customize the transaction status page then the value should be true.
Please ensure the Client ID and Client Secret keys are not to be stored locally within the application. The same is only to be stored on the server side.
Client Transaction ID (ClientRefID) max length should be 18 digits and data type to be set as string.

Example:

Client_id - 42Zuw71Ok7e2TGAgHPKttM7PFGMspJLLy3ewq15dhgjtGM9l
Client_secret - MDB9krmA8OqYdgjTKflkXXU7BTNAJgVDEWBmhWjQ8YBvAPNKNPLbxnJGSKcKiEV9
Pass_key: NNK7BD3GVEEQSFC3AYJW544MFQT2F33DS7OG4NJHWCFOFTG2HCKA

For MOREFUN users, the device type should be

dataModel.setDevice_name = “morefun”

For PAX users, the device type should be

dataModel.setDevice_name = "pax"

For WISEASY users, the device type should be

dataModel.setDevice_name = "Wiseasy

Sample App View

Select POS as the type of transaction.
Select the appropriate Device needed for the transaction.
Fill in the details correctly.
Select Skip Receipt if you want to bypass the Receipt generation step.
Finally, click on POS button to proceed.

To be able to perform a POS transaction, the merchant must be Onboarded.

On the POS Onboarding page fill in all the necessary details (mandatory fields are marked with an * ).
Click on Proceed to go forward with the Onboarding process.

Initiate POS transaction.
Sale@POS is initiated.
Fill in the Customer Mobile Number and enter the Amount of the transaction.
Click on Submit to proceed with the transaction or click Cancel to abort

NOTE:

For Sale@POS the amount (should be greater than equal to 100 and less than equal to 100000) and the mobile number has to be filled in to proceed with the transaction.
The devices (MP-63, D-180, etc.) should be paired to the phone using Bluetooth. Below is a representation of the pairing process.

For PAX Devices:

The available devices will be displayed that can be connected via Bluetooth.
The Device IDs are displayed (as highlighted inthe image) and clicking on it will get them
connected and ready for transaction.

For MoreFun Devices:

Search for the device.
Click on IS CONNECT or DISCONNECT accordingly to connect or abort the connection respectively.
Device Connected shows the device that is connected and can be used for performing the transaction.

Step2: Required Parameters to be sent to the SDK

Name	Parameter Name	Description	Valid Values (Type) and Validation	Mandatory /Optional
Transaction Amount	transactionAmount	Transaction amount for cash withdrawal	Numeric. A minimum of 100 and a maximum of 10000.	Mandatory
Transaction Type	transactionType	Type of transaction to be performed.	String	Mandatory
Shop Name	shop_name	To be used as per client requirement.	Alphanumeric String	Optional
Brand Name	brand_name	To be used as per client requirement.	Alphanumeric String	Optional
Application Type	applicationType	Application Category	String	Mandatory
Param B	paramB	To be used by the client as per requirement	Alphanumeric String. Maximum length is 20.	Optional
Param C	paramC	To be used by the client as per requirement	Alphanumeric String. Maximum length is 20.	Not Mandatory
Device Type	device_type	Terminal brand name	String	Mandatory
Device Name	device_name	Terminal Model Number	String	Optional
API User Name	apiUserName	API User's name	String	Mandatory
Client Reference ID	ClientRefID	Reference ID of the Client.	Alphanumeric String. Maximum length is 18.	Mandatory
HeaderSecrets	headerSecrets	Will be generated by using client id and client secret provided by iServeU	Alphanumeric String	Mandatory
PassKey	passKey	Will be shared by iServeU	Alphanumeric String	Mandatory
Login ID	loginID	User application login ID or username	Alphanumeric String	Mandatory
Skip Receipt	skipReceipt	If client wants to skip the receipt downloading part.	Boolean. Default value is false. Set true to skip receipt download.	Mandatory

Data Model Java Class

public class DataModel { String transactionAmount; String transactionType; String shop_name; String brand_name; String applicationType; String paramB; String paramC; String device_type; String device_name; String apiusername; private String clientRefID; private String headerSecrets; private String passKey; String loginID; Boolean skipReceipt; public String getApiusername() { return apiusername; } public void setApiusername(String apiusername) { this.apiusername = apiusername; } public String getClientRefID() { return clientRefID; } public void setClientRefID(String clientRefID) { this.clientRefID = clientRefID; } public String getHeaderSecrets() { return headerSecrets; } public void setHeaderSecrets(String headerSecrets) { this.headerSecrets = headerSecrets; } public String getPassKey() { return passKey; } public void setPassKey(String passKey) { this.passKey= passKey; } public Boolean getSkipReceipt() { return skipReceipt; } public void setSkipReceipt(Boolean skipReceipt) { this.skipReceipt = skipReceipt; } public String getTransactionAmount() { return transactionAmount; } public void setTransactionAmount(String transactionAmount) { this.transactionAmount = transactionAmount; } public String getTransactionType() { return transactionType; } public void setTransactionType(String transactionType) { this.transactionType = transactionType; } public String getShop_name() { return shop_name; } public void setShop_name(String shop_name) { this.shop_name = shop_name; } public String getBrand_name() { return brand_name; } public void setBrand_name(String brand_name) { this.brand_name = brand_name; } public String getApplicationType() { return applicationType; } public void setApplicationType(String applicationType) { this.applicationType = applicationType; } public String getParamB() { return paramB; } public void setParamB(String paramB) { this.paramB = paramB; } public String getParamC() { return paramC; } public void setParamC(String paramC) { this.paramC = paramC; } public String getDevice_type() { return device_type; } public void setDevice_type(String device_type) { this.device_type = device_type; } public String getDevice_name() { return device_name; } public void setDevice_name(String device_name) { this.device_name = device_name; } public String getLoginID() { return loginID; } public void setLoginID(String loginID) { this.loginID = loginID; } }

Step3: Sample Code for passing the data through the data model.

Sample App View - POS:

NOTE:

For POS the Amount (Should be greater than equal to 100 and less than equal to 10000 ) and the Mobile Number have to be filled in to proceed with the transaction.

Please refer to the code sample below:

private void callPosSdk() { DataModel dataModel = new DataModel(); dataModel.setDevice_type(“morefun“); dataModel.setDevice_name(“morefun“); dataModel.setShop_name("itpl"); dataModel.setBrand_name("iServeU"); dataModel.setHeaderSecrets(" Refer Step 1 below for how to generate headersecrets"); dataModel.setSkipReceipt(false); dataModel.setTransactionAmount("101"); dataModel.setTransactionType("POS"); dataModel.setLoginID(“upitestret“); dataModel.setApiUserName(“apisdktestapi“); dataModel.setClientRefID(String.valueOf(new Random().nextInt())); dataModel.setParamB("branch1"); dataModel.setParamC("loanID1234"); dataModel.setPassKey("NNK7BD3GVEEQSFC3AYJW544MFQT2F33DS7OG4NJHWCFOFTG2HCKA"); dataModel.setUser_mobile_number(“9432461911“); PosSdkConstants.POSOnFinishListener = this; Intent intent = new Intent(MainActivity.this, MorefunServiceActivity.class); Gson gson = new Gson(); String getdata = gson.toJson(dataModel); intent.putExtra("data", getdata); intent.putExtra("supportEncryption", true); startActivity(intent); }

Step4: Override method to get the transaction data

User can check the Status & ClientRefID value using this Callback Method.

PosSdkConstants.POSOnFinishListener = this;

Implements POSOnFinishListener in the Activity where this below method will override.

@Override public void onPosSDKFinish(String callBackData) { } @Override public void onPosSDKError(String message) { }

Required Keys to get the transaction data from the Callback

Name	Description	Key name
flag	Status of the Transaction. E.g. - SUCCESS/FAILED	FLAG
Transaction Type	Type of transaction performed. Here it is “Sale@POS”.	TRANSACTION_TYPE
Transaction ID	Transaction ID	TRANSACTION_ID
Rrn no	12 digit RRN Number	RRN_NO
Response code	To be used by the client as per requirement	RESPONSE_CODE
Amount	Amount being transacted.	AMOUNT
MID	Merchant Identification Number	MID
TID	Terminal Identification Number	TID
Txn ID	Transaction ID	TXN_ID
Invoice	Invoice number for the transaction	INVOICE
Card type	Type of card used in transaction	CARD_TYPE
Appr code	Approval Code	APPR_CODE
Card number	Card Number used in the Transaction	CARD_NUMBER
Card holder name	Card holder name	CARD_HOLDERNAME
Shop Name	Name of the Shop	SHOP_NAME
Brand Name	Name of the Brand	BRAND_NAME
Status Code	Satus of the transaction. E.g. - 0 for SUCCESS and 1 for FAILED.	STATUS_CODE
Status Description	Description of the Status Code. E.g. - TRANSACTION SUCCESSFUL/ TRANSACTION FAILED	STATUS_DESC

An example of a successful transaction

{ "FLAG": "success", "TRANSACTION_ID": "1023948334970183680", "TRANSACTION_TYPE": "Sale@POS", "RRN_NO": "226918141134", "RESPONSE_CODE": "0000", "AMOUNT": "100", "MID": "IS0999999995469", "TID": "07002782", "TXN_ID": "1234567", "INVOICE": "1111111", "CARD_TYPE": "visa", "APPR_CODE": "123456", "CARD_NUMBER": "xxxx-xxxx-xxxx-9167", "CARD_HOLDERNAME": "", "BRAND_NAME": "iSUTest“, "SHOP_NAME": "Testing" }