Calling the Service App | API Developer Portal

Calling the Service App, parameters required and design data model class

Calling the Service App

Gson gson = new Gson(); String getData = gson.toJson(dataModel); try { PackageManager manager = getPackageManager(); Intent intent = manager.getLaunchIntentForPackage(packageName); intent.addCategory(Intent.CATEGORY_LAUNCHER); intent.setFlags(0); intent.putExtra("dataToService", getData); startActivityForResult(intent,80); }catch (Exception e) { Toast.makeText(this, "Application Not Found", Toast.LENGTH_SHORT).show(); }}

Call back function to get the transaction data and client ref id from AePS service APP

(KOTLIN CODE)

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) { super.onActivityResult(requestCode, resultCode, data) if (data != null && resultCode == RESULT_OK) { if (requestCode == 80) { var transactionData = "" var clientRefId = "" if (data.hasExtra("data")) { transactionData = data.getStringExtra("data").toString() } if (data.hasExtra("clientRefId")) { clientRefId = data.getStringExtra("clientRefId").toString() } } } }

(JAVA CODE)

@Override protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) { super.onActivityResult(requestCode, resultCode, data); if (data != null && resultCode == RESULT_OK) { if (requestCode == 80) { String transactionData = ""; String clientRefId = ""; if (data.hasExtra("data")) { transactionData = data.getStringExtra("data"); } if (data.hasExtra("clientRefId")) { clientRefId = data.getStringExtra("clientRefId"); } } } }

!NOTE:

The API_USER_NAME_VALUE, Client ID and Client Secret will be provided by iServeU.
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.

!NOTE:

-dataModel.bankCode = "common"(bankCode should be always “common”.)

- dataModel.transactionType = when{

       binding.rbBe.isChecked ->  "0"

       binding.rbCw.isChecked -> "1"

       binding.rbMini.isChecked -> "2"

       binding.rbAdhaarpay.isChecked -> "3"

       binding.rbCd.isChecked -> "4"

       else -> ""

   }

Transaction Type field will be added on parent application and it will be set in number format as mentioned below.
0 - BalanceEnquiry
1 - CashWithDrawal
2 - MiniStatement
3 - AadhaarPay
4 - CashDeposit

Required Parameters to be sent to the Service App

Please refer to AePS Parameter Description for further details.

Data Model Class of the Required data to be passed for kotlin

class DataModel { var applicationType: String? = null var userNameFromCoreApp: String? = null var clientRefID: String? = null var clientID: String? = null var clientSecret: String? = null var paramB: String? = null var paramC: String? = null var API_USER_NAME_VALUE: String? = null var SHOP_NAME: String? = null var BRAND_NAME: String? = null var location: String? = null var agent: String? = null var skipReceipt: Boolean? = null var transactionAmount: String? = null var transactionType : String? = null var bankCode : String? = null }

Data Model Class of the Required data to be passed for java

public class DataModel { private String applicationType; private String userNameFromCoreApp; private String clientRefID; private String clientID; private String clientSecret; private String paramB; private String paramC; private String API_USER_NAME_VALUE; private String SHOP_NAME; private String BRAND_NAME; private String location; private String agent; private Boolean skipReceipt; private String transactionAmount; private String transactionType; private String bankCode; public void setApplicationType(String applicationType) { this.applicationType = applicationType; } public void setUserNameFromCoreApp(String userNameFromCoreApp) { this.userNameFromCoreApp = userNameFromCoreApp; } public void setClientRefID(String clientRefID) { this.clientRefID = clientRefID; } public void setClientID(String clientID) { this.clientID = clientID; } public void setClientSecret(String clientSecret) { this.clientSecret = clientSecret; } public void setParamB(String paramB) { this.paramB = paramB; } public void setParamC(String paramC) { this.paramC = paramC; } public void setAPI_USER_NAME_VALUE(String API_USER_NAME_VALUE) { this.API_USER_NAME_VALUE = API_USER_NAME_VALUE; } public void setSHOP_NAME(String SHOP_NAME) { this.SHOP_NAME = SHOP_NAME; } public void setBRAND_NAME(String BRAND_NAME) { this.BRAND_NAME = BRAND_NAME; } public void setLocation(String location) { this.location = location; } public void setAgent(String agent) { this.agent = agent; } public void setSkipReceipt(Boolean skipReceipt) { this.skipReceipt = skipReceipt; } public void setTransactionAmount(String transactionAmount) { this.transactionAmount = transactionAmount; } public void setTransactionType(String transactionType) { this.transactionType = transactionType; } public void setBankCode(String bankCode) { this.bankCode = bankCode; } }

Sample Code for passing data through the data model

(SendDataToService- Kotlin)

private fun sendDataToService(packageName: String) { val dataModel = DataModel() dataModel.clientRefID = Random().nextInt().toString() dataModel.paramB = "" dataModel.paramC = "" dataModel.applicationType = "" dataModel.clientID = binding.clientID.text.toString().trim() dataModel.clientSecret = binding.clientSecret.text.toString().trim() dataModel.userNameFromCoreApp = binding.userName.text.toString().trim() dataModel.API_USER_NAME_VALUE = binding.apiUserName.text.toString().trim() dataModel.SHOP_NAME = "iServeU" dataModel.BRAND_NAME = "ITPL" dataModel.location = "Infocity,BBSR" dataModel.agent = "ISU Retailer" dataModel.bankCode = "common" dataModel.transactionType = when{ binding.rbBe.isChecked -> "0" binding.rbCw.isChecked -> "1" binding.rbMini.isChecked -> "2" binding.rbAdhaarpay.isChecked -> "3" binding.rbCd.isChecked -> "4" else -> "" } val gson = Gson() val getData = gson.toJson(dataModel) try{ val manager = packageManager val intent = manager.getLaunchIntentForPackage(packageName) intent!!.addCategory(Intent.CATEGORY_LAUNCHER) intent.flags = 0 intent.putExtra("dataToService", getData) startActivityForResult(intent,80) }catch(e: Exception){ Toast.makeText(this, "Application Not Found", Toast.LENGTH_SHORT).show() } }

(SendDataToService - Java)

private void sendDataToService(String packageName) { DataModel dataModel = new DataModel(); dataModel.setParamB(""); dataModel.setParamC(""); dataModel.setApplicationType(""); dataModel.setClientID(binding.clientID.getText().toString().trim()); dataModel.setClientSecret(binding.clientSecret.getText().toString().trim()); dataModel.setClientRefID(String.valueOf(new Random().nextInt())); dataModel.setUserNameFromCoreApp(binding.userName.getText().toString().trim()); dataModel.setAPI_USER_NAME_VALUE(binding.apiUserName.getText().toString().trim()); dataModel.setSHOP_NAME("iServeU"); dataModel.setBRAND_NAME("ITPL"); dataModel.setLocation("Infocity,BBSR"); dataModel.setAgent("ISU Retailer"); dataModel.setBankCode("common"); dataModel.setTransactionType( binding.rbBe.isChecked() ? "0" : binding.rbCw.isChecked() ? "1" : binding.rbMini.isChecked() ? "2" : binding.rbAdhaarpay.isChecked() ? "3" : binding.rbCd.isChecked() ? "4" : "" ); Gson gson = new Gson(); String getData = gson.toJson(dataModel); try { PackageManager manager = getPackageManager(); Intent intent = manager.getLaunchIntentForPackage(packageName); intent.addCategory(Intent.CATEGORY_LAUNCHER); intent.setFlags(0); intent.putExtra("dataToService", getData); startActivityForResult(intent,80); }catch (Exception e) { Toast.makeText(this, "Application Not Found", Toast.LENGTH_SHORT).show(); } }

Demo APP Link

https://liveappstore.in/shareapp?com.example.sdui_demo_kotlin=

Service APP Link

https://liveappstore.in/shareapp?com.aeps.aeps_api_user_sandbox=

Please do login to see details.