דרישות מקדימות לביצוע עסקת TAP מול SDK

• רכישת מודול Tap On Phone בלבד
• נכון לשלב זה הפיצ'ר תומך במכשירי אנדרואיד בלבד
• רישום pindpad device בש.ב.א
• אנדרואיד – מכשיר חייב לכלול NFC
• אנדרואיד – יש לאפשר גישה לשירותי מיקום
• אנדרואיד – יש לוודא שההגדרה של "אפשרויות מפתח" כבויה

הסבר כללי לשלבים חיוב TAP 

1. כאשר האפליקציה עולה פעם ראשונה :
   1. לפנות לקארדקום API לקבלת פרטים וביצוע רישום למכשיר קצה.
   2. יש לבצע רישום למכשיר ל SDK  RegisterDevice.
2. בכול עסקת חיוב 
   1. לפנות למכשיר לביצוע חיוב כרטיס אשראי (100 ₪) עם התשובה שהתקבלו בשלב 1.a 
   2. קבלת תשובה והמכשיר ופנייה עם התשובה לקארדקום API.

הערה :

בשלב 1 יש תוקף ל  RegisterDevice , יש לבצע את שלב אחת לתקופה – מתקבל התוקף של ה Register  בעת הפנייה לפונקציה.

התקנה של הSDK  באפליקציה 

1. יש לדאוג שלאפליקציה של הרשאות הבאות :

<uses-permission android:name="android.permission.NFC" />

<uses-permission android:name="android.permission.INTERNET" />

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<uses-feature    android:name="android.hardware.nfc" android:required="false" />

1. הוספה של ה SDK לאפליקציה

את הקבצים מקבלים מאתנו  יש להוסיף תחת dependencies:

    implementation "com.denovo:topliteapp-PROD:3.0.1.2"

    implementation files("../libs/CardCom-v1.2.16-Release_Prod.aar")

ביצוע שלב 1.a , לפנות לקארדקום API לקבלת פרטים וביצוע רישום למכשיר קצה.

פניה לרישום מכשיר

פניה של XXXX SWAGER

תשובה 

ביצוע שלב 1.b יש לבצע רישום למכשיר ל SDK  RegisterDevice.

יש לבצע רישום למכשיר על ידי הפעלת הפונקציה  topService.registerDevice , ראה קוד לדוגמה בהמשך.

פרמטרים להפעלת :

פרמטרים שמקבלים ב onRegisterSuccess :

כאשר פג תוקף session_key , יש לבצע רישום מחדש למכשיר. session_created_timestamp + session_expire_time  גדול מהיום.

פרמטרים שמקבלים ב onRegisterError:

מומלץ להציג את הודעת השגיאה + קוד השגיאה למשתמש לשם ביצוע תחקור.

דוגמה לפנייה :

ToPService topService = new ToPService(Activity activity);

topService.registerDevice(tpn, merchantCode, new ToPService.onRegistrationListener() {

@Override

public void onProcess(String message) {

//UPDATE PROGRESS DIALOG message HERE

}




@Override

public void onRegisterSuccess(JSONObject successObject) {

//DISMISS PROGRESS DIALOG HERE




// sample success response

//{

//“message”: “Registration done successfully”,

//“session_key”: “xxxxxxxxxxxxxxxxxxxxxx”,

//“auth_token”: “xxxxxxxxxxxxxxxxxxxxxx”,

//“session_created_timestamp”:”1672038767”

//“session_expire_time”: “86400”

//}

}




@Override

public void onRegisterError(JSONObject errorObject) {

//DISMISS PROGRESS DIALOG HERE




// sample error response

{“error_code”: “403”,“error_message”: “Invalid TPN”}

}

});

שלב 1.b  ביצוע חיוב במכשיר

פנייה לחיוב topService.performTransaction

תשובה :

דוגמה לביצוע חיוב

}

"type": "REFUND" / "SALE",

"amount" "1.00",

"lang": "iw",

"CustomObject": {

"CustomerName": "Test Test",

"CustomerEmail": "test@test.test",

"PhoneNumber": "9999999999",

"HolderID": "999999999",

"AllowFullCardNumberInResponse": true,

"SapakMutavNumber": "123456",

"NumberOfPayments": 1,

"CreditType": 1

{

}




ToPService topService = new ToPService(Activity activity);

topService.performTransaction(inputObject, sessionKey,  new ToPService.OnTransactionListener() {

@Override

public void onTransactionResponse (JSONObject successObject){ 

//note: response_code:’00’ means Successful transaction other than ‘00’ means Failure transaction 

 }




@override

public void onTransactionError (JSONObject errorObject) {

 // sample error response

 //{

// “error_code”: “21”,

 //“message”: “Transaction Cancelled”

//}

}



@override

public void onRegisterNeeded (JSONObject errorObject) {

 // sample error response

 //{

 //“error_code”: “990”,

 //“message”: “Session key is expired, To authenticate, please re-initiate device registration api”

}

}

});

פניה לשרת קארדקום לרישום עסקה שלב 2.b

בקשה

תשובה

הערה ! אם יש תקלת תקשורת יש לבצע פנייה שוב !

אם התקבלה שגיאה – הכרטיס לא יחויב יש להציג חיוב נכשל

לאחר מכן יש לבצע רישום מכשיר פיזי ב API ורישום עסקאות מוצלחות לפי ממשק :

הסבר ממשק TapTransactions