CALL BANKING APPLICATION MODULE

IN EDC PAX A920

IT Android Programmer Division

PAX TECHNOLOGY INDONESIA
2019
CONTENTS

Contents ……………………………………………………………………… 1
I Revision Control ……………………………………………………… 2
II System Design ………………………………………………………… 3
III API Request Introduction ……………………………………………… 4
IV API Request Specification …………………………………………….. 5
V Digital Signature …………………………………………………........ 7
VI API Response Introduction …………………………………………….. 8
VII API Response Specification ………………………………………….. 10

1
I. REVISION CONTROL

Date Version By Division Remarks

19-03-2019 1.0 Chandra Aditya IT Manager First Draft

Ditya Geraldy IT Programmer

Jonathan Edward IT Support

2
II. SYSTEM DESIGN

3
III. API REQUEST INTRODUCTION

To call features on banking application from other applications, using Intent.

For BNI application, name of the intended package is "com.pax_bni_module.edc",
example:
Intent launchIntent =
getPackageManager().getLaunchIntentForPackage("com.pax_bni_module.edc");

For parse data using .putExtra(“name”, “value”), example:

launchIntent.putExtra("app", "moka");
Data type of value always String.

For execute intent using startActivity(“intent”), example:

startActivity(launchIntent);

4
IV. API REQUEST SPECIFICATION
Descriptions of parse variable :
1. Logon

Name Value Description Type

app moka Static

menu logon Static

Dynamic
DateTime 09012019110045 DDMMYYYYhhmmss

signature xxx explanation below Dynamic

2. Sale

Name Value Description Type

app moka Static

menu sale Static

amount 5000 Dynamic

Dynamic
tipAmount 1000

5
 Dynamic
DateTime 09012019110045 DDMMYYYYhhmmss

signature xxx explanation below Dynamic

3. Void

Name Value Description Type

app moka Static

menu void Static

Dynamic
DateTime 09012019110045 DDMMYYYYhhmmss

signature xxx explanation below Dynamic

4. Settlement

Name Value Description Type

app moka Static

menu settlement Static

6
 Dynamic
DateTime 09012019110045 DDMMYYYYhhmmss

signature xxx explanation below Dynamic

7
V. DIGITAL SIGNATURE

Generate using HMAC SHA256.

Secret key : 0000000000000000
Format : DateTime + EDC Serial Number + App + Menu
Example : 190320191338010820135747mokasale
Date Time → 19032019133801 → DDMMYYYYhhmmss
EDC Serial Number → 0820135747
App → moka
Menu → sale
Signature:
D86BD673283AF91B9335C39A0D87CCAD72FAA264B600AE1280B1CFAA12ED
7C17

To get EDC Serial Number :

import com.pax.dal.IDAL;
import com.pax.dal.entity.ETermInfoKey;

IDAL dal = NeptuneLiteUser.getInstance().getDal(this);

String serialNumber = dal.getSys().getTermInfo().get(ETermInfoKey.SN);

8
VI. API RESPONSE INTRODUCTION
The return value from banking application will return via broadcast, so the caller
application needs to add a service to recieve the broadcast.
For BNI application, name of the broadcast is "swi.broadcast.BNI_APP "
Example:
Androidmanifest.xml
<receiver android:name="com.pax.market.api.MyReceiver">
<intent-filter>
<action android:name="swi.broadcast.BNI_APP" />
</intent-filter>
</receiver>

Class MyReceiver using extends BroadcastReceiver.

9
VII. API RESPONSE SPECIFICATION

The value of the banking application process, can be taken at

.getStringExtra(“name”).
Example :
@Override
public void onReceive(Context context, Intent intent) {
String app = intent.getStringExtra(“App”);
String response = intent.getStringExtra(“Respon”);
}
Data type of data always String.
Descriptions :

Name Data Description Type

App com.broadcast.BNI_APP static

transaction
Respon OK success dynamic

FAIL transaction failed

explanation
Data xxx below dynamic

10
Format data :
Terminal ID + | + Merchant ID + | + PAN number + | + Expiry + | + Entry Mode
+ | + Transaction Type + | + Batch Number + | + Trace Number + | + Date + |
+ Time + | + Reference Number + | + Approval Code + | Total Amount + |
Example :
00000001|000000000002|DEBIT|553210**********5437|EXPDATE :
08/17|SWIPE|SALE|000003|000004|06Mar2012|10:52:58|123456789012
|12345|5,000|
Terminal ID → 00000001
Merchant ID → 000000000002
Card Type → DEBIT
PAN number → 553210**********5437
Expiry → EXP DATE : 08/17
Entry Mode → SWIPE
Transaction type → SALE
Batch Number → 000003
Trace Number → 000004
Date → 06Mar2012 → DDMMMYYYY
Time → 10:52:58 → hh:mm:ss
Reference Number → 123456789012
Approval Code → 123456
Total Amount → 5,000

11