כל הזכויות שמורות לאינטרספייס בע"מ | חל איסור פרסום על מסמך זה © Interspace LTD

ברוכים הבאים לטרנזילה - מדריך למפתח

באמצעות הפלטפורמה של טרנזילה, סוחרים ובעלי אתרים נהנים מהפקת דוחות מתקדמים, ניהול ומעקב בזמן אמת של טרנזקציות, הפקה אוטומטית של חשבוניות חתומות אלקטרונית ותמיכה במגוון אמצעי תשלום כמו סליקת כרטיסי אשראי של חברות האשראי המובילות בארץ, פייפאל (Paypal) והוראות קבע בנקאיות.

טרנזילה הינה מערכת גמישה המאפשרת התממשקות למערכות ניהול Online או/ ו Offline בצורה פשוטה ונוחה.

ה-API הידידותי של טרנזילה מספק למערכות ובתי תוכנה את היכולת להתחבר בקלות לטרנזילה ולסלוק דרך היישומים שלהם במגוון אפיקי תשלום.

טרנזילה עומדת בתקני האבטחה הקפדניים ביותר, תקן PCI DSS LEVEL 1 מה שמאפשר לבתי התוכנה לעמוד בדרישות המחמירות של חברות האשראי.

 

 

היכרות עם ה-API של חברת טרנזילה

הפניה לטרנזילה מתבצעת על ידי שליחת טופס.

כדי לשלוח את פרטי כרטיס האשראי וכל פרט נוסף שברצונכם לשמור במערכת הניהול, יש ליצור טופס ( Form ) ב HTML , כאשר פעולה ה Action תשלח את הטופס ל URL:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

 

  • את הטופס יש לשלוח ב POST (ולא ב GET )

מתחת לפקודת  Action   יש להוסיף שורת קוד נוספת שתשמש לזיהוי מקור שליחת הטופס ולשייכו למסוף וחשבון הטרנזילה המתאים  לדוגמא:

  • בשורה זו אין לשנות דבר פרט לערך ב VALUE , המכיל את שם המסוף.
  • כל המשתנים /פרמטרים נוספים צריכים להיות מוגדרים בצורה דומה.
  • ניתן לשלוח פרמטרים חופשיים, אותם יש להגדיר במסוף בהגדרות > מסוף> שדות נוספים לעסקה
  • את הטופס יש לשלוח מה-Server ולא דרך Client

יש להגדיר את כתובת ה IP של השרת השולח את הבקשות לטרנזילה במסוף > הגדרות > מסוף > שיטת עבודה

 

 

 

  • הודעת שגיאה אפשרית:  

An error ocurred with the following message: Transactions are not allowed from this location 

 

המשמעות היא שכתובת ה IP של השרת ששולח את הטרנזקציות אינה מעודכנת במסוף בהגדרה הנ"ל.

 

ניתן לבדוק מהי כתובת ה IP ע"י שליחת הבקשה ל URL הבא:

https://secure5.tranzila.com/cgi-bin/remote.cgi?terminal=test&sum=1&currency=1

  • יש לשנות את הערך של שם המסוף עבור terminal

 

 

 

תשלום דרך Apple Pay

הטמעת תשלום דרך Apple Pay

כחלק מפתרונות סליקת האשראי של חברת טרנזילה, אנו מאפשרים לשלב תשלום דרך Apple Pay.
תשלום דרך Apple Pay  מאפשר ללקוחות לשלם בלחיצת כפתור דרך מכשירי Apple.
ניתן לשלב את התשלום כחלק מאפליקציה, חנות E-commerce או דף נחיתה במגוון דרכים.
 

במדריך זה נתאר את הדרכים בהן ניתן להטמיע תשלום Apple Pay.

הנחות יסוד:

שיטת התשלום נתמכת רק על ידי מכשירי APPLE עם Touch ID או Face ID, או המחוברים באותה רשת למכשיר APPLE  עם Touch ID או Face ID.
מכשירים אלה כוללים מכשירי APPLE מסוג IPHONE, IPAD ומחשבים ניידים של APPLE  עם מצלמה ו/או קורא טביעת אצבע לצורך זיהוי המשתמש.

ניתן לראות רשימה מלאה של המכשירים הנתמכים כאן.

שיטת התשלום נתמכת רק בתוכנות של APPLE על מכשירים אלה – להלן: אפליקציות או דפדפן ספארי. כלומר, משתמשים בדפדפן CHROME, לא יכולים לשלם ב APPLE PAY.

תשלום דרך Apple Pay – הסבר כללי:

בישראל, תשלום עם APPLE PAY הוא במהותו תשלום בכרטיס אשראי, כאשר APPLE מספקת את תשתית האימות זהות המשתמש לעסקה בלבד. לאחר קבלת אישור מ APPLE לביצוע התשלום, מועברת התנועה לעיבוד על ידי חברת שב"א.

לאחר אימות העסקה מול APPLE, מעבירה חברת APPLE לשב"א, דרך טרנזילה, טוקן המשמש לחיוב, כאשר את תרגום הטוקן של APPLE למספר הכרטיס האמיתי, מבצעת חברת שב"א/מנפיק הכרטיס.

מכיוון שכך, התשובה לעסקת APPLE, היא התשובה הרגילה לעסקת אשראי מול שב"א וכוללת את השדות החוזרים מעסקת כרטיס אשראי רגילה

עבור לקוחות טרנזילה העובדים עם טוקנים, טרנזילה מתייחסת לטוקן APPLE כמספר כרטיס אשראי רגיל, מצפינה אותו בשרתיה ומחזירה אותו בשירות החיוב כטוקן של טרנזילה לשימוש חוזר

מסלול החיוב ב APPLE PAY שונה בין חיוב מתוך אפליקציית NATIVE לבין חיוב דרך דף אינטרנט. במסמך זה יפורטו המסלולים השונים לביצוע עסקאות אלו.

 

תשלום Apple Pay דרך דף סליקה של טרנזילה – Direct/Pay

ניתן לבצע דרכינו תהליך רישום פשוט לשירות Apple Pay - אתם לא זקוקים לבצע כלום מהצד שלכם!
אנחנו לאחר הרישום שלכם לשירות נוסיף לכם את הכפתור לדפי סליקה שלנו pay.tranzila.com/terminal או direct.tranzila.com/terminal

דרישות מהסוחר:


- מסוף פעיל לסליקת אשראי בטרנזילה, מאושר עם מספר ספק אינטרנטי.

תהליך ההטמעה וביצוע עסקה:


מערכת טרנזילה תטפל בביצוע העסקה וניתן יהיה לצפות בה דרך My Tranzila - שימו לב שה-4 ספרות האחרונות שמופיעות בממשק שלנו הן מזהה ה-Device של הלקוח ב-APPLE (אותו הוא יכול לראות בהגדרות Wallet שלו) ולא 4 ספרות אחרונות של הכרטיס שלו



הטמעת תשלום Apple Pay באתר - באמצעו Iframe/Hosted Fields

דרישות מהסוחר:


- מסוף פעיל לסליקת אשראי בטרנזילה, מאושר עם מספר ספק אינטרנטי.
-  על הסוחר לספק לטרנזילה את כתובת הדומיין/נים מהם תתבצע הסליקה.
- בהתאם, על הסוחר לשתול קובץ אימות שיסופק על ידי טרנזילה בכל אחד משרתי הדומיין/נים.
- יש לעדכן אותנו לאחר שתילת הקובץ, כדי שנוכל לבצע רישום של המסוף לשירות Apple Pay  דרך טרנזילה.

תהליך ההטמעה וביצוע עסקה:


1. הורדת קובץ אימות הנדרש להפעלת APPLE PAY JS LIBRARY, שאותו יש לשתול באתר שממנו מתבצע התשלום - הקובץ חייב להיות בתיקיה הזאת בשרת שלכם עם השם המקורי מהקובץ שאתם פותחים:
https://www.paymentwebsite.com/.well-known/apple-developer-merchantid-domain-association

ניתן להוריד את הקובץ מפה (יש לחלץ את הקובץ המכווץ ולשתול את קובץ הdat שבתוכו).

2. יש להטמיע ספריית JQuery שלנו בעמוד שמציג את הiframe:

<script>document.write('<script src="https://direct.tranzila.com/js/tranzilanapple_v2.js?v=' + Date.now() + '"><\/script>');</script>


אם יש בעיה של התנגשות מול קובץ JQuery קיים, מומלץ להוסיף את הסקריפט noConflict. כדאי לנסות עם ובלי הארגומנט true בפונקציה:

<script>document.write('<script src="https://direct.tranzila.com/js/tranzilanapple_v2.js?v=' + Date.now() + '"><\/script>');</script>
    <script>var $n = jQuery.noConflict(true);</script>

 

ביצוע תשלום דרך טופס Hosted Fields:

יש לבצע טיפול בEVENTS הבאים מצד האתר:
טרם הצגת מסך אימות המשתמש – קריאה לשירות /transaction/applepay/merchant/validate

לאחר אישור העסקה על ידי APPLE PAY וקבלת טוקן מ APPLE – קריאה לשירות /transaction​/applepay​/payment​/create

השירותים הנ"ל מפורטים במסמך api.yaml של טרנזילה -  ניתן להוריד אותו מפה.

עם קבלת תשובה על ביצוע העסקה מול טרנזילה (הצלחה או כישלון), יעדכן את APPLE בתוצאה.
בקרוב יעלו קטעי קוד שיעזרו לכם לבצע זאת בעצמכם.


כך נראה תהליך הרכישה:


 

 

 הטמעת תשלום Apple Pay באפליקצית IOS

דרישות מהסוחר:

  • מסוף פעיל לסליקת אשראי בטרזנילה, מאושר עם מספר ספק אינטרנטי.
  • למפתח האפליקציה חייב להיות חשבון developer פעיל ב APPLE
  • לצורך שימוש ב APPLE PAY, יש לייצר עבור האפליקציה מפתח merchant ומפתח אימות תשלום בעזרת חשבון הDeveloper באפל.
  • על מפתח האפליקציה להעביר את מפתח אימות התשלום לטרנזילה לצורך פענוח המידע החוזר מאפל עבור נתוני החיוב.
  • את תהליך התשלום יש לבצע באפליקציה עם ה APPLE PAY SDK.

 

תהליך ההטמעה וביצוע עסקה:

  1. מפתח האפליקציה יעצב, יאשר ויפתח את המסכים ואת תהליך החיוב ב APPLE PAY SDK
  2. לאחר הופעת חלונית האימות וביצוע אימות מול המשתמש באמצעים העומדים לרשות ההתקן (סיסמה, PIN, טביעת אצבע, זיהוי פנים), מקבלת האפליקציה טוקן לתשלום. טוקן זה הוא מבנה נתונים שלם ולא מספר או מחרוזת. דוגמא לטוקן כזה ניתן למצוא במסמך api.yaml של טרנזילה.
  3. את הטוקן הזה יש להעביר ל API של טרנזילה יחד עם פרטי העסקה כמפורט בתיעוד לשירות
    ​/transaction​/applepay​/payment​/create במסמך api.yaml של טרנזילה
  4. תשובת ה API  היא תשובה לעסקת אשראי רגילה של טרנזילה, המפורטת במסמך api.yaml של טרנזילה
  5. את פרטי העסקה ניתן לראות במערכת הניהול של טרנזילה my.tranzila.com


 

 

היכרות עם ה-API של חברת טרנזילה

הפניה לטרנזילה מתבצעת על ידי שליחת טופס.

כדי לשלוח את פרטי כרטיס האשראי וכל פרט נוסף שברצונכם לשמור במערכת הניהול, יש ליצור טופס ( Form ) ב HTML , כאשר פעולה ה Action תשלח את הטופס ל URL:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

 

  • את הטופס יש לשלוח ב POST (ולא ב GET )

מתחת לפקודת  Action   יש להוסיף שורת קוד נוספת שתשמש לזיהוי מקור שליחת הטופס ולשייכו למסוף וחשבון הטרנזילה המתאים  לדוגמא:

  • בשורה זו אין לשנות דבר פרט לערך ב VALUE , המכיל את שם המסוף.
  • כל המשתנים /פרמטרים נוספים צריכים להיות מוגדרים בצורה דומה.
  • ניתן לשלוח פרמטרים חופשיים, אותם יש להגדיר במסוף בהגדרות > מסוף> שדות נוספים לעסקה
  • את הטופס יש לשלוח מה-Server ולא דרך Client

יש להגדיר את כתובת ה IP של השרת השולח את הבקשות לטרנזילה במסוף > הגדרות > מסוף > שיטת עבודה

 

 

 

  • הודעת שגיאה אפשרית:  

An error ocurred with the following message: Transactions are not allowed from this location 

 

המשמעות היא שכתובת ה IP של השרת ששולח את הטרנזקציות אינה מעודכנת במסוף בהגדרה הנ"ל.

 

ניתן לבדוק מהי כתובת ה IP ע"י שליחת הבקשה ל URL הבא:

https://secure5.tranzila.com/cgi-bin/remote.cgi?terminal=test&sum=1&currency=1

  • יש לשנות את הערך של שם המסוף עבור terminal

 

 

 

ביצוע עסקה רגילה

 סוג פעולה:  עסקה רגילה

כתובת לפניה:

     https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת עיסקת חיוב רגילה:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&tranmode=A&ccno=12312312&expdate=0917&sum=15&currency=1&cred_type=1&myid=123456789&mycvv=123

רשימת השדות למשלוח:

 

תיאור השדה שם השדה
שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף) supplier
שדה זה מציין את סכום העסקה sum
שדה זה מציין את סוג העיסקה, יש לשלוח את הערך A tranmode
שדה זה מציין את מספר כרטיס האשראי המלא לעסקה ccno

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*יש לשלוח רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

 TranzilaPW
שדה זה מציין את מטבע העסקה, ערך 1 עבור ש"ח, ערך 2 עבור $ , ערך 978 עבור EURO , ערך 826 עבור פאונד currency
שדה זה מציין את תוקף הכרטיס (MMYY) expdate
שדה זה מציין את סוג האשראי, 1- אשראי רגיל,6-קרדיט, 8-תשלומים cred_type

שדה זה מציין את ערך ה CVV של כרטיס האשראי

* יש לשלוח שדה זה רק במידה ואתם נדרשים ע"י חברת האשראי

 mycvv
דה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי

* יש לשלוח שדה זה רק במידה ואתם נדרשים ע"י חברת האשראי

 myid

 

 

 

 

<?php
$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum 
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['ccno'] = '12312312'; // Test card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['mycvv'] = 'mycvv'; // number if required
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
	$query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
	die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
	foreach ($response_array as $value) {
		$tmp = explode('=', $value);
		if (count($tmp) > 1) {
			$response_assoc[$tmp[0]] = $tmp[1];
		}
	}
}
// Analyze the result string 
if (!isset($response_assoc['Response'])) {
	die ($result . "\n");
	/**
	 * When there is no 'Response' parameter it either means
	 * that some pre-transaction error happened (like authentication
	 * problems), in which case the result string will be in HTML format,
	 * explaining the error, or the request was made for generate token only
	 * (in this case the response string will contain only 'TranzilaTK'
	 * parameter)
	 */
} else if ($response_assoc['Response'] !== '000') {
	die ($response_assoc['Response'] . "\n");
	// Any other than '000' code means transaction failure
	// (bad card, expiry, etc..)
} else {
	die ("Success\n");
}
 
?>
 

ביצוע עסקת זיכוי

  

סוג פעולה:  עסקת זיכוי

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת עיסקת חיוב רגילה:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&CreditPass=test&tranmode=C1497&authnr=0000000&ccno=12312312&expdate=0917&sum=15&currency=1&cred_type=1&myid=123456789&mycvv=123

רשימת השדות למשלוח:

 

תיאור השדה שם השדה
שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף) supplier
שדה זה מציין את סכום העסקה לזיכוי sum
סוג המטבע הנסלק currency
דה זה מציין את סוג העיסקה, יש לשלוח את האות C ולאחריה את מספר אינדקס העיסקה המקורית שיש לזכות.

לדוגמא עבור עסקה מספר 123 יש לשלוח : C123

 tranmode
שדה זה מציין את מספר האישור שהתקבל מחברות האשראי authnr
שדה זה מציין את מספר כרטיס האשראי המלא לעסקה ccno
שדה זה מציין את סוג האשראי, 1- אשראי רגיל,6-קרדיט, 8-תשלומים cred_type
סיסמת זיכויים/ביטולים CreditPass

שדה זה מציין את ערך ה CVV של כרטיס האשראי

* יש לשלוח שדה זה רק במידה ואתם נדרשים ע"י חברת האשראי

 mycvv

שדה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי

* יש לשלוח שדה זה רק במידה ואתם נדרשים ע"י חברת האשראי

 myid

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*יש לשלוח רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

 TranzilaPW

 

 

 

<?php
$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['ccno'] = '12312312'; // Test card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['mycvv'] = 'mycvv'; //CVV number if required
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['CreditPass'] = 'CreditPass'; // Credit password
$query_parameters['authnr'] = '0000000'; // Authorization number
$query_parameters['tranmode'] = 'C1234'; // Mode of the transaction is C and the index of the transaction you want to credit
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
 

ביצוע אישור ללא חיוב / J5

סוג פעולה: עסקת אימות עסקה/  J5

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת עיסקת אימות J5:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&tranmode=V&ccno=1234567812345678&expdate=0917&sum=15&currency=1&cred_type=1&myid=123456789&mycvv=123

רשימת השדות למשלוח:

 

תיאור השדה שם השדה
שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף) supplier
שדה זה מציין את סכום העסקה sum
שדה זה מציין את מטבע העסקה currency
שדה זה מציין את סוג העיסקה, לעיסקת אימות יש לשלוח את הערך V tranmode
שדה זה מציין את מספר כרטיס האשראי המלא לעסקה ccno
שדה זה מציין את תוקף הכרטיס (MMYY) expdate
שדה זה מציין את ערך ה CVV של כרטיס האשראי mycvv
שדה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי myid
שדה זה מציין את סוג האשראי, 1- אשראי רגיל,6-קרדיט, 8-תשלומים cred_type

 

<!--?php
$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum 
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['ccno'] = '12312312'; // Test card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; // ID number
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['tranmode'] = 'V'; //Mode for verify transaction
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
	$query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
	die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
	foreach ($response_array as $value) {
		$tmp = explode('=', $value);
		if (count($tmp) > 1) {
			$response_assoc[$tmp[0]] = $tmp[1];
		}
	}
}
// Analyze the result string 
if (!isset($response_assoc['Response'])) {
	die ($result . "\n");
	/**
	 * When there is no 'Response' parameter it either means
	 * that some pre-transaction error happened (like authentication
	 * problems), in which case the result string will be in HTML format,
	 * explaining the error, or the request was made for generate token only
	 * (in this case the response string will contain only 'TranzilaTK'
	 * parameter)
	 */
} else if ($response_assoc['Response'] !== '000') {
	die ($response_assoc['Response'] . "\n");
	// Any other than '000' code means transaction failure
	// (bad card, expiry, etc..)
} else {
	die ("Success\n");
}
 
?>
 

עסקה מושהית J2

עסקה מושהית J2 מיועדת לבדיקת תקינות כרטיס בלבד.
הפיתרון מיועד למסופי EMV בלבד - במסוף בתקן אשראית יתבצע חיוב רגיל במקום.

עסקה מושהית מתחלקת לשתי אפשרויות:

  • עסקה מושהית J2 בודק שהכרטיס תקין ואיננו גנוב  – עסקה לבדיקה בלבד, לא ניתן לבצע עליה אילוץ. הכרטיס נבדק ברמת המסוף (בקבצי ההגדרות של המסוף) ולא ברמת חברת האשראי. מה שנבדק זה סוג הכרטיס (BIN - מקומי/תייר/סוג כרטיס/מותג), מספר כרטיס תקין LUHN (בדיקת תקינות מספר הכרטיס ברמה הלוקאלית) ובדיקת חסומים בקובץ המקומי של המסוף עצמו.
  • עסקה מושהית J5 תופס מהמסגרת אשראי של הלקוח כך שלא יהיה מצב בו ללקוח אין כסף בכרטיס האשראי בזמן שבעל העסק יאשר את העסקה.ניתן לבצע על עסקה זו אילוץ (לצורך חיוב)

סוג פעולה: עסקת השהיה J2

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת עיסקת השהיה J2:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&tranmode=Nccno=1234567812345678&expdate=0917&sum=15&currency=1&cred_type=1&myid=123456789&mycvv=123

רשימת השדות למשלוח:

 

 

יאור השדה שם השדה
שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף) supplier
שדה זה מציין את סכום העסקה sum
שדה זה מציין את מטבע העסקה currency
שדה זה מציין את סוג העיסקה, לעיסקת השהיה יש לשלוח את הערך N tranmode
שדה זה מציין את מספר כרטיס האשראי המלא לעסקה ccno
שדה זה מציין את תוקף הכרטיס (MMYY) expdate
שדה זה מציין את ערך ה CVV של כרטיס האשראי mycvv
שדה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי myid

 

  • ניתן לבצע את הבדיקה גם דרך דף הסליקה ( דיירקט/ IFRAME ) , יש לשלוח את השדה והערך הבאים בבקשה : tranmode=N
  • ניתן לשלוח בקשה ליצירת טוקן עם בדיקת תקינות הכרטיס ע"י שליחת השדה והערך הבאים tranmode=NK

 

 

עסקת אילוץ

סוג פעולה: אילוץ עסקה

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת עיסקת אילוץ:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&tranmode=F&index=1501&authnr=1523185&expdate=0917&sum=15&currency=1&=1&cred_type=1&myid=123456789&mycvv=123

רשימת השדות למשלוח:

 

תיאור השדה שם השדה
שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף) supplier

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

 TranzilaPW
שדה זה מציין את סכום העסקה sum
שדה זה מציין את מטבע העסקה currency
שדה זה מציין את סוג העיסקה, בעיסקה זו יש לשלוח את הערך F tranmode
שדה זה מציין את מספר האישור שהתקבל מחברות האשראי authnr
שדה זה מציין את אינדקס העיסקה index

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['ccno'] = '12312312'; // Test card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['mycvv'] = 'mycvv'; //CVV number if required
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['tranmode'] = 'F'; //Mode for verify transaction
$query_parameters['authnr'] = '0000000'; // Authorization number
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

ביצוע עסקאות תשלומים

סוג פעולה: עסקת תשלומים

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לעיסקת תשלומים:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=naamatest&tranmode=A&ccno=12312312&expdate=0917&sum=50¤cy=1&&=1&cred_type=8&myid=123456789&mycvv=123&npay=4&fpay=10&spay=10

  • מספר התשלומים שיש לשלוח בפרמטר npay הוא מספר התשלומים פחות 1

רשימת השדות למשלוח:

תיאור השדה שם השדה

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

supplier

שדה זה מציין את סכום העסקה

sum

שדה זה מציין את סוג העיסקה

tranmode

שדה זה מציין את מספר כרטיס האשראי המלא לעסקה

ccno

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

TranzilaPW

שדה זה מציין את מטבע העסקה

currency

שדה זה מציין את תוקף הכרטיס (MMYY)

expdate

שדה זה מציין את ערך ה CVV של כרטיס האשראי

mycvv

שדה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי ( 9 ספרות)

myid

שדה זה מציין את סוג האשראי, 8-תשלומים

cred_type

שדה זה מציין את סכום התשלום הראשון

fpay

שדה זה מציין את סכום כל תשלום לאחר התשלום הראשון

spay

שדה זה מציין את מספר התשלומים

npay

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['ccno'] = '12312312'; // Test card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['mycvv'] = 'mycvv'; //CVV number if required
$query_parameters['cred_type'] = '8'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['fpay'] = '1'; //First payment
$query_parameters['spay'] = '2'; //Following payments
$query_parameters['npay'] = '2'; //for payments transaction npay=number of payments-1, for credit transaction npay=number of payments
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

ביטול עסקה ב-API

  

סוג פעולה:  ביטול עיסקה

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת עיסקת חיוב רגילה:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&CreditPass=test&tranmode=D1499&authnr=0000000

תשובה שתתקבל:

Response=000&index=6609

 

רשימת השדות למשלוח:

 

תיאור השדה שם השדה
שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף) supplier

שדה זה מציין את סוג העיסקה, יש לשלוח את האות D ולאחריה את מספר אינדקס העיסקה המקורית שיש לזכות.

לדוגמא עבור עסקה מספר 123 יש לשלוח : D123

 tranmode
שדה זה מציין את מספר האישור שהתקבל מחברות האשראי authnr
סיסמת זיכויים/ביטולים CreditPass

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*יש לשלוח רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

 TranzilaPW

 

 

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['CreditPass'] = 'CreditPass'; // Credit password
$query_parameters['authnr'] = '0000000'; // Authorization number
$query_parameters['tranmode'] = 'D1234'; // Mode of the transaction is D and the index of the transaction you want to credit
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

סוגי משתנים ב-API

לטרנזילה קיימים 3 סוגים של קבוצות משתנים. את רשימת השדות המלאה ניתן לראות במסוף הסליקה > הגדרות > הגדרה 2 :

קבוצה 1 : משתנים הנוצרים כתוצאה מביצוע העיסקה

 

שם השדה תאור
Index מספר אינדקס העיסקה.זהו מספר רץ.
Date תאריך ביצוע העיסקה
Time שעת ביצוע העיסקה
Auth.nr. מספר אישור העיסקה שהתקבל מחברת האשראי
Issuer מותג נסלק
IPaddress כתובת IP ממנה בוצעה העיסקה
Ref.nr. מספר אישור שידור שב"א (אסמכתא)
Temp.ref. מספר שובר שב"א
Mode מצב עיסקה.
TranType סוג עיסקה
CVV-Status מצב CVV (נבדק/לא נבדק/הוזן/תקין/לא תקין)
ID-Status מצב ת.ז. (נבדק/לא נבדק/תקין/לא תקין/הוזן)
Source מקור אישור העיסקה
CardType סוג הכרטיס
Acquirer החברה הסולקת
ChildTerm שם מסוף בן

 

 

קבוצה 2 : שדות נדרשים שטרנזילה צריכה לקבל מטופס הלקוח

 

תאור שם השדה
סכום החיוב sum
מספר הכרטיס לחיוב ccno
תוקף הכרטיס- חודש expmonth
תוקף הכרטיס- שנה expyear
תוקף הכרטיס ב 4 ספרות , לדוגמה 0118 expdate
סוג התשלום (רגיל / תשלומים / קרדיט) cred_type
סוג המטבע לחיוב currency
שלושת הספרות בגב הכרטיס mycvv
ת.ז. של בעל הכרטיס myid
תשלום ראשון, במידה ומדובר בעיסקת תשלומים fpay
תשלום שני, במידה ומדובר בעיסקת תשלומים spay
מספר התשלומים, במידה ומדובר בעיסקת תשלומים npay

קבוצה 3 : שדות מוגדרים על ידי המשתמש (שדות חופשיים)

השדות בחלק זה הינם אופציונליים וביכולתך לעשות בהם שימוש למידע מכל סוג שהוא שברצונך לשמור במסד הנתונים.
ישנם 20 שדות המכילים עד 255 תוים בכל אחד מהם.
ביכולתך לבחור גם באיזה שם יוצג כל שדה במסך.

 

 

פרמרטים שחוזרים לאחר ביצוע עיסקה:

להלן דוגמא למחרוזת נתונים החוזרת בסיום ביצוע עיסקה ב API

 

 

פרמרטים שחוזרים לאחר ביצוע עסקה

פרמרטים שחוזרים לאחר ביצוע עיסקה:

להלן דוגמא למחרוזת נתונים החוזרת בסיום ביצוע עיסקה ב API

 

מניעת עיסקאות כפולות DCdisable

פיתרון המניעה המסתמך על ערך ייחודי שנשלח עבור עיסקה תחת הפרמטר DCdisable
להלן תנאי השימוש בפרמטר :

  1. הפיתרון מיועד לעבודה עם דף דיירקט /דיירקט רפסונסיבי/ IFRAME, PP
  2. יש להכנס למסוף > הגדרות> הגדרה 2 > חלק 3 ולהגדיר רק את שדה 20 (במסוף>הגדרות>הגדרות 2 חלק 3) כשדה המיועד לזיהוי DCdisable -חיוב כפול

  1. במידה ויזוהה שהערך הייחודי ב- DCdisable כבר עבר פעם אחת, לא יבוצע חיוב נוסף
  2. הבדיקה אצלנו ב DB תבוצע עד 24 שעות אחורה, ברמת מסוף אב.
  3. במידה ועיסקה נכשלה בפעם הראשונה, לא תתבצע עבורו בדיקה על DCdisable
  4. אנו נציג את ההודעה הבאה במידה וזוהתה עסקה כפולה: "תשלום זה בוצע בעבר,נא פנה לבית העסק" this payment has already been paid.please contact customer service
  5. על הלקוח להעביר את הפרמטר DCdisable עם ערך ייחודי לאותה עיסקה
  6. על הלקוח לשלוח את הפרמטר u71=1 במידה והוא עובד עם דף הדיירקט/ IFRAME
  7. במידה ויש לכם מסופי אב ובן,יש להגדיר את הפרמטר גם באב וגם בבן
  8. אנו ממליצים לספק ערך ייחודי ארוך ומורכב (המגבלה לערך היא 254 תווים)

 

 

שינוי IP דינאמי ללקוחות API עם כתובת IP לא קבועה

שינוי IP דינאמי מיועד ללקוחות העובדים ב API עם שרתי ללא כתובת IP משתנה (כגוון שרות ענן ,שרתי אמאזון וכ"ד).

כידוע, מטעמי אבטחה מסופי טרנזילה חוסמים כתובות שלא מוגדרות ברמת הגדרות המסוף.

כדי מצד אחד לתת פתרון ללקוח ומצד שני לשמור על רמת האבטחה פותח פתרון שינוי IP דינאמי.

  • עם הפתרון הזה ניתן, לדוגמה, לפני שליחת טרנזקציה לטרנזילה לשלוח קודם בקשה לשינוי IP עם שני פרמטרים (supplier ו-TranzilaPW) ל-tranzila31cl.cgi – ואז ניתן להיות בטוח שהכתובת ה-IP הנוכחית אכן פתוחה במסוף לקליטת עסקאות.
  • חשוב לציין שהפתרון הזה רלוונטי רק ללקוחות שעובדים ב-API.
  • במידה ולקוח טרנזילה עובד רק דרך דף סליקה או Iframe אז כתובת ה-IP שממנה הוא פונה למסוף הינה הכתובת של דף הסליקה\Iframe ואין צורך להשתמש בפיתרון הנ"ל.
  • ניתן להשתמש בפתרון רק אם  הונפקה סיסמאת עסקאות TranzilaPW עבור המסוף. כפי שכבר צוין יש להעביר אותה יחד עם פרמטר supplier שצריך להכיל ערך של שם המסוף.

 

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila31cl.cgi

דוגמה לשליחת בקשה לשינוי IP מהשרת שישלח את בקשת החיוב:

https://secure5.tranzila.com/cgi-bin/tranzila31cl.cgi?supplier=test&TranzilaPW=XYZ123

רשימת השדות למשלוח:

 

תיאור השדה שם השדה
שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף) supplier

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

 TranzilaPW

 דגשים:

  1. במסוף צריכה להיות מוגדרת סיסמא TranzilaPW.
  2. כתובת ה-IP שממנה התבצעה שליחה ל-tranzila31cl.cgi מתעדכנת במיידי עבור המסוף ותופיע בממשק המסוף בהגדרות > מסוף > שיטת עבודה (כל זה בתנאי שהאפשרות הזאת מסומנת בממשק ניהול המסוף).
  3. אם פעולת עדכון ה-IP עברה בהצלחה אז התסריט tranzila31cl.cgi מחזיר פרמטר "1”.

 

 

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila31cl.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
if ($result=='1') {
    die ("Success\n");
} else {
die ($result . "\n");
}
?>
 
 
 

מניעת עסקאות כפולות Dtran

מנגנון מניעת עסקאות כפולות Dtran , מתבסס על בדיקת נתוני עסקה בטווח זמן המוגדר בהגדרות המסוף.

במידה ותבחרו לעבוד עם פיתוח זה, יהיה עליכם להגדיר אך ורק את טווח הזמן ללא שליחת פרמטר מסויים.

בטווח הזמן שהוגדר, המערכת שלנו בודקת את פרטי העסקה שבוצעה ומזהה אם יש כפילות עבור אותה עסקה מסויימת.

את טווח הזמן כרגע ניתן להגדיר במערכת הישנה-secure5 בהגדרות הגדרה 1:

פרטי העסקה הנבדקים לזיהוי עסקה כפולה:

  • כל שדות העסקה יבדקו - כולל שדות נוספים לעסקה

דגשים:

  1. מנגנון זה מאפשר ללקוח להעביר את העסקה בפעם השניה כעסקה כפולה כמובן בטווח הזמן שהוגדר ולקבל את התגובה בפעם השניה בתוספת
  2. הפרמטר -  duplicate_transaction_detected  המציין את כפילות העסקה, מה שלא יתאפשר עם המנגנון של ה-Dcdisable.
  3. הפיתוח עובד רק עבור עסקאות שנשלחו ב API דרך tranzila71u.cgi או tranzila71pme.cgi
  4. לקוחות העובדים עם דף הסליקה שלנו, עליהם להעביר לדף הסליקה (יחד עם כל הפרמטרים), גם את הפרמטר u71=1
  5. אם זוהתה עסקה כפולה ויש כבר תשובה משב"א - תוחזר התשובה מהעסקה המקרוית + פרמטר duplicate_transaction_detected=1. אם אין עדיין תשובה משב"א על העסקה המקורית אז יוחזר 'Response=-96&reason=Double transaction detected. Please contact the company'
  6. העסקה שנחסמה תופיע במסוף ככישלון עם שגיאה 888 - נחסמה עסקה כפולה.

 

 

רשימת מוצרים לחשבונית (פירוט מוצרים)

במידה ורכשתם את מודול החשבוניות של טרנזילה, תוכלו להשתמש בפתרון פירוט רשימת מוצרים לחשבונית כדי להציג את הפריטים שנרכשו בשורות נפרדות ע"ג החשבונית.

דגשים לביצוע פירוט מוצרים:

  1. מחיר העסקה הסופי חייב להיות שווה למחיר המוצרים והכמויות שפורטו
  2. במידה והסכום לא  יהיה שווה,בחשבונית תופיע רשימת המוצרים ללא פירוט הסכום לכל מוצר.
  3. אם מוגדר אחוז מעמ כברירת מחדל, יש לבצע חילוץ מעמ ולשלוח מחיר פר מוצר כמחיר לפני מעמ
  4. בעבודה ב API יש לפנות ל CGI הבאים בהתאם:

מסוף רגיל (שאינו אקספרס)  https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

מסוף בשרות אקספרס https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi

מסוף המוגדר לעבודה עם PAYPAL ב API : https://secure5.tranzila.com/cgi-bin/tranzila31p.cgi

  1. להוספת פירוט מוצרים בדף סליקה דיירקט או Iframe יש לשלוח את הפרמטר u71=1

 

הערות לתצוגת פירוט מוצרים בחשבונית:

  1. קובץ PDF מופק לגודל A4, אם החשבונית גדולה מ A4 התצוגה תיחתך ולא תוצג במלואה.
  2. לחשבונית עם לוגו עליון בגודל 210*56 מ"מ, לוגו תחתון 110*51 מ"מ ושימוש בחתימה דיגיטלית, ניתן להכניס 6 מוצרים שיוצגו באופן תקין.
    במידה ומוותרים על לוגו תחתון או חתימה דיגיטלית יוצגו עד 10 מוצרים    .
  3. במידה ומקטינים או מגדילים את הלוגו התחתון או עליון או את שניהם, כמות המוצרים שתכנס לחשבונית תשתנה.
  4. תאור המוצר צריך לכלול עד 118 תווים. מעבר למספר התווים הזה, תהיה ירידת שורה.
  5. במידה ובתאור המוצר יש יותר מ 118 תווים ללא רווחים ביניהם , תאור המוצר יופיע כמחרוזת אחת אך החשבונית תוצג לרוחב.
  6. בהדפסת חשבונית מתוך מערכת טרנזילה (מתוך מודול החשבוניות) החשבונית תודפס על מספר דפים,בהתאם לכמות המוצרים המופיעה.(תאור מוצר רחב מידי יגרור את אותו אפקט שגורר בpdf)
  7. ניתן להגדיר את סוג המסמך להפקה כקובץ html ,הוא נוצר בגודל המתאים לחשבונית ללא תלות בכמות או אורך המוצרים.

 

מפרט טכני:

  1. יש ליצור מערך אובייקטים בjson בתצורה הבאה:
תאור שדה שם שדה
שם המוצר product_name
כמות המוצר (במספרים) product_quantity
מחיר המוצר product_price

לדוגמה:

[     {         "product_name":"product",         "product_quantity":1,         "product_price":1     },     {         "product_name":"product2",         "product_quantity":1,         "product_price":1     },     {         "product_name":"product3",         "product_quantity":1,         "product_price":1     },     {         "product_name":"product4",         "product_quantity":1,         "product_price":1     },     {         "product_name":"product5",         "product_quantity":1,         "product_price":1     } ]

 

מערך האובייקטים צריך להיות ללא רווחים או הורדת שורה, לדוגמה:

[{"product_name":"product","product_quantity":1,"product_price":1},{"product_name":"product2","product_quantity":1,"product_price":1},{"product_name":"product3","product_quantity":1,"product_price":1},{"product_name":"product4","product_quantity":1,"product_price":1},{"product_name":"product5","product_quantity":1,"product_price":1}]

  1. יש לבצע קידוד למערך האובייקטים (URL Encoder)

    * הקידוד צריך להיות זהה לקידוד הפונקצייה rawurlencode בphp ולא בדומה לפונקצייה urlencode בphp

    *הקידוד ב URL לא יכול להכיל את התו + כמו שעושה הפונקצייה urlencode  -היא מבצעת עבור רווחים קידוד ל+ במקום ל %20

לדוגמה:

 

%5B%7B%22product_name%22%3A%22product%22%2C%22product_quantity%22%3A1%2C%22product_price%22%3A1%7D%2C%7B%22product_name%22%3A%22product2%22%2C%22product_quantity%22%3A1%2C%22product_price%22%3A1%7D%2C%7B%22product_name%22%3A%22product3%22%2C%22product_quantity%22%3A1%2C%22product_price%22%3A1%7D%2C%7B%22product_name%22%3A%22product4%22%2C%22product_quantity%22%3A1%2C%22product_price%22%3A1%7D%2C%7B%22product_name%22%3A%22product5%22%2C%20%22product_quantity%22%3A1%2C%20%22product_price%22%3A1%7D%5D

  1. יש לשלוח תחת הפרמטר json_purchase_data

לדוגמה:

json_purchase_data=%5B%7B%22product_name%22%3A%22product%22%2C%22product_quantity%22%3A1%2C%22product_price%22%3A1%7D%2C%7B%22product_name%22%3A%22product2%22%2C%22product_quantity%22%3A1%2C%22product_price%22%3A1%7D%2C%7B%22product_name%22%3A%22product3%22%2C%22product_quantity%22%3A1%2C%22product_price%22%3A1%7D%2C%7B%22product_name%22%3A%22product4%22%2C%22product_quantity%22%3A1%2C%22product_price%22%3A1%7D%2C%7B%22product_name%22%3A%22product5%22%2C%20%22product_quantity%22%3A1%2C%20%22product_price%22%3A1%7D%5D


 

  • יש לשלוח את הנתונים ב POST כיוון שהדפדפן יכול לבצע פיענוח Decoder לקידוד ולשנותו.


 

 

קבלת תשובות בפורמט qstr או json

התשובות החוזרות לבקשות,חוזרות ב QSRT.

שגיאות מסויימות ברמה אפליקטיבית יחזרו ב HTML. באפשרותכם לקבל את התשובות ב QSTR או JSON .

הפיתוח רלוונטי לשימוש עבור בקשות הנשלחות לסקריפטים הבאים:

 

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi

**בשליחת שדה u71=1 לא ניתן להשתמש בפיתרון הנ"ל.

אלו הפרמטרים שיש לשלוח כדי לקבל את הנתונים בפורמט הרצוי

ערך אפשרי שם שדה

qstr

 response_return_format

json

 response_return_format

**שימו לב, פורמט תשובה הוא שונה

**במידה ולא תשלחו את אחד מהשדות הנ"ל , פורמט קבלת התשובה עבור שגיאה אפליקטיבית יהיה ב HTML .

**במידה ויישלחו הפרמטרים הנ"ל כל התשובה תחזור בפורמט המבוקש

 

דוגמא לתשובה עם שגיאה אפליקטיבית ב-qstr:

Response=20007&error_type=Authorization&error_msg=Not Authorized

 

דוגמא לתשובה עם שגיאה אפליקטיבית ב-json:

{"error_msg":"Not Authorized","error_type":"Authorization","Response":20007}

 

ההודעה מורכבת מ3 חלקים:

response = קוד שגיאה

error_type  = סוג שגיאה

error_msg  = תוכן של שגיאה

 

 

 

מודול מוחלפים

שליחת עסקת הו"ק – טכני

**הפיתוח רלוונטי אך ורק עבור מסופי EMV רגילים (לא מתאים לאקספרס), במסופי ריבוי (אשראית 96 ) העסקאות יזוהו כעסקאות חיוב רגילות.

** על המסוף להיות בעל מספר ספק הו"ק , מודול טוקנים, ולרכוש את מודול המוחלפים (נוהל מוחלפים)

  1. כדי שעסקה תזוהה כעסקת הו"ק ,יש לשלוח tranmode=J
    עסקת איתחול (עסקת J5 שמזוהה כהו"ק) ע"ס 1 ש"ח עם tranmode=J
    עסקת האיתחול מבצעת אימות לכרטיס וקובעת את החיובים הבאים כהו"ק, ולא יוצרת חיוב בפועל, לכן אין טעם להעביר אותה על יותר מסכום 1 ש"ח.
  1. לא יושם מספר התשלומים העתידי. מה שיושם הוא עסקת הו"ק ללא הגבלת מספר תשלומים עתידיים.
  2. אחרי עסקת האיתחול, יש להעביר את העסקאות הבאות כעסקאות אילוץ , במקום tranmode=F יש להעביר tranmode=A+index כלומר את הערך A עם מספר האינדקס של עסקת האיתחול .
  3. עסקת J לא מייצרת טוקן.
  4. כדי שללקוח יהיה טוקן , עליו לייצר לפני עסקת האיתחול את הטוקן ע"י שליחת בקשה ליצירת טוקן או ב API או דרך דף הסליקה. ניתן לייצר טוקן בעסקת חיוב מיידי AK , עסקת אימות VK או עסקת J2 ע"י שליחת NK

דוגמאות:

עסקת איתחול (אימות הו"ק)

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=naortest&cred_type=1&response_return_format=qstr&sum=5¤cy=1&ccno=5326XXXXXXXXXXXX&expdate=1231&mycvv=123&myid=123123127&TranzilaPW=XXXX&tranmode=J

תשובה שתתקבל:

Response=000&mycvv=0¤cy=1&myid=123123127&cred_type=1&ccno=5675&DclickTK=&supplier=naortest&expdate=1231&tranmode=J&sum=5&response_return_format=qstr&ConfirmationCode=0000000&index=14318&Responsesource=0&Responsecvv=3&Responseid=3&Tempref=79980001&DBFIsForeign=0&DBFcard=1&cardtype=1&DBFcardtype=1&cardissuer=1&DBFsolek=6&cardaquirer=6&tz_parent=naortest

 

עסקת חיוב חוזרת (אילוץ הו"ק)

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=naortest&cred_type=1&response_return_format=qstr&sum=5¤cy=1&ccno=5326XXXXXXXXXXXX&expdate=1231&mycvv=123&myid=123123127&TranzilaPW=XXXXX&tranmode=A14318

תשובה שתתקבל:

Response=000&mycvv=0¤cy=1&myid=123123127&cred_type=1&ccno=5675&DclickTK=&supplier=naortest&expdate=1231&tranmode=A14318&sum=5&response_return_format=qstr&ConfirmationCode=0000000&index=14319&Responsesource=0&Responsecvv=3&Responseid=3&Tempref=79920001&DBFIsForeign=0&DBFcard=1&cardtype=1&DBFcardtype=1&cardissuer=1&DBFsolek=6&cardaquirer=6&tz_parent=naortest

 

שליחת בקשה דרך IFRAME:

ניתן לשלוח בקשה לעסקת איתחול הו"ק גם דרך ה IFRAME, יש לשלוח את הפרמטר u71=1

לדוגמה:

https://direct.tranzila.com/naamatest/iframenew.php?sum=1¤cy=1&ppnewwin=2&u71=1&tranmode=J

** יש לוודא שהלקוח לא הגדיר בהגדרות דף הסליקה את הקאפטצ'ה פעילה, במידה וכן, תתקבל שגיאת SYSTEM ERROR


קבלת מוחלפים ואופן פעילות לאחר הטמעה:

1. אחת ליום, מערכת טרנזילה תבצע חיפוש לקבצי מוחלפים ללקוחות הרלוונטים,עבור כל כרטיס שהוחלף טרנזילה תייצר רשומה עם הטוקן הישן וטוקן חדש + תוקף הכרטיס.

2. הקובץ המעודכן יכול להגיע ללקוח (בעל המסוף) באחת מ 3 הדרכים הבאות:

  • פניה ב API מטרנזילה לצד שרת הלקוח, על הלקוח לספק לנו API

קבלת מוחלפים ב API  דורשת לקבל מהלקוח כתובת URL אליה ישלחו נתוני השירות.נתוני השירות מגיעים בפורמט JSON over POST:

במידה ויש מוחלף 1 בלבד !
הנתונים יתקבלו בצורה הבאה:

{[{“old”:”oldtokendata”,”new”:”newtokendata”,”exp”:”expiredatein4chars:MMYY”},{old”:”oldtokendata”,”new”:”newtokendata”,”exp”:”expiredatein4chars:MMYY”},……]}

ברגע שחוזר יותר ממוחלף 1 הנתונים משתנים ונכנס ספרור עבור כל מוחלף
הנתונים יתקבלו בצורה הבאה:

{"0":{"old":"k101778a679e1291","new":"I9963c2fe1214628158","exp":"2902","terminal":"terminalname"},"1":{"old":"j9e94bb6f5d529887","new":"g31000f2625c1501922","exp":"2902","terminal":"terminalname"},"2":{"old":"Kb9e512876925e3029","new":"g296ea0996ccaf49515","exp":"2901","terminal":"terminalname"},

"3":{"old":"e372e7be4a7c1f2368","new":"D41bef60bf5bs149201","exp":"2902","terminal":"terminalname"},"4":{"old":"me5142e8e31a54f0195","new":"X60s102e39aa209s61","exp":"2902","terminal":"terminalname"}}

 

 

  • שליחת הקובץ בדוא"ל בפורמט אקסל
  • SFTP – קבלת פרטי גישה לשרת FTP מאובטח לשם נעביר את הקובץ


 

 

ביטול תפיסת מסגרת J5

  

סוג פעולה:  ביטול עסקת J5

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת ביטול עסקת J5:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&CreditPass=test&tranmode=W&authnr=0000000&index=465&ccno=12312312&expdate=0922&sum=15

רשימת השדות למשלוח:

 

תיאור השדה שם השדה
שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף) supplier
שדה זה מציין את סוג העיסקה, יש לשלוח את האות W tranmode
מספר האישור של עסקת האימות שרוצים לבטל authnr
מספר העסקה במסוף index
מספר הכרטיס או טוקן ccno/TrazilaTK
תוקף כרטיס expdate
סיסמת זיכויים/ביטולים CreditPass
הסכום המלא של העסקה המקורית sum

 

שגיאות שיכולות לחזור לאחר ביצוע פעולה מהסוג הזה:
שגיאה -96 חוזרת במקרה שלא נשלח index של עסקת האימות המקורית
שגיאה -95 חוזרת כאשר מספר האישור שנשלח לא תואם את מספר האישור שהתקבל בעבור תפיסת המסגרת


 

 

חיבור בAPI למודול החשבוניות

על מנת להתחבר ב-API לממשק חשבוניות שלנו, עלינו לספק לכם:

    Public key – מפתח הצפנה ציבורי (חשוף ומוכר)
    Private Key– מפתח הצפנה פרטי ( מפתח סודי , אין להעביר אותו בשום אופן דרך הממשק או בצורה גלויה)

כדי שנוכל לספק לכם אותם, אנו צריכים מכם את הפרטים הבאים שתשלחו למייל support@interspace.net עם הנושא "בקשה למפתוח API עבור מסוף XXXXX":

א. כתובת אתר האינטרנט שלכם
ב. שמות המסופים עליהם תרצו להפעיל את המודול

מצ"ב המדריכים לאחר קבלת המפתחות מאיתנו:

מדריך Authentication
מדריך API לחשבוניות


 

 

הטמעת שדות מאובטחים - Hosted Fields

 

מדריך למימוש Hosted Fields


פיתרון HF מאפשר בניית טופס מאובטח משלכם לאיסוף פרטי כרטיס ע"י משיכת שדות מאובטחים מספריה של טרנזילה.
השדות מבוססים על תגיות iframe עם מאפיין src שמפנה לספרייה שלנו:


 

ניתן לראות דוגמאות למימוש Hosted fields  בקישורים הבאים (תשלומים/טוקניזציה/שדות נוספים):

https://vucra.com/hf/index.html

https://vucra.com/online05/installments.html

https://vucra.com/online05/additionalField.html

https://vucra.com/online05/tokenize.html

 https://vucra.com/online05/paypal.html

ניתן להטמיע גם בשימוש עם frameworks מתקדמים:
React:
https://vucra.com/react
ניתן להוריד את הקוד מכאן.

Angular:
https://vucra.com/tranzila/#/payment
ניתן להוריד את הקוד מכאן.
 

 

חיבור למודול My Billing דרך API

ניתן להתחבר למודול החיובים החוזרים My Billing  דרך API כדי לבצע פעולות כמו משיכת מידע על חיוב חוזר, עריכה וכיבוי של הוראות חיוב חוזר(sto's).

מצורף למדריך זה קובץ .yaml עם הגדרת השירותים הניתנים במסגרת TRAPI.
ניתן להוריד את הקובץ מכאן.

קובץ זה נכתב בפרוטוקול openapi 3.0.1, וככזה, ניתן לפתוח אותו בכל עורך openapi.
העורך המומלץ על ידינו:  https://editor.swagger.io/
כלי swagger מאפשרים לך לא רק להציג את הקובץ בצורה נוחה ואינטואיטיבית, אלא גם להפעיל את השירותים לניסיון ולייצר ספריות קוד באחת מכ-50 שפות תכנות, לקריאה לשירותים המתועדים בקובץ.

לתשומת ליבך: על מנת להפעיל את שירותי המערכת, יש לקבל מתמיכת טרנזילה 2 מפתחות הצפנה, בהם יש לעשות שימוש כמוסבר במדריך המצורף, על מנת לקבל את המפתחות אנא השב לנו במייל חוזר למייל support@interspace.net שהינך מעוניין להצטרף לשירות ה-API שלנו ובנוסף את כתובת האתר שלכם:

מדריך לביצוע אותנטיקציה בעזרת מפתחות הצפנה ניתן להוריד מכאן.

 

 

שליפת עסקאות ב - API

שליפת עסקאות ב - API

אפשרות לשליפת עסקאות עפ"י חתך תאריכים או אינדקס עסקה בעזרת Tranzila-API.

כתובת לפנייה: https://api.tranzila.com/v1/transactions

שיטה: POST

Header parameters:

X-tranzila-api-app-key

X-tranzila-api-request-time

X-tranzila-api-nonce

X-tranzila-api-access-token

להסבר על authentication header parameters יש להיכנס לקישור להורדת המסמך: https://ng.interspace.net/dl.php?type=d&id=659

פרמטרים לעבודה:

key

type

value

required*

remarks

terminal_name

string

yourTerminalName

 

R

 

transaction_index

number

 

CR

 

transaction_start_date

string

YYY-MM-DD

CR

 

transaction_end_date

string

YYYY-MM-DD

CR

 

page**

number

 

O

See below

 

*required R – required, O – optional, C – conditional, CR – conditionally required.  

**When using dates range method, the maximum number of rows returned is 1000.
If a certain dates range contains more than 1000 transactions, it is possible to add the “page” property to allow pagination, in order to get the next 1000 rows.

 

Request transaction info by Index:

 

{

  "terminal_name": "terminal_name",

  "transaction_index": 121

}

Request transaction info by dates range:

{

  "terminal_name": "terminal_name",

  "transaction_start_date": "2022-08-01",

  "transaction_end_date": "2022-08-31",

  "page": 2

 }

 

Response example:

 

{

    "transactions": [

        {

            "index": "852",

            "transaction_date": "2021-08-25",

            "transaction_time": "11:37:01",

            "amount": "500",

            "credit_card_token": "2312",

            "expiration_month": "03",

            "expiration_year": "24",

            "credit_card_owner_id": "123456789",

            "card_type": "1",

            "card_description": "        טרכארשי",

            "card_brand": "5",

            "clearing_processor": "1",

            "stars": "0",

            "is_foreign": "0",

            "authorization_number": "0000000",

            "bank": "",

            "bank_branch": "",

            "bank_account": "",

            "payment_plan": "1",

            "currency": "1",

            "number_of_payments": "0",

            "first_payment_amount": "0",

            "other_payment_amount": "0",

            "host_ip": "80.244.170.7",

            "processor_response_code": "000",

            "tranmode": "A",

            "refnr": "08591993",

            "tempref": "65450001",

            "xid": "",

            "cavv": "",

            "eci": "",

            "child_terminal": "mclirontest",

            "uid": "",

            "transtatus": "0",

            "telauthability": "1",

            "txn_type": "",

            "txn_payment_method": "",

            "processor": "",

            "broker": "",

            "broker_product": "",

            "pan_entry_mode": "",

            "user_defined_1": "",

            "user_defined_2": "",

            "user_defined_3": "",

            "user_defined_4": "",

            "user_defined_5": "",

            "user_defined_6": "",

            "user_defined_7": "",

            "user_defined_8": "",

            "user_defined_9": "",

            "user_defined_10": "",

            "user_defined_11": "",

            "user_defined_12": "",

            "user_defined_13": "",

            "user_defined_14": "",

            "user_defined_15": "",

            "user_defined_16": "",

            "user_defined_17": "",

            "user_defined_18": "",

            "user_defined_19": "",

            "user_defined_20": ""

        }

    ],

    "user_defined": [

        

        {

            "TERMINAL_ID": "terminal_name",

            "FIELD_ID": "14",

            "API_PARAMETER_NAME": "email",

            "CAPTION": "אימייל",

            "DEFAULT_VALUE": null,

            "DISPLAY_ORDER": null,

            "MANDATORY": "N",

            "DATA_TYPE": "string",

            "UPDATE_DATE": "2022-08-28 15:35:57"

        },

        {

            "TERMINAL_ID": "terminal_name",

            "FIELD_ID": "13",

            "API_PARAMETER_NAME": "contact",

            "CAPTION": "איש קשר",

            "DEFAULT_VALUE": null,

            "DISPLAY_ORDER": null,

            "MANDATORY": "N",

            "DATA_TYPE": "string",

            "UPDATE_DATE": "2022-08-28 15:35:57"

        }

    ],

    "total": "1",

    "rows": 1

}

 

 

 

 

 

 

יצירת לינק לתשלום דרך Bit



להורדת הדוקומנטציה


לאחר פניה לשירות, יתקבל בחזרה לינק שניתן לשלוח או להטמיע בתור iframe שיציג קוד QR:
https://preprod.paymeservice.com/sale/generate/SALE1616-4195312C-TUGZGDPS-27PXPYXE

בגלישה מהמובייל, יוצג כפתור לפתיחת האפליקציה - "Click to open bit app":

 

לאחר לחיצה יופיע המסך הבא:


בסיום התהליך, הלקוח יוחזר לקישורים שנשלחו בשדות success_url או  failure_url, בהתאם לעסקה.
 

 

עסקאות במכשירי EMV באמצעות API

ביצוע עסקאות API במכשירי EMV שנמכרים ע"י טרנזילה

למכשירי Nova, A30, A80 ו – Urovo ניתן להתחבר באמצעות API, מכיוון שהמכשירים הללו עובדים בתצורת ענן.

ניתן לשלוח בקשות לביצוע עסקה במכשיר ע"י שימוש בסט בסיסי של API בתצורה של JSON.

תרחיש שימוש נפוץ - שליחת עסקאות לביצוע במכשיר דרך קופה או עמדת חיוב עם ממשק WEB.

https://secure5.tranzila.com/cgi-bin/tranzila71mdl.cgi URL כתובת לשליחת בקשה לעסקה
https://secure5.tranzila.com/cgi-bin/tranzila71mdlu.cgi URL לשליחת בקשה ל track2
POST שיטת עבודה
Content-type: application/json request header

 

 

 

 

 

סוגי עסקאות נתמכים:

  • עסקת חיוב רגילה J4
  • עסקת זיכוי
  • עסקת תשלומים
  • עסקת תשלומי קרדיט
  • קבלת track2 של כרטיס מגנטי

טבלאת פרמטרים

תיאור פרמטר

חובה

דוגמה

שם פרמטר
שם מסוף כן terminaltest supplier
מזהה ענן יחודי שמוצמד לכל מכשיר EMV כן 014 pos_id
סכום כולל של העסקה כן 300 sum

מטבע העסקה לפי תקן ISO מספרי

376 - שקל ישראלי חדש

 כן 376 currency

סוג עסקה:

A - עסקת חיוב

C - עסקת זיכוי

 כן A tranmode

סוג תשלום

1 - רגיל

6 - קרדיט*

8 - תשלומים**

 כן 1 cred_type
מספר התשלומים פחות 1, לדוגמה עבור 3 תשלומים נשים את הספרה 2 כן/בתנאי שנשלח cred_type=6/8 2 npay
  סכום התשלום הראשון כן/בתנאי שנשלח cred_type=8 100 fpay
  סכום כל תשלום לאחר התשלום הראשון כן/בתנאי שנשלח cred_type=8 100 spay
שדה נוסף לעסקה לא ישראל ישראלי contact
שדה נוסף לעסקה לא טסלה company
שדה נוסף לעסקה*** לא rahakob935@tranzila.com email

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

* npay יש להגדיר את מספר התשלומים, אך לא פחות מ 3 תשלומים.
  אין צורך להעביר את הפרמטרים fpay ו spay כיוון שהחלוקה מתבצעת בחברת האשראי

** חישוב תשלומים לפי הנוסחה הרגילה של - sum = fpay + spay*npay

*** ניתן להשתמש בכל שדה נוסף לעסקה שקיים בהגדרות המסוף

דוגמאות קוד ב JSON

יש לשלוח את כל הערכים כ "string"

עסקת חיוב רגילה:

{
    "pos_id": "014",
    "currency": "376",
    "cred_type": "8",
    "supplier": "terminalname",
    "tranmode": "A",
    "sum": "300",
    "company":"bigmama"
}

עסקת חיוב בתשלומים:

{
    "pos_id": "014",
    "currency": "376",
    "cred_type": "8",
    "supplier": "terminalname",
    "tranmode": "A",
    "sum": "300",
    "npay": "2",
    "fpay" :"100",
    "spay" : "100",
    "company":"bigmama"
}

עסקת זיכוי:

*ביטול עסקה או זיכוי עסקה מתבצעת בדרך כלל באמצעות אתר 'טרנזילה'.
עבור זיכוי לקוח, שאינו מבוסס על עסקת מקור, השתמש בדוגמה:

{
    "pos_id": "014",
    "currency": "376",
    "cred_type": "1",
    "supplier": "terminalname",
    "tranmode": "C",
    "sum": "1"
}

דוגמה לתשובה תקינה שחוזרת לאחר השלמת עסקה במכשיר:

{

    "original_request": {

        "fpay": "100",

        "spay": "100",

        "pos_id": "014",

        "currency": "376",

        "cred_type": "8",

        "supplier": "terminalname",

        "npay": "2",

        "tranmode": "A",

        "sum": "300"

    },

    "status": 0,

    "transaction_result": {

        "cardNumber": "458010***1892",

        "payments": 2,

        "solek": 6,

        "creditPayments": 0,

        "customerReceipt": [

            {

                "fieldValue": "21/05/20 17:53",

                "fieldName": "תאריך"

            },

            {

                "fieldValue": "0889565",

                "fieldName": "מספר מסוף"

            },

            {

                "fieldValue": "01.08.64",

                "fieldName": "גרסת תוכנה"

            },

            {

                "fieldValue": "0300012",

                "fieldName": "מספר עסק"

            },

            {

                "fieldValue": "MAX             ",

                "fieldName": "כרטיס"

            },

            {

                "fieldValue": "1892",

                "fieldName": "מספר"

            },

            {

                "fieldValue": "01014001",

                "fieldName": "מספר שובר"

            },

            {

                "fieldValue": "20052117534808895651709",

                "fieldName": "UID"

            },

            {

                "fieldValue": "014200258797",

                "fieldName": "RRN"

            },

            {

                "fieldValue": "2E",

                "fieldName": "סידורי כ"

            },

            {

                "fieldValue": "001",

                "fieldName": "סידורי ש"

            },

            {

                "fieldValue": "חובה",

                "fieldName": "סוג עסקה"

            },

            {

                "fieldValue": " 042926",

                "fieldName": "מספר אישור"

            },

            {

                "fieldValue": "חברה",

                "fieldName": "גורם מאשר"

            },

            {

                "fieldValue": "חכם",

                "fieldName": "אופן ביצוע"

            },

            {

                "fieldValue": "A0000000031010",

                "fieldName": "זיהוי יישום בשבב"

            },

            {

                "fieldValue": "תשלומים",

                "fieldName": "סוג אשראי"

            },

            {

                "fieldValue": "300.00 שח",

                "fieldName": "סכום עסקה"

            },

            {

                "fieldValue": "100.00",

                "fieldName": "תשלום ראשון"

            },

            {

                "fieldValue": "תשלומים",

                "fieldName": "2 standing order genetation"

            },

            {

                "fieldValue": "100.00",

                "fieldName": "של"

            },

            {

                "fieldValue": "Verified by PIN",

                "fieldName": ""

            }

        ],

        "cardName": "MAX             ",

        "rrn": "014200258797",

        "ipayAmount": 0,

        "statusCode": 0,

        "currency": "376",

        "creditTerms": 8,

        "firstPaymentAmount": 10000,

        "manpik": 6,

        "expDate": "2303",

        "moadonNumber": "",

        "authCodeSolek": 0,

        "uid": "20052117534808895651709",

        "acquirerMerchantID": "300012",

        

        "authCodeManpik": 1,

        "tranType": 1,

        "issuerAuthNum": " 042926",

        "amount": 30000,

        "gatewayToken": "",

        "statusMessage": "עסקה אושרה",

        "mutag": 2,

        "paymentIndex": 0,

        "posEntryMode": 40,

        "tranCode": 1,

        "otherPaymentAmount": 10000

    },

    "error": null,

"token": "sd46sdf042926"

}


דוגמה לתושבה לאחר שידור עסקה לא תקינה(פרמטר קוד מטבע לא תקין):

 

    "original_request": {

        "cred_type": "1",

        "currency": "123",

        "supplier": "efratemv",

        "tranmode": "A",

        "sum": "1.1",

        "pos_id": "099"

    },

    "status": 0,

    "transaction_result": {

        "statusMessage": "קוד מטבע לא תקין",

        "statusCode": -26

    },

    "error": null

}

בקשת API לקבלת track2 של כרטיס מגנטי:

ניתן לבצע קריאת API למכשיר EMV לצורך קריאת פס מגנטי, לקוח הקצה יעביר את הכרטיס בעל הפס המגנטי דרך הקורא כרטיסים שיש על מכשיר ה EMV, המכשיר מחזיר  ב-API את הערך – track2.

*לא ניתן להעביר כרטיסי אשראי דרך הקורא פס מגנטי, ניתן להעביר רק כרטיסים מסוג מתנה/מועדן כגון 'תו זהב', במידה ויקרא כרטיס אשראי תתקבל שגיאה.
**שימו לב! – לאחר העברת הפס המגנטי יוצג על מסך המכשיר טקסט" עסקה נדחתה – ערוץ 2 לא תקין. "על מנת להוריד את השגיאה למקרים הללו יש לגשת לתפריט הטכנאי, ובתחתית המסך להדליק הגדרה בשם " "HANDLEONE SWIPE.

דוגמה לבקשה שיש לשלוח:

{
    "pos_id": "014",
    "currency": "376",
    "supplier": "terminalname",
    "sum": "1"
}

תשובה שחוזרת לאחר העברת הכרטיס בקורא של המכשיר:

{

    "success": true,

    "track2": "000000000000000000000020101111500000"

}

 

 

 

 

 

יצירה ושימוש בטוקנים

יצירת טוקן ניתן לבצע באחת משתי הדרכים:

  1. ב API ניתן רק לייצר טוקן ללא ביצוע עיסקה (ראו סעיף ראשון – יצירת טוקן)
  2. דרך דף דיירקט / IFRAME – ביצוע עיסקה עם יצירת טוקן (ראו מדריך טוקניזציה)

 

 

יצירת טוקן ב-API

סוג פעולה: קבלת טוקן

יצירת טוקן ניתן לבצע באחת משתי הדרכים:

  1. ב API ניתן רק לייצר טוקן ללא ביצוע עיסקה
  2. דרך דף דיירקט / IFRAME – ביצוע עיסקה עם יצירת טוקן (ראו מדריך טוקניזציה)

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת בקשה ליצירת טוקן:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&TranzilaPW=test&ccno=12312312&TranzilaTK=1

תשובה שתתקבל:

TranzilaTK=e29f9ac5b2b3cce2312

  • שים לב, פעולה זו לא תייצר שום עיסקה אלא טוקן בלבד (ללא ולידציה על הכרטיס)

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

TranzilaPW

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

3

ccno

שדה זה מציין את מספר כרטיס האשראי המלא לעסקה
  TranzilaTK יש לשלוח את הערך 1
 

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['ccno'] = '12312312'; // Test card number
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['TranzilaTK'] = '1'; //Make transaction
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
die ($result . "\n");
 
?>
 

חיוב עסקה רגילה עם טוקן

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת בקשה לחיוב טוקן:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&TranzilaPW=test&TranzilaTK=e29f9ac5b2b3cce2312&expdate=0917&sum=15¤cy=1&cred_type=1

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

sum

שדה זה מציין את סכום העסקה

3

expdate

שדה זה מציין את תוקף הכרטיס (MMYY)

4

currency

שדה זה מציין את מטבע העסקה

5

TranzilaPW

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

6

TranzilaTK

שדה זה מציין את מספר הטוקן TOKEN

7

cred_type

שדה זה מציין את סוג האשראי, 1- אשראי רגיל, 2-ישראקרדיט, 3-חיוב מיידי, 5-סופר קרדיט, 6-קרדיט, 8-תשלומים

8

tranmode

שדה זה מציין את סוג העיסקה
 

 

 

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['TranzilaTK'] = 'TranzilaTK'; //Token for the card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

עסקת זיכוי עם טוקן

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת בקשה לזיכוי עיסקה עם טוקן:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&TranzilaPW=test&CreditPass=test&tranmode=C6616&authnr=0000000&TranzilaTK=e29f9ac5b2b3cce2312&expdate=0917&sum=15&currency=1&cred_type=1

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

sum

שדה זה מציין את סכום העסקה

3

expdate

שדה זה מציין את תוקף הכרטיס (MMYY)

4

currency

שדה זה מציין את מטבע העסקה

5

TranzilaPW

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

6

TranzilaTK

שדה זה מציין את מספר הטוקן TOKEN

7

cred_type

שדה זה מציין את סוג האשראי, 1- אשראי רגיל, 2-ישראקרדיט, 3-חיוב מיידי, 5-סופר קרדיט, 6-קרדיט, 8-תשלומים

8

tranmode

שדה זה מציין את סוג העיסקה, יש לשלוח את הערך C עם מספר אינדקס העיסקה המקורית שחוייבה, לדוגמה tranmode=C123
9 CreditPass סיסמת זיכויים/ביטולים
10 authnr מספר אישור העיסקה (חוזר תחת פרמטר confirmationcode)
 

 

 

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['TranzilaTK'] = 'TranzilaTK'; //Token for the card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['CreditPass'] = 'CreditPass'; // Credit password
$query_parameters['tranmode'] = 'C'; // Mode of the transaction is C and the index of the transaction you want to credit
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

עסקת אימות J5 עם טוקן

סוג פעולה: עסקת אימות עסקה/  J5

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת עיסקת אימות J5:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&TranzilaPW=test&TranzilaTK=e29f9ac5b2b3cce2312&expdate=0917&sum=15&currency=1&cred_type=1&tranmode=V

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

sum

שדה זה מציין את סכום העסקה

3

currency

שדה זה מציין את מטבע העסקה

4

tranmode

שדה זה מציין את סוג העיסקה, לעיסקת אימות יש לשלוח את הערך V

5

TranzilaTK

שדה זה מציין את הטוקן אותו יש לחייב

6

expdate

שדה זה מציין את תוקף הכרטיס (MMYY)

7

mycvv

שדה זה מציין את ערך ה CVV של כרטיס האשראי

8

myid

שדה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי

9

cred_type

שדה זה מציין את סוג האשראי, 1- אשראי רגיל,6-קרדיט, 8-תשלומים
 

 

 

 

 

עסקת אילוץ עם טוקן

סוג פעולה: אילוץ עסקה עם טוקן

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת עיסקת אילוץ:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&TranzilaPW=test&tranmode=F&index=1560&authnr=1234567&sum=15&currency=1&cred_type=1

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

TranzilaPW

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

3

sum

שדה זה מציין את סכום העסקה

 

currency

שדה זה מציין את מטבע העסקה

4

tranmode

שדה זה מציין את סוג העיסקה, בעיסקה זו יש לשלוח את הערך F

5

authnr

שדה זה מציין את מספר האישור שהתקבל מחברות האשראי

6

index

שדה זה מציין את אינדקס העיסקה
 
$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['TranzilaTK'] = 'TranzilaTK'; //Token for the card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['tranmode'] = 'F'; //Mode for verify transaction
$query_parameters['authnr'] = '0000000'; // Authorization number
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

עסקה מושהית J2 עם טוקן

 

עסקה מושהית J2 מיועדת לבדיקת תקינות כרטיס בלבד.
הפיתרון מיועד למסופי EMV בלבד - במסוף בתקן אשראית יתבצע חיוב רגיל במקום.

עסקה מושהית מתחלקת לשתי אפשרויות:

  • עסקה מושהית J2 בודק שהכרטיס תקין ואיננו גנוב  – עסקה לבדיקה בלבד, לא ניתן לבצע עליה אילוץ. הכרטיס נבדק ברמת המסוף (בקבצי ההגדרות של המסוף) ולא ברמת חברת האשראי. מה שנבדק זה סוג הכרטיס (BIN - מקומי/תייר/סוג כרטיס/מותג), מספר כרטיס תקין LUHN (בדיקת תקינות מספר הכרטיס ברמה הלוקאלית) ובדיקת חסומים בקובץ המקומי של המסוף עצמו.
  • עסקה מושהית J5 תופס מהמסגרת אשראי של הלקוח כך שלא יהיה מצב בו ללקוח אין כסף בכרטיס האשראי בזמן שבעל העסק יאשר את העסקה.ניתן לבצע על עסקה זו אילוץ (לצורך חיוב)

 

סוג פעולה: עסקת ולידציה מסוג J2

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת ולידציה מסוג J2:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&tranmode=N&TranzilaTK=e29f9ac5b2b3cce2312&expdate=0925&sum=15&currency=1&cred_type=1&myid=123456789&mycvv=123

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

sum

שדה זה מציין את סכום העסקה

3

currency

שדה זה מציין את מטבע העסקה

4

tranmode

שדה זה מציין את סוג העיסקה, לעיסקת J2 יש לשלוח את הערך N

5

TranzilaTK

שדה זה מציין את הטוקן אותו יש לחייב

6

expdate

שדה זה מציין את תוקף הכרטיס (MMYY)

7

mycvv

שדה זה מציין את ערך ה CVV של כרטיס האשראי

8

myid

שדה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי

9

cred_type

שדה זה מציין את סוג האשראי, 1- אשראי רגיל
10 TranzilaPW סיסמת עסקאות של המסוף
 

 

 

עסקת תשלומים עם טוקן

סוג פעולה: עסקת תשלומים

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לעיסקת תשלומים:

 https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&tranmode=A&TranzilaTK=g9faa8df91ecc351234&expdate=0917&sum=50&currency=1&cred_type=8&myid=123456789&mycvv=123&npay=4&fpay=10&spay=10

  • מספר התשלומים שיש לשלוח בפרמטר npay הוא מספר התשלומים פחות 1

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

sum

שדה זה מציין את סכום העסקה

4

tranmode

שדה זה מציין את סוג העיסקה

5

TranzilaTK

שדה זה מציין את הטוקן איתו יש לבצע חיוב

6

tranzilaPW

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

7

currency

שדה זה מציין את מטבע העסקה

8

expdate

שדה זה מציין את תוקף הכרטיס (MMYY)

9

mycvv

שדה זה מציין את ערך ה CVV של כרטיס האשראי

10

myid

שדה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי

11

cred_type

שדה זה מציין את סוג האשראי, 8-תשלומים

12

fpay

שדה זה מציין את סכום התשלום הראשון

13

npay

שדה זה מציין את מספר התשלומים
14 spay שדה זה מציין את סכום כל תשלום לאחר התשלום הראשון
 

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71u.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['TranzilaTK'] = 'TranzilaTK'; //Token for the card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['cred_type'] = '8'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['fpay'] = '1'; //First payment
$query_parameters['spay'] = '2'; //Following payments
$query_parameters['npay'] = '2'; //for payments transaction npay=number of payments-1, for credit transaction npay=number of payments
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

ביטול עסקה עם טוקן

  

סוג פעולה:  ביטול עיסקה עם טוקן

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת עיסקת חיוב רגילה:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&TranzilaPW=test&CreditPass=test&tranmode=D6609&authnr=0000000&TranzilaTK=e29f9ac5b2b3cce2312

תשובה שתתקבל:

Response=000&index=6609

 

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

tranmode

שדה זה מציין את סוג העיסקה, יש לשלוח את האות D ולאחריה את מספר אינדקס העיסקה המקורית שיש לזכות.

לדוגמא עבור עסקה מספר 123 יש לשלוח : D123

3

authnr

שדה זה מציין את מספר האישור שהתקבל מחברות האשראי

4

TranzilaTK

שדה זה מציין את הטוקן
5 CreditPass סיסמת זיכויים/ביטולים

6

TranzilaPW

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*יש לשלוח רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות
 

 

 

 

 

טרנזילה אקספרס - הקדמה להתממשקות ב-API

יש ליצור טופס ( FORM ) ב HTML כאשר פעולת ה- Action תשלח ל URL:

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi

כמו כן , על הטופס להישלח ב - Post  ולא ב - Get :

<FORM Action="https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi" method=POST>

מתחת לפקודת ה Action יש להוסיף שורת קוד נוספת שתשמש לזיהוי מקור שליחת הטופס ולשייכו למסוף וחשבון הטרנזילה המתאים  לדוגמא:

<Input type="hidden"  name="supplier"  value="demo">

בשורה זו אין לשנות דבר, מלבד המשתנה: Value שהוא שווה ערך לשם המסוף שניתן ממערכת טרנזילה. כל המשתנים הנוספים צריכים להיות מוגדרים בצורה דומה.

את כל המשתנים הקיימים ניתן לראות במסוף הסליקה > הגדרות >הגדרה 1

 

 

  • על הלקוח להכנס למסוף ולהגדיר את כתובת ה IP של השרת שלו ששולח את הבקשות לטרנזילה. ההגדרה מבוצעת בהגדרות >הגדרת מסוף >שיטות עבודה

  • יש להגדיר את כתובת ה IP של השרת שלכם ששולח את הטרנזקציות. ניתן להגדיר טווח כתובות ע"י הגדרת Subnet, לדוגמה 92.168.30.0/24
  • הסכום המינימלי לחיוב בשרות האקספרס הוא 5 ש"ח / דולר / אירו.
  • סליקה במט"ח (דולר /אירו) מחייבת אישור וחתימה על טופס הרשאה לחשבון.
 

עסקת חיוב רגילה - אקספרס

 סוג פעולה:  עסקה רגילה

כתובת:

       https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi

דוגמה לשליחת עיסקת חיוב רגילה:

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi?supplier=test&tranmode=A&ccno=12312312&expdate=0917&sum=15¤cy=1&cred_type=1&myid=123456789&mycvv=123

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

sum

שדה זה מציין את סכום העסקה

הסכום המינימלי לעיסקה- 5 ש"ח/דולר/אירו

3

tranmode

שדה זה מציין את סוג העיסקה, יש לשלוח את הערך A

4

ccno

שדה זה מציין את מספר כרטיס האשראי המלא לעסקה

5

TranzilaPW

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*יש לשלוח רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

6

currency

שדה זה מציין את מטבע העסקה, ערך 1 עבור ש"ח, ערך 2 עבור $ , ערך 978 עבור EURO

7

expdate

שדה זה מציין את תוקף הכרטיס (MMYY)
8 cred_type שדה זה מציין את סוג האשראי, 1- אשראי רגיל, 8-תשלומים

9

mycvv

שדה זה מציין את ערך ה CVV של כרטיס האשראי

10

myid

שדה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי
 

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71pme.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['ccno'] = '12312312'; // Test card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['mycvv'] = 'mycvv'; // number if required
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

עסקת זיכוי - אקספרס

  

סוג פעולה:  עסקת זיכוי

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi

דוגמה לשליחת עיסקת חיוב רגילה:

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi?supplier=test&CreditPass=test&tranmode=C1497&authnr=0000000&ccno=12312312&expdate=0917&sum=15&currency=1&cred_type=1&myid=123456789&mycvv=123

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

sum

שדה זה מציין את סכום העסקה לזיכוי
3 currency סוג המטבע הנסלק

4

tranmode

שדה זה מציין את סוג העיסקה, יש לשלוח את האות C ולאחריה את מספר אינדקס העיסקה המקורית שיש לזכות.

לדוגמא עבור עסקה מספר 123 יש לשלוח : C123

5

authnr

שדה זה מציין את מספר האישור שהתקבל מחברות האשראי

6

ccno

שדה זה מציין את מספר כרטיס האשראי המלא לעסקה
7 cred_type שדה זה מציין את סוג האשראי, 1- אשראי רגיל, 8-תשלומים
8 CreditPass סיסמת זיכויים/ביטולים
9 mycvv

שדה זה מציין את ערך ה CVV של כרטיס האשראי
10 myid

שדה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי

11

TranzilaPW

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*יש לשלוח רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות
 

 

 

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71pme.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['ccno'] = '12312312'; // Test card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['mycvv'] = 'mycvv'; //CVV number if required
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['CreditPass'] = 'CreditPass'; // Credit password
$query_parameters['authnr'] = '0000000'; // Authorization number
$query_parameters['tranmode'] = 'C1234'; // Mode of the transaction is C and the index of the transaction you want to credit
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

ביטול עסקה- אקספרס

  

סוג פעולה:  ביטול עיסקה

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi

דוגמה לשליחת עיסקת חיוב רגילה:

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi?supplier=test_terminal&CreditPass=test_terminal&tranmode=D1463&authnr=0000000&sum=5

תשובה שתתקבל:

Response=000&index=1463

  • ניתן לבטל עיסקה שעדיין לא שודרה לשב"א ואין לה REF NR
  • עיסקה שכבר שודרה לשב"א ויש לה REF NR, ניתן רק לזכות אותה.

 

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

sum

שדה זה מציין את סכום העסקה לביטול

3

tranmode

שדה זה מציין את סוג העיסקה, יש לשלוח את האות D ולאחריה את מספר אינדקס העיסקה המקורית שיש לבטל.

לדוגמא עבור עסקה מספר 123 יש לשלוח : D123

4

authnr

שדה זה מציין את מספר האישור שהתקבל מחברות האשראי
5 CreditPass סיסמת זיכויים/ביטולים

6

TranzilaPW

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*יש לשלוח רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות
 

 

 

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71pme.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['CreditPass'] = 'CreditPass'; // Credit password
$query_parameters['authnr'] = '0000000'; // Authorization number
$query_parameters['tranmode'] = 'D1234'; // Mode of the transaction is D and the index of the transaction you want to credit
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

עסקת אימות J5 - אקספרס

סוג פעולה: עסקת אימות עסקה/  J5

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi

דוגמה לשליחת עיסקת אימות J5:

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi?supplier=test&tranmode=V&ccno=1234567812345678&expdate=0917&sum=15&currency=1&cred_type=1&myid=123456789&mycvv=123

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

sum

שדה זה מציין את סכום העסקה

3

currency

שדה זה מציין את מטבע העסקה

4

tranmode

שדה זה מציין את סוג העיסקה, לעיסקת אימות יש לשלוח את הערך V

5

ccno

שדה זה מציין את מספר כרטיס האשראי המלא לעסקה

6

expdate

שדה זה מציין את תוקף הכרטיס (MMYY)

7

mycvv

שדה זה מציין את ערך ה CVV של כרטיס האשראי

8

myid

שדה זה מציין את מספר התעודת זהות של בעל כרטיס האשראי

9

cred_type

שדה זה מציין את סוג האשראי, 1- אשראי רגיל, 8-תשלומים
 

 

 

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71pme.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['ccno'] = '12312312'; // Test card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; // ID number
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['tranmode'] = 'V'; //Mode for verify transaction
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

עסקת אילוץ - אקספרס

סוג פעולה: אילוץ עסקה

כתובת:

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi

דוגמה לשליחת עיסקת אילוץ:

https://secure5.tranzila.com/cgi-bin/tranzila71pme.cgi?supplier=test_terminal&tranmode=F&index=1464&authnr=0004700&sum=5&currency=1&cred_type=1&TranzilaTK=Nf7454c432572f92312&expdate=0527&TranzilaPW=G4rth5y

רשימת השדות למשלוח:

מס'

שם השדה

תיאור השדה

1

supplier

שדה זה מציין את שם המשתמש בטרנזילה (שם המסוף)

2

TranzilaPW

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

3

sum

שדה זה מציין את סכום העסקה

 

currency

שדה זה מציין את מטבע העסקה

4

tranmode

שדה זה מציין את סוג העיסקה, בעיסקה זו יש לשלוח את הערך F

5

authnr

שדה זה מציין את מספר האישור שהתקבל מחברות האשראי

6

index

שדה זה מציין את אינדקס העיסקה
7 TranzilaTK  שדה זה מציין את הטוקן אותו יש לחייב
8 expdate

שדה זה מציין את תוקף הכרטיס (MMYY)
 
$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71pme.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['ccno'] = '12312312'; // Test card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['mycvv'] = 'mycvv'; //CVV number if required
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['tranmode'] = 'F'; //Mode for verify transaction
$query_parameters['authnr'] = '0000000'; // Authorization number
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71pme.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['TranzilaTK'] = 'TranzilaTK'; //Token for the card number
$query_parameters['expdate'] = '0820'; // Card expiry date: mmyy
$query_parameters['myid'] = '12312312'; //ID number if required
$query_parameters['cred_type'] = '1'; // This field specifies the type of transaction, 1 - normal transaction, 6 - credit, 8 - payments
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['tranmode'] = 'F'; //Mode for verify transaction
$query_parameters['authnr'] = '0000000'; // Authorization number
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
// Analyze the result string
if (!isset($response_assoc['Response'])) {
    die ($result . "\n");
    /**
     * When there is no 'Response' parameter it either means
     * that some pre-transaction error happened (like authentication
     * problems), in which case the result string will be in HTML format,
     * explaining the error, or the request was made for generate token only
     * (in this case the response string will contain only 'TranzilaTK'
     * parameter)
     */
} else if ($response_assoc['Response'] !== '000') {
    die ($response_assoc['Response'] . "\n");
    // Any other than '000' code means transaction failure
    // (bad card, expiry, etc..)
} else {
    die ("Success\n");
}
 
?>
 

הטמעת דף סליקה מאובטח - הקדמה

בהתאם להנחיות חברות האשראי שנכנסו לתוקן בשנת 2012, חל איסור על קליטה ושידור של פרטי כרטיסי אשראי בעמוד תשלום באתר אינטרנט, שלא קיבל הסמכה לתקן PCI DSS.

על מנת להקל על לקוחותנו, פיתחנו את דף הרידיירקט - עמוד סליקה המאוחסן בשרתי טרנזילה, אשר קיבל ועבר את כל ההסמכות והדרישות של תקן האבטחה החדש PCI-DSS .

באפשרותכם לשלב את דף הסליקה כדף תשלום חיצוני Direct או כדף תשלום פנימי באתרכם Iframe.

  1. שימוש באמצעות דף סליקה חיצוני:  באפשרות זו, המשתמש מועבר אוטומטית לדף סליקה חיצוני  מתוך האתר בו גלש המשתמש. הדף מעוצב בברירת המחדל בעיצוב בסיסי בלבד הניתן להתאמה ושינוי בהתאם לצרכי השירות. ניתן להגדיר ולשנות את העיצוב לצבעים מתאימים, להצגת הלוגו של נותן השירות, הצגת תמונה,בחירת שדות רשות להצגה ועוד.
  2. שימוש בחלון להטמעה באתרכם כ - Iframe : באמצעות אפשרות זו ה - iframe הוא למעשה נגזרת של עמוד ההפניה (redirect). ניתן להגדיר בו את השדות הרלוונטיים לכם ולהטמיע אותם בדף התשלום באתרכם בהתאם לצרכים שלכם.היתרון העיקרי בשימוש בדף הסליקה כ Iframe הוא שהגולש נשאר באתר ולא יוצא לדף תשלום חיצוני ובכך לא נפגמת חוויית המשתמש והזרימה במעמד הרכישה, כשהמשמעות היא אחוזי המרה גבוהים יותר. את הלוגואים המוצגים מסביב ניתן להסיר ואת צבע הרקע ניתן לשנות בהתאם לצבע האתר, כך שהגולש כלל לא מרגיש שינוי אפילו שבפועל פרטיו מועברים מ URL שונה.

 

  • עבור שתי האפשרויות הנ"ל פיתחנו את דף התשלום הרספונסיבי, המזהה את סוג הדפדפן ממנו הגיע הגולש ומתאים את רזולוציית העמוד בהתאם.שימוש בדפי הסליקה הרספונסיביים ניתנים ללא עלות נוספת כחלק משרות רכישת דף סליקה.
  • במידה ותהיו מעוניינים לבצע עיצוב עצמאי לעמוד התשלום Iframe בלבד, תוכלו להשתמש בשרות Iframe מעוצב בתשלום נוסף.הסבר בנושא בסעיף Iframe מעוצב.
 

כניסה לממשק הגדרת דף הסליקה

במייל שקיבלתם מאיתנו עם הכותרת "ברוכים הבאים לטרנזילה",  נמצאים כל פרטי הגישה לממשק ניהול עמוד הסליקה, הנדרשים על מנת להפעיל את הדף ולבצע אינטגרציה לאתר.
כדי להכנס להגדרות עמוד הסליקה, יש להכנס למסוף הסליקה שלכם בכתובת

https://my.tranzila.com/login

בתפריט הראשי יש לבחור ב "הגדרות" >  " דף סליקה"

 

 

  •  

 

  • תחילה יש להגדיר את דף הסליקה דרך לוח הבקרה ( MERCHANT) ולבצע שמירה,רק אז הקישור של דף הסליקה יהיה פעיל ותוכלו לראות אותו.
  • אם תלחצו על הקישור של דף התשלום לפני עדכון הגדרות בלוח הבקרה ( MERCHANT) , תגיעו לדף לא זמין.

 

  •  
 

הגדרת דף הסליקה MERCHANT

הגדרות דף הסליקה מחולקות ל 9 חלקים

 

  1. פרטי בית העסק - בחלק זה עליכם להגדיר את פרטי העסק שלכם
  • שם בית העסק
  • כתובת אתר הבית
  • דוא"ל של בית העסק
  • כתובת בית העסק
  • מספר טלפון ומספר פקס
  • לוגו של בית העסק -  תמונת הלוגו תותאם לגדול 135*215
  • כתובות דף צור קשר,תנאי שרות ודף אודות באתרכם.

 

 

  1. ניהול מוצרים - הגדרות אלה מיועדות לשינוי במידה ואינכם מעבירים פרמטרים לדף הסליקה, מיועד לשימוש עבור דף ריבוי מוצרים.
  • בחירת מוצר- יצירת והצגת  המוצר בדף הסליקה, עבורו יחולו כל פרטי המוצר בהמשך.ניתן להגדיר מוצר אחד או יותר ועבור כל אחד מהמוצרים ניתן להגדיר את שם המוצר,תאור,מחיר וכ"ו. כדי ליצור מוצר חדש יש ללחוץ על "הוסף" ולמלא את כל פרטי תאור המוצר הנדרש. ניתן לבחור את המוצרים אותם אתם רוצים למחוק ולבחור ב "מחק". אחרי כל ביצוע פעולה של יצירת/מחיקת מוצר יש לבצע שמירה.
  •  מוצר פעיל/לא פעיל-מוצר פעיל הינו מוצר המוצג בדף הסליקה.מוצר שמוגדר לא פעיל לא יימחק מהמערכת,אלא לא יוצג בדף הסליקה ולא יהיה זמיו לרכישה.
  • לינק לקניית מוצר בודד- תוכלו לשלוח ללקוחות קישור עבור תשלום למוצר בודד בלבד,יש להעתיק את הקישור למוצר ולשלוח אותו (בדוא"ל,פייסבוק או בכל דרך אחרת שתבחרו.
  • שפה- שפת תאור המוצר שיוצג.ניתן להגדיר לכל מוצר תאור במספר השפות הרשומות.יש לבחור את השפה ולאחר מכן לעדכן את תאור המוצר בשפה הרצויה בשדות שם מוצר בעברית ותיאור מוצר בעברית.
  • עיצוב דף מוצר יחיד- הצגת תאור המוצר בדף הסליקה.
  • מחיר סופי כולל מע"מ - הצגת המחיר,כולל מע"מ בדף הסליקה. יש להגדיר לכל מוצר מחיר משלו.
  • מחיר פתוח- הצגת שדה מחיר פתוח למחיר , יהיה ניתן לעריכה ע"י הלקוח המשלם בדף הסליקה (לדוגמה עבור תרומות או כאשר דף הסליקה הוא דף עצמאי והלקוח המשלם ממלא באופן עצמאי את המחיר)
  • מחיר לפני הנחה (אופציונלי) - הצגת המחיר הקודם של המוצר במקרה בו אתם רוצים לציין שהמוצר נמכר במחיר זול יותר.
  • חיוב מחזורי - הפעלת האפשרות לביצוע חיוב מחזורי ,ללא הגבלה לאשראי. מחייב רכישת מודול טוקנים.
  • תמונת המוצר + מחק תמונת מוצר - ניתן להציג את תמונת המוצר. התמונה תותאם לדוגל 160*160

  1. ניהול שיטות משלוח - ניתן להגדיר הוספת שיטת משלוח, בתשלום (או לא) בעמוד סליקה ריבוי מוצרים.
  • הוספת מודול שיטות משלוח - הפעלת אפשרות לבחירת שיטת משלוח. מופעל / ללא.
  • שפה - שפת התצוגה לשיטות המשלוח שיוצגו.
  • בחירת שיטות משלוח ועלויות המשלוח.
  • הוספת שיטת משלוח בנוסף לברירת המחדל המוצעת.

 

  1.  ניהול קופונים - הגדרת קופון המספק הנחה , בהתאם להגדרת הקופונים.
  • בחירת קופון - רשימת היסטוריית הקופונים שהוקמו במערכת לצורך ניהולם. ניתן להוסיף קופון חדש ע"י לחיצה על כפתור "הוסף" או למחוק קופון קיים ע"י בחירת הקופון מתוך הרשימה ולחיצה על כפתור "מחק".
  • קופון פעיל/לא פעיל - קופון המוגדר "פעיל" ניתן לשימוש בעגלת הקניות בדף הסליקה.קופון המוגדר "לא פעיל" לא יכובד בעמוד הסליקה.
  • שם הקופון - הגדרת תאור הקופון , כפי שיופיע בעמוד הסליקה בתחתית עגלת הקניות לצד ההנחה שהוא מקנה.
  • קוד קופון- קוד קופון חייב להכיל לפחות 8 תווים,הכוללים אותיות גדולות באנגלית + ספרות בלבד, ללא רווחים או תווים מיוחדים.ניתן לקבוע קוד קופון רנדומלי באמצעות לחיצה על כפתור "צור קוד".
  • כמות (מוגבל / לא מוגבל)- ניתן להגביל את מספר הקופונים בהם יהיה שימוש.יש לבחור האם הקופון מוגבל /לא מוגבל ואת כמות הקופונים להגבלה.
  • סוג הנחה- קופון יכול לשמש להנחה קבועה (של סכום מדוייק שיופחת מערך ההזמנה), או כהנחה באחוזים של ההזמנה. אם בחרת "הנחה קבועה", יש להגדיר את סכום ההנחה בשדה "ערך הקופון" .אם בחרת "הנחה באחוזים", יש להגדיר את אחוז ההנחה לקופון בשדה "ערך הקופון".
  • ערך הקופון - בשדה זה יש להגדיר את ערך ההנחה שיינתן, בהתאם לבחירתכם בשדה מעל "סוג ההנחה"- בסכום קבוע (ביחידות מטבע) או באחוזים.
  • הגבלת תוקף - ניתן להגביל את תוקף הקופון לטווח תאריכים מסויים (מתאריך עד תאריך) או ללא הגדרת תוקף,כל עוד הקופון בסטטוס פעיל.

 

  1. אפשרויות חיוב - הגדרות אלו מיועדות לבחירת אפשרויות החיוב בעמוד התשלום.
  • קורא כרטיסים - אפשרות קבלת פרטי כרטיס אשראי דרך קורא הכרטיסים ישירות לעמוד התשלום. ניתן לבצע הזמנה של קורא כרטיסים  דרך עמוד ההגדרות.
  • פייפאל - הוספת כפתור PAYPAL לעמוד התשלום, כך שלקוחות יוכלו לחייב גם עם PAYPAL בנוסף לכרטיס אשראי. כדי שכפתור ה PAYPAL יעבוד, יש לבצע הגדרות עבור חיבור החשבון מול PAYPAL בהתאם למדריך ההתממשקות.
  • כרטיס אשראי - אפשרות קבלת תשלום בעזרת כרטיס אשראי. אפשרות זו מסומנת בברירת המחדל כמופעלת.
  • מטבע - בחירת המטבע שבאמצעותו יבוצע החיוב .ניתן לבחור בין ש"ח / דולר אמריקאי / אירו / לירה סטרלינג / קרונה נורבגית / דולר הונג קונג / ין יפני.
  • CVV - אפשרות לבחור האם להציג את שדה ה CVV בעמוד התשלום. במידה ותבחרו שהשדה יופיע, השדה יהיה שדה חובה. באחריותכם לבדוק מול חברת האשראי האם אתם נדרשים להצגת שדה זה.
  • ת.ז. - אפשרות לבחור האם להציג את שדה ת.ז. בעמוד התשלום. במידה ותבחרו שהשדה יופיע, השדה יהיה שדה חובה. באחריותכם לבדוק מול חברת האשראי האם אתם נדרשים להצגת שדה ת.ז.
  • תשלומים - אפשרות חיוב בכרטיס אשראי בחלוקה לתשלומים.
  • חיוב מחזורי - חיוב חודשי מחזורי , ללא הגבלה, לכרטיסי אשראי.מחייב רכישת מודול טוקנים.החיוב יבוצע עם בחודש ,החל מהחודש הבא.ניתן לאפשר ללקוח המשלם האם לבצע את החיוב המחזורי ע"י הוספת כפתור בחירה בעמוד התשלום או להגדיר שבאופן קבוע יבוצעו חיובים מחזוריים. במידה ושרות החיוב המחזורי מופעל תמיד, או שהלקוח המשלם ייבחר להשתמש בו, לא יוצג שדה התשלומים.
  • מסוף לחיוב מחזורי - יש להגדיר את שם המסוף בו יבוצעו החיובים המחזוריים.בפועל יש להגדיר את המסוף עם הטוקנים

 

 

  1. הגדרת שדות - בחירת השדות שיוצגו בדף הסליקה, והגדרת כל שדה כשדה חובה או אופציונלי. שדה חובה הוא נתון שללא מילוי שלו הלקוח לא יוכל להשלים את ההזמנה.
  • שדות חופשיים לתצוגה לבחירתכם, יש לבחור אם להציגם והאם יהיו חובה או אופציונלים.
  • כותרת להערות- עבור שדה הערות, ניתן להגדיר כותרת שונה בהתאם לצורך שלכם, לדוגמה - שם תלמיד, מספר נעליים או צבע חולצה.
  • אישור תנאי שימוש - הצגת תנאי השימוש בדף הסליקה וסימון קריאה והסכמה לתנאי השימוש כתנאי להשלמת ההזמנה.כתובת זו חייבת להתחיל ב http://  או  https://

 

 

  1. הגדרות תצוגה - הגדרות תצוגה לדף הסליקה,שפה ,לוגו ועוד.
  • דף חדש רפסונסיבי - אפשרות לבחור האם להשתמש בדף הסליקה כדף רספונסיבי המתאים עצמו לגודל הדפדפן והמסך בו הוא נפתח ( PC/TABLET/MOBILE ) ומומלץ להגדירו במידה ואתרכם מותאם לסלולר.
  • שפה- תצוגת שפת דף הסליקה. הדף תומך בשפות עברית /אנגלית / רוסית / ערבית / ספרדית / צרפתית / יפנית.
  • לוגו טרנזילה - הצגת לוגו טרנזילה בדף הסליקה. טרנזילה הינה חברת הסליקה המובילה בישראל, הצגת לוגו החברה מקנה תחושבת ביטחון למשלמים בדף הסליקה.
  • -הגדרת המלל שיופיע על כפתור התשלום בדף הסליקה.
  • הצגת לוגו חברות האשראי - הצגת לוגו חברות האשראי שניתן לשלם באמצעותן בדף הסליקה שלך. לתשומת לבך! הצגת הלוגואים הינה לבחירתך החופשית ובאחריותך בלבד. מומלץ להציג אך ורק את הלוגואים שבהם מסוף הסליקה שלך תומך, ולא להציג את אלה שאינם נתמכים.

 

  1. הגדרות מתקדמות - בחלק זה יש להגדיר את דפי ההצלחה והכישלון אליהם יחזור הלקוח בסיום ביצוע התשלום בדף הסליקה. אנו ממליצים להשאיר את ההגדרות המתקדמות כפי שהן, אלא אם מבינים את השינוי בכל אחת מההגדרות, כדי שפעילות דף הסליקה לא תיפגע.
  •   GoogleID - הגדרת קוד של Google Analytics המאפשר לבעלי אתרים לעקוב אחר התנועה הנכנסת לאתר שלהם ומהיכן הגיע הגולש (מנוע חיפוש,כניסה ישירה,קמפיינים וכ"ד).
  •     Return Method - בחירת שיטת העברת הנתונים מדף הסליקה אל השרת וחזרה. ניתן לבחור בין GET (העברת נתוני העיסקה בשורת ה URL של הדפדפן.שיטה זו אינה מומלצת על ידינו והיא פחות מאובטחת כיוון שהנתונים מועברים בגלוי בשורת ה URL) , ובן POST (העברת נתוני העיסקה בתוך ה HEADER של הדפדפן, בה הלקוח המשלם לא רואה את פרטי העיסקה בגלוי.שיטה זו מומלצת ומאובטחת).

    • העברת נתונים ב POST -העברת נתונים ב POST מאובטחת יותר.נתוני העיסקה מועברים ב HEADER של הדפדפן ולכן מאובטחים יותר.

      מומלץ לרכוש תעודת SSL  לאתרכם לצורך אבטחה מירבית.

      אם אין הצפנת SSL באתר שלכם, בסיום הרכישה ויציאה מדף התשלום,תקפוץ הודעת אזהרה לגולש ,בה נאמר ש"כעת מתבצעת שליחת נתונים מדף מאובטח לדף לא מאובטח", כלומר, יציאה מדף התשלום המאובטח של טרנזילה לאתר. נתוני האשראי לא עוברים כמובן ,הם נותרים.

      הנתונים שעוברים הם פרטי העסקה, למשל הסכום ששולם ועבור מה שולם – חסויים לחלוטין.שימו לב שהגולש הממוצע נוטה להיבהל מההודעה וסוגר את הטאב או הדפדפן במהירות במקום לחזור לאתר שלכם.

      עד שתתקינו SSL באפשרותכם לבחור את האפשרות השניה לעבודה – GET ולחסוך מהגולשים את הודעת האבטחה של הדפדפן.קחו בחשבון שעבודה ב GET הינה מאובטחת פחות.

  • אנו ממליצים בחום להשתמש במתודיקת העברת נתונים ב POST בשילוב SSL על אתרכם.
  • - הגדרת כתובת הדף אליו יועבר הלקוח המשלם בסיום עיסקה שהושלמה בהצלחה. כתובת זו חייבת להתחיל ב -

http://

https://

  • ניתן להשאיר שדה זה ריק ובכך להשתמש בדף ההצלחה ברירת המחדל של טרנזילה.
  • fail URL - הגדרת כתובת הדף אליה יועבר הלקוח המשלם בסיום עיסקה שנכשלה. כתובת ו חייבת להתחיל ב -

http://

https://

  • מספר נסיונות - קביעת מספר נסינוות החיוב בהם מוחזר הלקוח לטופס התשלום לנסיון חיוב נוסף , לפני מעבר לדף הכישלון.

 

 

  1. אבטחת מידע - בחלק זה תוכלו לבחור את אפשרויות אבטחת המידע ומניעת עסקאות הונאה המסופקות על ידינו.
  • Notify URL - הגדרת קישור Notify URL לצורל גיבוי של נתוני העיסקה שהועברו בפועל, כך שלא יהיה ניתן לשנות את נתווני העיסקה שמועברים בעת העברת הנתונים לשרת. לצורך כך עליכם לבנות דף Notify שיקבל את נתוני העיסקאות. כתובת זו חייבת להתחיל ב-

http://

https://

  • Google No-Captcha Re-Captcha - מנגנון המונע מתוכנות זדוניות שלוח הזמנה פיקטיבית.
  • Hand Shake - מנגנון למניעת הונאות. מנגנון זה מחייב רכישת מודול טוקנים. מידע נוסף ניתן למצוא בסעיף "אבטחת מידע- התמודדות עם הונאות".
  • סכום מינימלי לחיוב - כל עסקה מתחת לסכום שתגדירו, תיכשל.שדה זה רלוונטי לדף סליקה ריבוי מוצרים בלבד.

 

 

Notify URL - מניעת הונאה

חשוב לוודא את תוצאת הסליקה, כלומר, גיבוי של סכום העסקה ששולם בפועל.

דף Notify מיועד לקבלת נתוני העיסקה כפי שבוצעה בפועל, וזיהוי שינויים שבוצעו בנתוני העיסקה לאחר שליחתם.

כדי להמנע מכניסה למסוף הסליקה לאחר ביצוע כל עיסקה, תוכלו להגדיר את דף ה- Notify בהגדרות דף הסליקה (Merchant), אשר יקבל את נתוני העיסקה כפי שהוכנסו במקור בעמוד התשלום, ולהשוותם לנתוני העיסקה שהועברו דרך דפדפן הלקוח המשלם.

במידה ותזהו כל שינוי בפרטי העיסקה מול הנתונים שהועברו לדף ההצלחה מול נתוני העיסקה שהועברו לדף ה Notify,  תוכלו לבחור האם לבטל את העיסקה,או ליצור קשר עם הלקוח המשלם לבירור.

קישור זה אינו מוצג לגולשים ונשלח ללא ידיעתם במקביל להעברתם לדף ההצלחה / כישלון, ולכן תוכלו לנטר את העיסקאות בזמן אמת ולזהות הונאות רשת.

  • חשוב להדגיש- הונאת סליקה אינה מתבצעת בתוך עמוד התשלום של טרנזילה, דף התשלום הינו דף מאובטח תחת תקן PCI DSS ו SSL.
  • שימו לב - חובת הבדיקה בזמן אמת לטרנזקציות והשוואתן למסד הנתונים היא באחריותכם הבלעדית!
  • אנו ממליצים להשתמש במודול הטוקנים לאבטחת העיסקאות בצורה הטובה ביותר.

**לקוחות המשתמשים ב- NOTIFY URL  שה NOTIFY נכשל, יתבצעו 5 ניסיונות נוספים לשלוח ללקוח את ה NOTIFY בהפרש של 5 דקות. לאחר 5 כישלונות יישלח מייל ללקוח עם הודעה על כישלון ה NOTIFY .

 

העברה וקבלת נתונים בעמוד הסליקה

  • העברת הנתונים לעמוד הסליקה מתבצע ב POST או ב GET. אנו ממליצים לעבוד ב POST.
  • קבלת הנתונים מתבצעת באמצעות מערך המכיל את תגובת חברות האשראי והמשתנים  (פרמטרים) שנקלטו בדף הסליקה.
  • מערך הנתונים (פרמטרים) מוחזרים ב POST או ב GET את כתובת ההצלחה / כישלון שהוגדרו בדף הגדרות עמוד התשלום (Merchant )
  • במידה והוגדר דף Notify , נתוני העיסקה יישלחו במקביל גם אליו.

 

רשימת משתנים שיש להעביר לעמוד התשלום

  • לשמות המשתנים (פרמטרים) יש חשיבות לאותיות גדולות / קטנות
  • משתנים המסומנים בכוכבית הינם משתני חובה
  • משתנים המסומנים בשתי כוכביות עוברים לחשבונית

 

תאור שם המשתנה (פרמטר )
סכום * sum
מטבע * currency
תאור מוצר** pdesc
שפה lang
שם חברה משלמת** company
שם איש קשר משלם** contact
כתובת דוא"ל משלם** email
טלפון phone
כתובת** address
עיר** city
סוג תשלום cred_type
אחוז מעמ IMaam

 

ערכים אפשריים

 

ערכים אפשריים משתנה
1 - ש"ח  ,  2 - דולר ,  978 - אירו  , 826 -פאונד, 124 - דולר קנדי, 036 - דולר אוסטרלי, 578 - קורונה נורווגית, 752 - קורונה שבדית, 208 - קורונה דנית, 392 - ין יפני, 756 - פרנק שוויצרי currency
il - עברית  ,ar - ערבית , us - אנגלית  ,  ru - רוסית  ,es - ספרדית  , de - גרמנית,  fr - צרפתית , jp -יפנית lang
1 - חיוב תשלום אחד ,  6 - תשלומי קרדיט  , 8 - תשלומים cred_type
0.17 עבור 17% מעמ, 0 עבור 0% מעמ. במידה ולא ישלח ערך, יקלט כ0% בברירת מחדל IMaam

 

שליחת קישורים של דפי הצלחה/כישלון/Notify כפרמטר:

 

ניתן להגדיר את דפי ההצלחה / כישלון / NOTIFY בהגדרות דף הסליקה (Merchant ) או לשלוח אותם, במידה והם משתנים, כפרמטר עם ערך מתאים.

ערך משתנה
קישור דף הצלחה

success_url_address
קישור דף כישלון

fail_url_address
קישור ל NOTIFY

notify_url_address

דגשים להטמעה:

  1. יש להעביר ערך לדף ההצלחה/כישלון/NOTIFY עם http/https בהתחלה (חובה)
  2. יש להעביר URL ENCODED אם מעבירים פרמטרים - לדוגמה סימנים של % & או $
  3. יש לבצע שמירה של הגדרות דף הסליקה לפני שימוש - דף סליקה חייב להיות מוגדר.
  4. שליחה של אחד מהשדות הנ"ל תמיד דורסת את ההגדרות של דף ההצלחה/כישלון/NOTIFY שנמצאות בהגדרות דף סליקה
  5. אם לא שולחים את השדות הנ"ל כחלק ממערך הפרמטרים המועברים בזמן העיסקה, הערכים יימשכו מהגדרות דף הסליקה
  6. אפשר לשלוח את זה פעם כן ופעם לא
  7. במידה וה-URL שישלח לא יהיה תקין, יישלח מייל לכתובת המייל של בעל המסוף בנוסח הבא:

Url address of success URL : XXXXX that you have send as parameter was invalid. Transaction time: 27-11-2017 11:11:10

 

 

עסקת תשלומים בדף סליקה

ברירת המחדל של עסקאות בטרנזילה היא עסקה רגילה. כלומר, כאשר שולחים את מינימום השדות ההכרחיים של פרטי עסקה, העסקה מועברת כעסקת אשראי רגילה.

 

בעבודה עם דף הדיירקט, קיימות שתי אפשרויות לביצוע עיסקאות תשלומים:

  1. הגדרת כמות תשלומים מקסימלית בעמוד הסליקה, דרך הגדרות דף הסליקה ( Merchant )
  2. שליחת משתנים לדף הסליקה מהטופס המקדים באתרכם.

 

 

הגדרת מספר תשלומים מקסימלי קבוע

כדי להגדיר מספר תשלומים מקסימלי קבוע, יש להכנס להגדרות דף הסליקה ( מערכת My Tranzila  > תפריט הגדרות >הגדרות דף סליקה)

ב "אפשרויות חיוב" תוכלו לבחור את מספר התשלומים המקסימלי שיופיע באופן קבוע בדף הסליקה.

 

 

 

 

 

שליחת משתנים לדף הסליקה מהטופס המקדים באתרכם

המשתנים שיש להעביר לעמוד התשלום עבור עיסקת תשלומים

תאור שם משתנה
שדה זה מתאר את סוג העסקה. על מנת לקבוע את העסקה כעסקת תשלומים, הכרחי לשלוח שדה זה כאשר הוא מכיל את הערך '8'. cred_type
שדה זה צריך להכיל את מספר התשלומים שאחרי התשלום הראשון.כלומר, מספר התשלומים הכללי פחות 1. npay
שדה זה צריך להכיל את סכום התשלום הראשון. fpay

שדה זה צריך להכיל את סכום כל תשלום שאחרי התשלום הראשון.

 spay

 

  • שים לב: כל השדות הנ"ל הכרחיים בעסקת תשלומים
  • האפשרות להבדל בין סכום התשלום הראשון לסכום כל תשלום שלאחריו קיים לשם העברת עסקאות בסכומים שאינם מתחלקים בצורה שווה במספר התשלומים הרצוי. למשל, 100 ש"ח  בשלושה תשלומים, לא ניתן להעביר בתשלומים שווים. לפיכך, יהיה צורך להבדיל בין סכום התשלום הראשון לסכום התשלומים האחרים, לדוגמה תשלום ראשון בערך של 34 ש"ח ותשלומים שני ושלישי בערך של 33 ש"ח.

 

תשלומים רגילים בדף סליקה

קיימות שתי אפשרויות :

  1. להעביר לדף סליקה\אייפריים כמות מקסימלית של תשלומים  עם הפרמטר   maxpay והערך יהיה כמות המקסימלית של תשלומים (קונה יוכל לבחור בדף סליקה\אייפריים כמות תשלומים עד כמות המקסימלית כולל כמות המקסימלית)

לדוגמה: maxpay=12

  1. אם יש צורך להגדיר כמות מדויקת של תשלומים (בלי אפשרות לבחירת הלקוח בדף סליקה\אייפריים) , ניתן להעביר לדף סליקה\אייפריים את הפרמטרים הבאים:
  • npay - מספר התשלומים פחות 1
  • fpay - סכום התשלום הראשון
  • spay -סכום השתלום השני ושאר התשלומים
  • cred_type - יש לשלוח את הערך 8 עבור תשלומים

בחישוב תשלומים הנוסחה לחישוב היא:

sum = fpay + spay*npay

  • כדי שיהיה שיוויון בין התשלום הראשון fpay לתשלום השני ושאר התשלומים spay , אתר לקוח טרנזילה צריך לחשב את הערך של כל אחד מהמשתנים כך שישלימו את הסכום הסופי sum באופן מדוייק.לערכים אלו יכולות להיות עד שתי ספרות אחרי הנקודה העשרונית (אם החלוקה מכילה ספרות אחרי נקודה עשרונית).
  • סכום התשלומים חייב להיות שווה לסכום הסופי לחיוב.
  • בכל מקרה על אתר הלקוח לחשב מתי ובאיזה תנאי (לדוגמה סכום העסקה או מחיר מוצר) יש להעביר פרמטרים של תשלומים.

תשלומי קרדיט

  • ההבדל בין תשלומים רגילים לתשלומי קרדיט הוא בקבלת התשלומים מחברת האשראי. בעיסקת תשלומים רגילה, הכסף יתקבל בתשלומים בהתאם למספר התשלומים שהוגדרו בזמן העיסקה. בתשלומי קרדיט, סכום העיסקה המלא יועבר ע"י חברת האשראי, וחברת האשראי תהיה זו שתתמודד עם התשלומים מול הלקוח המשלם, ולכן חברת האשראי גובה גם ריבית על כל תשלום.
  • בעיסקת תשלומי קרדיט יש מינימום של 3 תשלומים , לא פחות.
  • כדי לסלוק בתשלומי קרדיט, יש לקבל אישור מחברת האשראי עבור מספר הספק הסולק.

הפרמטרים שיש להעביר בתשלומי קרדיט:

cred_type=6

npay=3

  • עבור הפרמטר napy יש להגדיר את מספר התשלומים, אך לא פחות מ 3 תשלומים.
  • אין צורך להעביר את הפרמטרים fpay ו spay כיוון שהחלוקה מתבצעת בחברת האשראי.
  • חשוב לציין שבתשלומי קרדיט יש הגבלה על כמות המינימלית של תשלומים כנגד סכום העסקה. כלומר, כשמבחינת חברת האשראי הסולקת (כן, ההגבלה מוגדרת בין חברת אשראי לבין עסק) כמות התשלומים קטנה מדי בשביל סכום מסוים אז יתקבל סירוב עם שגיאה שמדברת על תשלומים. ולכן,כשרואים שגיאת תשלומים חובה להבין אם מדובר בתשלומים רגילים או בתשלומי קרדיט!

שים לב: אם סכומי התשלומים אינם שווים לסכום העסקה (הפרמטר sum ) מערכת טרנזילה תחזיר שגיאה
 

 

דף סליקה Iframe - הקדמה

מטרתה של התגית IFRAME  היא ליצור מסגרת inline אשר מאפשרת לארח מסמך אחר בתוך המסמך הקיים.

ה Iframe מאפשר שימוש בפתרון הרידיירקט של טרנזילה במסגרת האתר שלכם על מנת למנוע יציאה של לקוחות מחוץ לאתר וביצוע תשלום בסמגרת הבנויה בתוך אתרכם.

ה Iframe מאפשר להציג רק את שדות קליטת נתוני התשלום של עמוד הרידיירקט בתוך מסגרת עמוד התשלום Iframe  באתר שלך ועדיין לעמוד בתקן האבטחה המחמיר של חברות האשראי PCI-DSS .

שימו לב: אמנם אין צורך טכני בתעודת SSL בשימוש בדף הסליקה כ - iframe , אך על מנת להעניק לגולשים באתר תחושת ביטחון נוספת, בהחלט מומלץ לרכוש תעודת SSL . ניתן לעשות זאת דרך מחלקת המכירות של טרנזילה או דרך האתר:

http://www.hotssl.co.il

 

 

 

 

הטמעת Iframe

על מנת להתחיל להשתמש ב - iframe עליך להציב את הכתובת הבאה בתוך ה Iframe שלך באתרך:


https://direct.tranzila.com/USERNAME/iframenew.php

  •  במקום USERNAME יש לרשום את שם המסוף.
  • יש לבצע הגדרה ראשונית בהגדרות דף הסליקה Merchant על מנת שדף ה Iframe יבצע סליקה תקינה
  • במידה והנכם נדרשים ע"י חברת האשראי להקליד ת.ז. ו/או CVV, יש להגדיר אותם ב Merchant כשדות מופעלים.

מימדי ה - div שעליך להגדיר בתוך ה - iframe הם : 370px X 455px

 

משתנים חובה

תאור שם משתנה
סכום לחיוב sum
מטבע לחיוב currency
סוג התשלום cred_type

 

משתנים נוספים בהם ניתן להשתמש ב – Iframe

שם משתנה תאור
trBgColor צבע רקע (ב- hexadecimal )
trTextColor צבע טקסט
trButtonColor צבע הכפתור לתשלום
nologo=1 ביטול תצוגת הלוגו של טרנזילה
lang קביעת השפה ב - iframe
hidesum=1 הסתרת הסכום לתשלום.
ניתן להעביר רק במידה והעסקה נעשית באמצעות מערכת הטוקנים (מדריך נפרד) ורק אם אחד המשתנים הבאים נשלח:
tranmode=K או tranmode=VK
buttonLabel שינוי הטקסט של כפתור התשלום
ppnewwin=2 הוספת כפתור חיוב ב PAYPAL בעמוד ה IFRAME
recur_transaction שדה המיועד לשליחת בקשה לתשלום מחזורי.הערך יהיה מספר החיובים המחזוריים החוזרים, לדוגמה 4.מחייב רכישת מודול טוקנים ומודול חיובים חוזרים.

accessibility=2

 כפתור נגישות

 

 

דוגמאות לשליחת עיסקאות דרך Iframe

 

  • עיסקת חיוב רגילה

https://direct.tranzila.com/YOUR_TERMINAL_NAME/iframenew.php?sum=1&currency=1&cred_type=1

  • עיסקת אימות J5

https://direct.tranzila.com/YOUR_TERMINAL_NAME/iframenew.php?sum=1&currency=1&cred_type=1&tranmode=V

  • עיסקת תשלומים

https://direct.tranzila.com/YOUR_TERMINAL_NAME/iframenew.php?sum=100&currency=1&cred_type=8&npay=2&fpay=34&spay=33

  • עסקת חיוב כולל כפתור לתשלום ב PayPal

https://direct.tranzila.com/YOUR_TERMINAL_NAME/iframenew.php?sum=1&currency=1&cred_type=1&ppnewwin=2

  • עסקת חיוב מחזורי

https://direct.tranzila.com/YOUR_TERMINAL_NAME/iframenew.php?sum=5&currency=1&lang=il&recur_transaction=4

 

Iframe מעוצב - הקדמה

כל לקוח שרכש שירותי טרנזילה הכוללים שירותי Tranzila Direct מקבל אפשרות להשתמש באתר שלו בטופס תשלום שמתארח בשרתי טרנזילה העומדים בתקני אבטחה של חברות האשראי.

 

בברירת מחדל הטופס קיים בשתי גרסאות:

1. דף מלא אליו מופנה הגולש להשלמת תהליך הרכישה וביצוע תשלום.

2. דף קטן שנח לשים אותו בתוך <iframe>...> כדי להציג כחלק של אתר העסק.

 

ה-URL של דף סליקה המלא:

https://direct.tranzila.com/terminalname/

https://pay.tranzila.com/

(terminalname יש להחליף בשם המסוף)

 

ה-URL של דף המותאם ל-iframe:

https://direct.tranzila.com/terminalname/iframenew.php

 

קיים גם דף ניהול של שירותי ה-Direct ( ראו בסעיף "הגדרת דף הסליקה Merchant )

 

 

בדף ניהול ניתן להגדיר דברים שמשותפים לדף מלא ולדף המותאם ל-Iframe כגון URL של הצלחה וסירוב והצגת שדות מסוימים כמו ת.ז.

הוא כולל גם מס' הגדרות שמשפיעות רק על דף סליקה המלא ולא על דף המותאם ל-Iframe (כמו הגדרות בסיסיות של תצוגה ושדות מסוימים כמו שם מלא וכו').

 

את דף הסליקה המותאם ל-Iframe ניתן לעצב ע"י מס' פרמטרים שניתן לשלוח אליו ב-POST או ב-GET.

 

לפעמים אפשרויות עיצוב הקיימות בברירת מחדל לא מספיקות לצורכי העסק.

במקרה כזה אם בכוונתכם היה להשתמש בדף סליקה המלא נא נסו את דף המותאם ל-Iframe שע"י הפרמטרים נותן יותר אפשרויות עיצוב מדף המלא.

במידה וגם אפשרויות של דף המותאם ל-Iframe לא מספקות את צורכי העיצוב שלכם אז טרנזילה מאפשרת לכם לערוך את דף ה-Iframe עם כל עיצוב לבחירתכם ובהתאם לצרכי העסק שלכם

עליכם להיעזר במפתח Web שמתמחה ב-HTML, CSS ו-Javascript ומכיר את אתרכם מספיק כדי להטמיע בצורה נכונה את הדף המותאם ל-Iframe.

 

על המפתח לקחת מדפדפן את קוד המקור של דף המותאם ל-Iframe ולערוך את הקוד בתוך קובץ HTML לפי מס' דרישות שיוסברו בהמשך.

לאחר שסיימתם לעבד את הקובץ, יש לשלוח אותו לכתובת הדוא"ל שקבלתם מנציג התמיכה והוא יעביר את הקובץ לצוות הפיתוח לבדיקת תקינות.

במידה והקובץ עובר את הבדיקה בהצלחה העיצוב יוטמע,  ותקבלו אפשרות להשתמש בו בנוסף לאפשרויות הקיימות בברירת המחדל.

 

נא לעבור בעיון רב על כל המסמך (כולל מבוא) לפני תחילת כתיבת הקוד!

 

כדי לפתוח את המדריך ל IFRAME מעוצב יש ללחוץ כאן

מדריך ל IFRAME מעוצב באנגלית כאן

 

מודול חיוב מחזורי My Billing

מודול חיובים חוזר-מתחדש מאפשר לכם להגדיר חיובי מנוי.

דרישות להפעלת שרות חיובים חוזרים (My Billing)

  • רכישת מודול חיובים חוזרים
  • רכישת מודול טוקנים
  • יש לוודא מול חברת האשראי שמספר הספק שלכם אינו דורש CVV
  • שימו לב- לא ניתן לבצע עסקת תשלומים עבור עסקת חיוב חוזר, מעצם היותה עסקת חיוב מתחדשת.

 

ניתן להשתמש בשרות באחת משלושת הדרכים הבאות:

  • ידנית, דרך מערכת My Tranzila
  • הפעלת השרות דרך דף התשלום (הוספת כפתור לחיוב מחזורי)
  • שליחת שדות לחיוב מחזורי לדף התשלום

 

ניהול חיובים חוזרים My Billing מערכת My Tranzila

יש להכנס למסוף בעזרת שם המשתמש (כתובת המייל שאיתה נרשמתם לשרות) והסיסמה שלכם.

בתפריט הראשי , תחת ישומים נוספים יש לבחור " ניהול חיובים חוזרים- My Billing "

 

 

במסך שיפתח תוצג רשימת החיובים החוזרים הפעילים / לא פעילים , ופרטי החיוב החוזר. בנוסף יופיע כפתור להוספת חיוב חוזר באופן ידני.

 

 

הוספת הוראת חיוב

להוספת חיוב חוזר יש ללחוץ על כפתור "הוספת חיוב חוזר" בחלקה התחתון של רשימת החיובים החוזרים.

 

  • פרטי הלקוח - יש להזין את פרטי הלקוח המשלם בהוראת חיוב מחזורי
  • פרטי המוצר- יש להזין את פרטי המוצר עבורו מתבצע חיוב מחזורי, מחיר ליחידה וכמות יחידות.בפרטי החיוב יופיע סה"כ בהתאם למחיר וכמות היחידות.
  • פרטי חיוב- יש להזין את פרטי החיוב עצמו, תדירות החיוב (חודש / רבעון / שנה), תאריך חילת החיובים, יום החיוב בחודש (עד ה  28 בכל חודש) ,כמות החיובים החוזרים ( עד 60 / אחר / ללא הגבלה ) או לבחור בחיובמיידי חד פעמי .
  • פרטי אמצעי תשלום - יש לסמן את המסוף בו יתבצע החיוב המחזורי, מסוף זה נדרש להיותעם מספר ספק ללא דרישת CVV בצד חברת האשראי.
  • בסיום יש ללחוץ על "שמירה".
  • בסיום תוכלו לראות את שורת החיוב החדשה ברשימת החיובים החוזרים במסך הראשי.

 

הפעלת שרות חיוב חוזר בעמוד התשלום Pay Tranzila

ניתן להגדיר חיוב וזר עמוד התשלום Pay Tranzila

ניתן להציג את כפתור החיוב החוזר ללקוח או לחייב באופן אוטומטי כל עסקה בחיוב מחזורי ללא הצגת האפשרות ללקוח המשלם.

יש להכנס להגדרות דף הסליקה - במסוף יש לבחור בתפריט הראשי הגדרות > דף סליקה > אפשרויות חיוב

 

 

 

 

  • חיוב מחזורי - יש לבחור אם השרות מופעל או לא ( לא מופעל / בחירת לקוח / מופעל תמיד ) . במידה ותבחרו באפשרות "מופעל תמיד" הכפתור לא יוצג ללקוח המשלם.
  • מסוף לחיוב מחזורי - יש לבחור את המסוף בו יתבצע החיוב המחזורי, ועבורו אין דרישה בצד חברת האשראי ל CVV
  • תקופה לחיוב מחזורי - יש לבחור את תקופת הזמן לביצוע החיוב המחזורי (חודש/ רבעון / שנה).

 

במידה ואתם משתמשים בדפי מוצר בודדים  (ניהול מוצרים ) ניתן להגדיר גם לכל מוצר בנפרד חיוב מחזורי.

 

העברת פרמטרים לדף IFRAME לביצעו חיוב מחזורי

ניתן לבצע חיוב מחזורי דרך דף תשלום IFRAME , יש לשלוח את אחת האפשרויות הבאות:

תאור וערך שם שדה
ערך 4 עבור חיוב מחזורי חודשי לבחירה ע"י הלקוח recur_transaction
ערך 5 עבור חיוב מחזורי רבעוני לבחירה ע"י הלקוח  
ערך 7 עבור חיוב מחזורי שנתי לבחירה ע"י הלקוח  
ערך 4 עבור חיוב מחזורי חודשי ללא בחירה של הלקוח recur_transaction=4_approved
ערך 5 עבור חיוב מחזורי רבעוני ללא בחירה של הלקוח  
ערך 7 עבור חיוב מחזורי שנתי ללא בחירה של הלקוח  

***ניתן לקבוע את כמות הפעמים שהלקוח יחוייב בעזרת שדה recur_payments, אליו יש להעביר את מספר החיובים שיתבצעו. אם לא הועבר השדה, החיוב החוזר לא יהיה מוגבל וירוץ כל חודש/רבעון/שנה עד לכיבוי ידני מהמסוף.

דוגמה לשליחת בקשה עם הצגת חיוב מחזורי חודשי

https://direct.tranzila.com/YOUR_TERMINAL_NAME/iframenew.php?sum=1&currency=1&recur_transaction=4

 

 

דוגמה לשליחת בקשה ללא הצגת חיוב מחזורי חודשי

https://direct.tranzila.com/YOUR_TERMINAL_NAME/iframenew.php?sum=1&currency=1&recur_transaction=4_approved

 

 

הטמעת iframe עם עסקת חיוב מחזורי

העברת פרמטרים לדף IFRAME לביצעו חיוב מחזורי
 

בעסקה חיוב מחזורי לא ניתן להציג את כפתור ה-Bit.
אמצעי תשלום Bit אינו תומך בעסקאות חיוב מחזורי !

ניתן לבצע חיוב מחזורי דרך דף תשלום IFRAME . יש לשלוח את אחת האפשרויות הבאות:

תאור וערך שם שדה
ערך 4 עבור חיוב מחזורי חודשי לבחירה ע"י הלקוח recur_transaction
ערך 5 עבור חיוב מחזורי רבעוני לבחירה ע"י הלקוח  
ערך 7 עבור חיוב מחזורי שנתי לבחירה ע"י הלקוח  
ערך 4 עבור חיוב מחזורי חודשי ללא בחירה של הלקוח recur_transaction=4_approved
ערך 5 עבור חיוב מחזורי רבעוני ללא בחירה של הלקוח  
ערך 7 עבור חיוב מחזורי שנתי ללא בחירה של הלקוח  

 

***ניתן לקבוע את כמות הפעמים שהלקוח יחוייב בעזרת שדה recur_payments, אליו יש להעביר את מספר החיובים שיתבצעו. אם לא הועבר השדה, החיוב החוזר לא יהיה מוגבל וירוץ כל חודש/רבעון/שנה עד לכיבוי ידני מהמסוף.

*** ניתן לקבוע את תאריך תחילת החיובים בעזרת השדה recur_start_date, אליו יש להעביר את התאריך במבנה של yyyy-mm-dd:
 recur_start_date=2020-08-28

 

 

דוגמה לשליחת בקשה עם הצגת חיוב מחזורי חודשי

https://direct.tranzila.com/YOUR_TERMINAL_NAME/iframenew.php?sum=1¤cy=1&recur_transaction=4

 

 

דוגמה לשליחת בקשה ללא הצגת חיוב מחזורי חודשי

https://direct.tranzila.com/YOUR_TERMINAL_NAME/iframenew.php?sum=1¤cy=1&recur_transaction=4_approved

 

 

 

העברת עסקה בחיוב חוזר יחד עם תשלום רגיל

 

ניתן להעביר לטופס התשלום סכום לחיוב רגיל וסכום לחיוב חוזר בעזרת השדה recur_sum אליו יש להעביר את הסכום לחיוב חוזר כערך, לדוגמה:


https://direct.tranzila.com/naortest/iframenew.php?sum=100¤cy=1&lang=il&recur_transaction=4_approved&recur_payments=12&recur_sum=20

 

ניתן להעלים את הסכום לחיוב המיידי יש לשלוח hidesum כדי שלא יתבצע חיוב מיידי, לדוגמא:

tranmode=NK&hidesum=1

https://direct.tranzila.com/naortest/iframenew.php?sum=1¤cy=1&lang=il&recur_transaction=4_approved&recur_payments=12&recur_sum=20&tranmode=NK&hidesum=1

 

תשלום דרך Bit בדף הסליקה

הצגת כפתור Bit בדף הסליקה

לאחר הרשמה לשירות, ניתן להפעיל תשלום בביט דרך יישומים נוספים > ניהול דף סליקה:




שדות וערכים אפשריים:

ערכים אפשריים שם המשתנה תיאור
1 hide_cc הסתרת תשלום בכרטיס אשראי
1 bit_pay הצגת כפתור תשלום בביט


דוגמה לדף סליקה בתצורה iframe עם כפתור תשלום בBIT:
https://direct.tranzila.com/naortest/iframenew.php?sum=5&currency=1&cred_type=1&lang=il&bit_pay=1

 

 

Smoove – שליחת פרטי רוכש לחשבון סמוב

דף הסליקה של טרנזילה מאפשר שליחת פרטי רוכש לחשבון סמוב של לקוח שלנו במידה וקיים.
תיאור החיבור:
אחרי ביצוע עסקה ישלחו פרטי הרוכש לחשבון סמוב, בדומה לרב מסר.
*הפיתוח עובד גם מדף ריבוי המוצרים(Pay.tranzila) וגם מדף הסליקה בתצורת direct.


ביצוע הגדרה:
1. יש להתחבר לממשק My.tranzila, ולהיכנס להגדרות דף הסליקה דרך יישומים נוספים > ניהול דף סליקה.
2. להגדיר מפתח API של סמוב דרך לשונית אפשרויות חיוב(ניתן לייצא מפתח API ממערכת smoove ,דרך הגדרות -> מפתחות API):

 

ככה זה יראה לאחר הגדרה של מפתח API ושמירת השינויים:

 

אפשרויות נוספות:

1. כפתור "הצגת רשימות" מאפשר לבחור לאילו רשימות תתבצע השמירה של הלקוחות:


2. כפתור הגדרת שדות משמש למיפוי שדות לסמוב:


שם השדה(עמודה ראשונה) נלקח מסמוב.
פרמטר במערכת טרנזילה(עמודה שניה) – יש לבחור את הפרמטר לפי הגדרת השם שלו במערכת MY.Tranzila
הגדרת ערך הפרמטר(עמודה שלישית) – יותר מיועד לשדה שם לקוח(contact), שבסמוב הוא מפוצל לשם פרטי ושם משפחה (אצלינו הוא פרמטר אחד).

מספר דגשים:
*שינוי מפתח API מוחק את כל ההגדרות הקיום – קופצת התראה על כך.
*איפוס שדות לברירת מחדל מופיע במידה וביצעו הגדרה לשדות.
*במידה ולא בוחרים רשימות אז הלקוחות ישמרו במערכת סמוב ברשימה כללית.
*השדה מייל הוא היחיד שחובה מחינת סמוב ובמידה ואין אותו לא יהיה ניתן לשלוח אליהם את הלקוח.

 

 

התממשקות ל-PayPal - הקדמה

 

טרנזילה בשילוב PayPal

 

מערכת טרנזילה משלבת בתוכה שימוש במערכת PayPal ומאפשרת ללקוחותיה צורת תשלום נוספת לצד אפשרויות תשלום שונות הקיימות במערכת.

כעת בעלי עסקים המעוניינים לספק את אפשרות התשלום של PayPal יכולים לעשות זאת בקלות , תוך שימוש מלא במערכת טרנזילה.

מערכת טרנזילה מאפשרת ניהול חשבון סוחר (כרטיסי אשראי, העברות בנקאיות) וחשבון  PayPal בממשק יחיד ומתקדם בשפה עברית.

בממשק שליטה ובקרה זה התגובות והתצוגה זהות למצב הקיים במערכת טרנזילה ומביאות את השימוש במערכת לנוחות מירבית.

תהליך רכישה באמצעות PayPal בשילוב טרנזילה מורכב משלבים הבאים:

  • הלקוח לוחץ כפתור התשלום של PayPal באתר הסוחר
  • הלקוח נכנס לחשבונו ב - PayPal עם סיסמא ושם משתמש
  •  הלקוח בוחר אמצעי תשלום וכתובת למשלוח השמורים במערכת
  •  הלקוח לוחץ על כפתור האישור בעמוד PayPal וחזור לעמוד הסוחר

מערכת טרנזילה הינה שקופה מבחינת הגולש,ומאיצה את תהליך ההתממשקות מול PayPal .

 

 

 

 

הקמת חשבון עסקי ב - PayPal

על מנת להוסיף לאתרכם את אפיק התשלום של PayPal , עליך ליצור חשבון עיסקי במערכת PayPal Business Account . הליך הרישום למערכת PayPal פשוט ומהיר.

  1. יש להכנס לאתר PayPal בקישור הבא:

https://www.paypal.com/il/webapps/mpp/home

בזמן הקמת החשבון ב - PayPal חשוב לשים לב לפרטים הבאים:

  •  ציון לוגו של העסק, אשר יופיע בעת ביצוע העיסקה (הלוגו חייב להיות ממוקם תחת https )
  •  בחירת מטבע ראשי
  •  הגדרת הודעות תשלום מיידיות (IPN-הסבר בנושא IPN בהמשך).

 

בטופס PayPal , יש למלא את כל פרטי העסק והחשבון בהתאם לדרישת PayPal

לאחר הרישום לשירות תקבלו מספר נתונים, אשר יוזנו במערכת טרנזילה עם הקמת חשבון

 

 

חיבור חשבון PayPal לטרנזילה דרך דף הסליקה

 

 

התממשקות ל – PayPal בעזרת Redirect / Iframe

 

כדי להגדיר את PayPal  בטרנזילה, יש לבצע הגדרות בצד טרנזילה ובצד PayPal

  • חשוב מאוד- לקוחות העובדים ב API לא יוכלו להתממשק ל PayPal במסוף העובד ב API, ולכן יזדקקו למסוף בן אותו הם יגדירו לעבודה עם PayPal .

 

שלבי הגדרת ההתממשקות מול PayPal ללקוח העובד עם דף דיירקט / Iframe :

  1. יש להכנס להגדרות דף הסליקה Merchant (ראו סעיף הגדרות דף סליקה) ולסמן את כפתור ה PayPal כמופעל.
  2. ב IFRAME, יש להעביר את השדה והערך ppnewwin=2 עם כל שאר השדות הנשלחים לעמוד התשלום ,כדי שכפתור PAYPAL יופיע בעמוד התשלום.

  1. במסוף הסליקה יש להגדיר את תצורת העבודה. תפריט > הגדרות >מסוף>שיטת עבודה

 

 

  1. בשדות הכתובת המפנה יש להוסיף את כתובת דף הסליקה , כולל שם המסוף שלכם (במקום your_terminal_name ) , לדוגמה:

https://direct.tranzila.com/your_terminal_name/

https://pay.tranzila.com/your_terminal_name/

https://direct.tranzila.com/your_terminal_name

https://pay.tranzila.com/your_terminal_name

https://direct.tranzila.com/your_terminal_name/iframe.php

https://direct.tranzila.com/your_terminal_name/iframenew.php

  1. בשדה "לעיסקה מאושרת URL " יש להוסיף את כתובת דף ההצלחה שלכם, כפי שהוגדרה בהגדרות דף הסליקה  Merchant.
  2. בשדה "לעיסקה שנדחתה URL " יש להוסיף את כתובת דף הכישלון שלכם, כפי שהוגדרה בהגדרות דף הסליקה Merchant .
  3. בסיום יש לבצע שמירה של ההגדרות.
  • שימו לב הקישורים בתמונה הנ"ל שמתחילים ב -  direct , שייכים לשרותי דף הסליקה של טרנזילה, בהם הכרחי להשתמש במידה ועובדים דרך דף הסליקה של טרנזילה (Redirect / Iframe ).

 

  1. כעת יש להכנס לחשבון ה PayPal שלכם.במסך הראשי יש לבחור ב Seller preference

 

  1. בתפריט יש לבחור ב API access

 

  1. יש לבחור באפשרות 2 - View API Signature  (ובכל מקרה לא לבחור ב API  Permission )

  1. יש להציג את שם המשתמש, סיסמה וחתימה ולבצע להם העתקה, לצורך הגדרתם בחשבון טרנזילה.

API Username

API Password

API Signature

  1. לאחר שהעתקתם את הערכים הנ"ל, יש להכנס למסוף הסליקה ,במסוף יש להכנס להגדרות >PayPal  ולהגדיר את פרטי המשתמש שהעתקם מ PayPal

  • יש לסמן את סוג החשבון פעיל
  1. יש להכנס שוב לחשבון ה PayPal שלכם.במסך הראשי יש לבחור ב Seller preference 

 

 

  1. יש לבחור ב Instant Payment Notifications 

יש להפעיל את שירות ה-IPN ע"י לחיצה על "Receive IPN Messages"  ולציין את ה-URL הבא:

 

https://secure5.tranzila.com/cgi-bin/tranzila31n.cgi?supplier=terminal

  • שימו לב – במקום המילה TERMINAL יש לרשום את שם המסוף.

 

 

 

חיבור חשבון PayPal מכפתור חיצוני

עבודה בשירות PayPal מתבצעת בצורת הפנית דפדפן (Redirect).

בדומה לעבודה עם מערכת טרנזילה, בכדי לשלוח את נתוני העיסקה לטרנזילה יש להפנות את הטופס ל-URL הבא:

 

https://secure5.tranzila.com/cgi-bin/tranzila31p.cgi

 

  • טופס יכיל את נתוני העיסקה, את פרמטרי חובה ובעת הצורך גם פרמטרים של  PayPal (קבועים מראש).
  •  על הטופס להישלח ב-Post.
  • במידה ובחרתם להשתמש באפשרות זו, יש לבצע את ההגדרות במסוף הסליקה כפי שמוסבר בסעיף  " התממשקות ל – PayPal בעזרת  Redirect / Iframe " ללא קישורי דף הסליקה של טרנזילה.
  • טופס המבצע תשלום באמצעות PayPal יכיל כפתור או מספר כפתורים של ביצוע הפעולה. קיימים כפתורי PayPal שונים המתאימים לסוגי פעולות שונים.
  • את הכפתורים החדשים של  PayPal ניתן לקבל בקישור הבא:

https://www.paypal.com/newlogobuttons

 

להלן דוגמא לטופס השולח עיסקת PayPal דרך מערכת טרנזילה:
 

< html >
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=windows-1255">
    <title>Tranzila Test</title>
  </head>
  <body dir="rtl">
  <form action="https://secure5.tranzila.com/cgi-bin/tranzila31p.cgi" method="POST">
  <input type="hidden" name="supplier" value="terminalname">
  <input type="hidden" name="currency">
  <table align="center">
  <tr>
    <td>סכום העיסקה</td>
    <td><input type="text" name="sum" value="2"></td>
  </tr>
  <tr>
    <td>תאור מוצר</td>
    <td><input type="text" name="pp_DESC"></td>
  </tr>
  <tr>
    <td colspan="2" align="center">
      <input type="submit" value="שלח">
    </td>                
  </tr>            
  </table>
  </form>
  </body>

< / html >

 

 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>

  <head>

    <meta http-equiv="Content-Type" content="text/html; charset=windows-1255">

    <title>Tranzila Test</title>

  </head>

  <body dir="rtl">

  <form action="https://secure5.tranzila.com/cgi-bin/tranzila31p.cgi" method="POST">

  <input type="hidden" name="supplier" value="terminalname">

  <input type="hidden" name="currency">

  <table align="center">

  <tr>

    <td>סכום העיסקה</td>

    <td><input type="text" name="sum" value="2"></td>

  </tr>

  <tr>

    <td>תאור מוצר</td>

    <td><input type="text" name="pp_DESC"></td>

  </tr>

  <tr>

    <td colspan="2" align="center">

      <input type="submit" value="שלח">

    </td>                                               

  </tr>                          

  </table>

  </form>

  </body>

</html>

 

משתני טרנזילה ומשתני PayPal

ב- PayPal קיימים משתנים שהוגדרו ע"י מערכת מראש וניתן להשתמש בהם במערכת טרנזילה.

משתני PayPal מחולקים לשני סוגים:

  • משתנים הנשלחים ממערכת PayPal ונשמרים במערכת טרנזילה
  • משתנים הנשלחים למערכת PayPal ממערכת טרנזילה

להגדרת שמות השדות יש להכנס ללוח הבקרה למסך "הגדרות" ◄ "הגדרה 2". משתני PayPal יוגדרו בחלק השלישי של מסך זה.

שם פרמטר של PayPal במערכת טרנזילה מורכב מהתחלה של pp_ ושם הפרמטר.

 

 

 

נתונים שניתן לקבל ממערכת PayPal

 

נתונים חשובים שניתן לקבל PayPal ואפשר לקבל מ- להגדיר כחלק מ-20 משתנים חופשיים:

תוכן הפרמטר שם הפרמטר במערכת טרנזילה
 
האם הלקוח המשלם אומת ע"י PayPal pp_payer_status
אי-מייל של הלקוח כפי שרשום ב-  PayPal pp_payer_email
שם ושם משפחה של הלקוח כפי שרשום ב-  PayPal pp_first_name, pp_last_name
האם כתובת הלקוח אומתה ב-  PayPal pp_address_status
כתובת הלקוח כפי שרשומה ב-  PayPal pp_address_street
מיקוד שרשום ב-  PayPal pp_address_zip
קוד מדינת הלקוח pp_address_country_code
מדינת הלקוח כפי שרשומה ב-  PayPal pp_address_country
עיר מגורים הלקוח pp_address_city
עמלת הסוחר ל PayPal עבור העיסקה pp_payment_fee

 

 

נתונים שניתן לשלוח ממערכת טרנזילה ל-PayPal

 

ממערכת טרנזילה ניתן לשלוח פרמטרים המתארים את העיסקה. נתונים אלה ישמרו בחשבון העיסקי ב-PayPal לצד העיסקה.

את הפרמטרים הנשלחים ל-PayPal יש להגדיר בטופס התשלום ואם תרצו להציגם בממשק טרנזילה, יש להגדירם גם בלוח הבקרה כחלק מ-20 המשתנים הנוספים.

תוכן הפרמטר שם הפרמטר במערכת טרנזילה
תאור מוצר יחיד pp_DESC
תאור מוצרים מרובים, שימושי בעגלת קניות pp_L_NAME1, pp_L_NAME0
סכום לתשלום עבור כל מוצר בעגלה pp_L_AMT1, pp_L_AMT0
כמות של כל מוצר בעגלה pp_L_QTY1, pp_L_QTY0

 

 

אבטחת מידע - התמודדות עם הונאות

רכישות מקוונות הופכות פופולריות יותר משנה לשנה, ושיטות גניבת המידע באינטרנט הולכות ומשתכללות.

במקביל, הולכות ומשתכללות גם שיטות אבטחת האתרים.

 

טרנזילה מספקת לכם מספר פתרונות אבטחה שמטרתם ניטור ואיתור פעילות הונאה במהירות, ממש בסמוך לזמן התרחשותה.

אנו ממליצים ליישם את פיתרון ה HandShake למניעת עיסקאות ההונאה שיפורטו בהמשך.

 

 

התמודדות עם הונאות - HandShake

בפתרון מניעת הונאות ע"י ביצוע HandShake , מתבצעת פניה לטרנזילה, לפני הפנית הלקוח המשלם לדף הסליקה, בה נוצר מזהה ייחודי עבור סכום ופרטי העיסקה.

המזהה הייחודי יועבר לאחר קבלתו גם לעמוד התשלום,יחד עם שאר נתוני העיסקה, רק שם יקליד הלקוח המשלם את פרטי הכרטיס לחיוב.

במידה וסכום העיסקה ישתנה, ופרטי העיסקה לא יהיו זהים לנתונים השמורים אצלנו עם המזהה הייחודי, לא תתבצע כלל עיסקה ותתקבל שגיאה עם קוד ייחודי.

  • אנו ממליצים להטמיע ולהשתמש בפיתרון ה- HandShake למניעת עיסקאות הונאה.
  • שימוש בפתרון Hand Shake מחייב רכישת מודול טוקנים.
  1. יש להכנס להגדרות דף הסליקה (ראו סעיף "הגדרת דף הסליקה Merchant )
  2. יש להכנס ל "אבטחת מידע"  ולסמן את שדה Hand Shake כמופעל.

  • מרגע הפעלת פונקציית ה HandShake , לא תוכלו לסלוק ללא קבלת טוקן ה HandShake, כלומר, הפיתרון יהיה חייב להיות מוטמע באופן מלא כדי שתוכלו לסלוק בצורה תקינה.
  1. יש לשלוח בקשה ל handshake לפני העברת הטרנזקציה לדף הסליקה.
  2. ה-URL לביצוע לחיצת יד:

https://secure5.tranzila.com/cgi-bin/tranzila71dt.cgi

  1. יש להעביר אליו את כל שורת הבקשה.

מס' כללים עבור השורה:

  • פרמטרים הכרחיים
תאור שם שדה
סכום העיסקה לחיוב sum
סיסמאת עסקאות (יש לפנות אלינו כדי להגדיר פר מסוף) - את הפרמטר הזה אין להעביר לדיירקט מטעמי אבטחה TranzilaPW
שם מסוף supplier
יש לשלוח את הערך 1, כלומר op=1 op

 

 

  • אין להעביר את מס' כרטיס ו-CVV בשלב ה-Handshake- אלה אמורים להילקח מדף הסליקה מטעמי דרישות ה-PCI. אבל אם תעבירו - הם ידרסו את מה שיוזן בדף הסליקה.
  • כל פרמטר פונקציונלי שלא תעבירו בשלב לחיצת היד ושיוזן בדף הסליקה או יישלח אליו - תתבצע הפונקציה שלו. לדוגמה: אם לא שלחתם בלחיצת היד פרמטר של מטבע (currency) אז הפרמטר יילקח מדף הסליקה.
  1. tranzila71dt.cgi מחזיר פרמטר thtk עם שורת זיהוי טרנזקציה. את הפרמטר הזה עם הערך שהתקבלו יש לשלוח לדף הסליקה יחד עם הפרמטרים הרגילים ששולטים על תצוגת הדף (כמו סכום, מטבע וכו').
  2. לאחר שליחת הטופס ולפני ביצוע עסקה תתבצע השוואת סכום בין מה ששלחתם בלחיצת היד לבין מה שנשלח מדף הסליקה. במידה והסכום אינו זהה - יודפס "Illegal Operation 912791" ללא ביצוע שום עסקה. במידה והסכום זהה - העסקה תצא לביצוע עם הפרמטרים שנשלחו בלחיצת היד, הם גם אלה שיחזרו בתום ביצוע עסקה.
  3. במידה וינסו לגשת לדף הסליקה כדף עצמאי ולא יתבצע handshake , יודפס "Illegal Operation 275497 "

שימו לב: נתונים של כל לחיצת יד נשמרים 20 דקות. כדי לשמר אפשרות של דיירקט לביצוע נסיונות חוזרים. כל ולידיציה מוצלחת מאפסת את ספירת הזמן.

 

כתובת שירות Handshake למסופים המוגדרים עם שירות 3DS

כתובת שרת:

https://api.tranzila.com/v1/handshake/create

לכתובת יש לפנות בGET עם שם המסוף, סיסמת TranzilaPW והסכום שמאמתים:

https://api.tranzila.com/v1/handshake/create?supplier=yourteminalname&sum=1&TranzilaPW=YourTerminalPassword

 

קריאה כזאת תחזיר thtk עם טוקן לאימות שאותו יש לשלוח לiframe.
בנוסף, יש להעביר לiframe את השדה new_process=1 כדי שידע לעבוד עם ההנדשייק החדש.

 

$tranzila_api_host = 'secure5.tranzila.com';
$tranzila_api_path = '/cgi-bin/tranzila71dt.cgi.cgi';
 
// Prepare transaction parameters
$query_parameters['supplier'] = 'TERMINAL_NAME';// 'TERMINAL_NAME' should be replaced by actual terminal name
$query_parameters['sum'] = '5'; //Transaction sum
$query_parameters['currency'] = '1'; //Type of currency 1 NIS, 2 USD, 978 EUR, 826 GBP, 392 JPY
$query_parameters['TranzilaPW'] = 'TranzilaPW'; // Token password if required
$query_parameters['op'] = '1'; //Required for handshake
// Prepare query string
$query_string = '';
foreach ($query_parameters as $name => $value) {
    $query_string .= $name . '=' . $value . '&';
}
 
$query_string = substr($query_string, 0, -1); // Remove trailing '&'
 
// Initiate CURL
$cr = curl_init();
 
curl_setopt($cr, CURLOPT_URL, "https://$tranzila_api_host$tranzila_api_path");
curl_setopt($cr, CURLOPT_POST, 1);
curl_setopt($cr, CURLOPT_FAILONERROR, true);
curl_setopt($cr, CURLOPT_POSTFIELDS, $query_string);
curl_setopt($cr, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($cr, CURLOPT_SSL_VERIFYPEER, 0);
 
// Execute request
$result = curl_exec($cr);
$error = curl_error($cr);
 
if (!empty($error)) {
    die ($error);
}
curl_close($cr);
 
// Preparing associative array with response data
$response_array = explode('&', $result);
$response_assoc = array();
if (count($response_array) > 1) {
    foreach ($response_array as $value) {
        $tmp = explode('=', $value);
        if (count($tmp) > 1) {
            $response_assoc[$tmp[0]] = $tmp[1];
        }
    }
}
die ($result . "\n");
 
 
?>
 

התמודדות עם הונאות - Notify URL

חשוב לוודא את תוצאת הסליקה, כלומר, גיבוי של סכום העסקה ששולם בפועל.

דף Notify מיועד לקבלת נתוני העיסקה כפי שבוצעה בפועל, וזיהוי שינויים שבוצעו בנתוני העיסקה לאחר שליחתם. עם זיהוי השינויים , תקבלו התרעה ותוכלו למנוע את הוצאת הסחורה ו/או ליצור קשר עם הלקוח להמשך בירור.

כדי להמנע מכניסה למסוף הסליקה לאחר ביצוע כל עיסקה, תוכלו להגדיר את דף ה- Notify בהגדרות דף הסליקה (Merchant), אשר יקבל את נתוני העיסקה כפי שהוכנסו במקור בעמוד התשלום, ולהשוותם לנתוני העיסקה שהועברו דרך דפדפן הלקוח המשלם.

במידה ותזהו כל שינוי בפרטי העיסקה מול הנתונים שהועברו לדף ההצלחה מול נתוני העיסקה שהועברו לדף ה Notify,  תוכלו לבחור האם לבטל את העיסקה,או ליצור קשר עם הלקוח המשלם לבירור.

קישור זה אינו מוצג לגולשים ונשלח ללא ידיעתם במקביל להעברתם לדף ההצלחה / כישלון, ולכן תוכלו לנטר את העיסקאות בזמן אמת ולזהות הונאות רשת.

  • חשוב להדגיש- הונאת סליקה אינה מתבצעת בתוך עמוד התשלום של טרנזילה, דף התשלום הינו דף מאובטח תחת תקן PCI DSS ו SSL.
  • שימו לב - חובת הבדיקה בזמן אמת לטרנזקציות והשוואתן למסד הנתונים היא באחריותכם הבלעדית! בנוסף, חשוב לוודא כי התרעה על נסיון הונאה תישלח למנהל האתר (בדוא"ל, SMS או דרך מערכת ניהול האתר).

 

הגדרת Notify URL

  1. כדי להגדיר את דף ה NOTIFY , יש להכנס להגדרות דף הסליקה Merchant (כניסה למסוף > תפריט > הגדרות> הגדרות דף סליקה)
  1. יש להכנס ל "אבטחת מידע" , שם יש להגדיר את כתובת ה URL עבור קבלת ה NOTIFY

**לקוחות המשתמשים ב- NOTIFY URL  שה NOTIFY נכשל, יתבצעו 5 ניסיונות נוספים לשלוח ללקוח את ה NOTIFY בהפרש של 5 דקות. לאחר 5 כישלונות יישלח מייל ללקוח עם הודעה על כישלון ה NOTIFY .

 

התמודדות עם הונאות - טוקניזציה

בהתאם להנחיות חברות האשראי, חל איסור לשמור מספר כרטיס אשראי על ידי ספקים שלא קיבלו על כך אישור מפורש מחברות האשראי.

לצורך כך פיתחנו פתרון בשם טרנזילה Token שמאפשר שמירה של מספר כרטיס אשראי לצורך שימוש במועד מאוחר יותר (למשל עבור הוראות קבע).

פתרון הטוקניזציה מאפשר לכם לבצע את העיסקה הראשונה כעיסקת אימות (J5) ללא חיוב בפועל , לצורך ביצוע ולידציה (אימות) על תקינות הכרטיס וסכום העיסקה, יצירת טוקן לכרטיס האשראי ולאחר מכן ביצוע החיוב האמיתי עם הסכום האמיתי בעזרת הטוקן בלבד ב API .

חשוב:
לשם עבודה עם טוקנים, ומכיוון שלא ניתן להצפין או לשמור את הCVV, ברוב המקרים חברת האשראי דורשת 2 מסופים: אחד ליצירת הטוקן והשני לחיוב הטוקן.
המסוף שמיועד לחיוב הטוקן צריך להיות מוגדר בחברת האשראי ללא דרישת CVV, כדי לאפשר חיובים חוזרים.

המסופים מוקמים בצורה הזאת עם רכישת שירות הטוקנים.

מידע כללי על אופן עבודת המערכת:

טרנזילה Token פועל על פי התהליך הבא:

  1. לקוח הקצה מקליד את מספר כרטיס האשראי בדף סליקה שקיבל הסמכת תקן אבטחה PCI  כגון דף הרידיירקט או ה-Iframe של טרנזילה.
  2. דף הסליקה מעביר את הנתונים אל שרתי טרנזילה ושם מתבצעת המרה של מספר כרטיס האשראי למחרוזת אקראית בת 19 תווים שלא ניתן לפענח אותה בחזרה למספר כרטיס האשראי המקורי (למעט 4 הספרות האחרונות שכן נשמרות).
  3. שרתי טרנזילה מחזירים את המחרוזת אל דף ההצלחה או לכל כתובת יעד אחרת שתוגדר.

 

  • תנאי מקדים הוא הגדרת סיסמת עיסקאות, פעולה זו מתבצעת בעת הקמת המסוף או הגדרת הסיסמה באמצעות בקשה מסודרת במייל. את הבקשה יש להעביר לכתובת service@interspace.net

 

קבלת טרנזילה Token:

קיימות 2 דרכים לבצע פעולה זו:

  1. הפניית הלקוח לצורך הקלדת מספר כרטיס האשראי אל דף טרנזילה דיירקט או Iframe עם אחד מערכי המשתנים הבאים:
  • tranmode=K עבור קבלת Token ללא סכום או חיוב בפועל - אנו לא ממליצים לעבוד בתצורה זו כיוון שלא מתבצעת ולידציה על תקינות הכרטיס
  • tranmode=VK עבור קבלת Token שעבר עסקת אימות (J5) בסכום שנשלח.
  • tranmode=AK עבור עיסקת חיוב רגילה שעברה בהצלחה בלבד.
  1. במידה וקליטת מספר האשראי נעשית דרך דף סליקה חיצוני שקיבל תקן PCI יש להעביר את המשתנים הבאים אל הכתובת:


https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

בנוסף יש להעביר פרמטר מיוחד שנועד למנוע ניצול לרעה של המערכת בשם TranzilaPW.

  • שים לב- אין להעביר את הפרמטר TranzilaPW  בזמן הנפקת טוקן דרך דף סליקה redirect / Iframe

שמות פרמטרים שחובה לשלוח (יש משמעות לאותיות גדולות וקטנות):

תאור שם שדה
שם מסוף supplier
סיסמת טוקנים TranzilaPW
מספר כרטיס מלא ccno
יש להעביר את הערך 1 TranzilaTK
  • שים לב- פעולה זו תחזיר רק TOKEN  ולא תייצר עיסקה.

 

בשלב הבא יבוצע החיוב עם הטוקן והסכום האמיתי. לפירוט החיוב עם הטוקן ב API יש לפנות למדריך למפתח:

http://doctr6.interspace.net/?type=1#go_menu_content_79

 

מס"ב- מערכת סליקה בנקאית

מס"ב -מערכת סליקה בנקאית, אשר תפקידה לבצע סליקות הוראות קבע בנקאיות מול מערכת טרנזילה.

ההטמעה של מערכת מס"ב וסליקה בכרטיסי אשראי נעשית באותו האופן.

דרישות לעבודה מול מס"ב:

  1. קבלת קוד מוסד ממס"ב והעברתו אלינו לצורך חיבור למסוף הסליקה.
  2. רכישת מודול מס"ב.
  3. החתמת הלקוח המשלם על אישור סליקת הו"ק בנקאית.

 

 

חיוב מס"ב ב- API

סוג פעולה: ביצוע חיוב הוראת קבע בנקאית

כתובת (POST):

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi

דוגמה לשליחת בקשה לחיוב הו"ק בנקאית:

https://secure5.tranzila.com/cgi-bin/tranzila71u.cgi?supplier=test&sum=1&currency=1&bank=10&branch=123&account=11111&tranmode=T

 

תאור שדה שם שדה
שם מסוף supplier
סכום לחיוב sum
חיובי מס"ב מתבצעים בש"ח בלבד, יש לשלוח את הערך 1 currency
יש לשלוח את הערך T tranmode
קוד בנק (2 ספרות) bank
קוד סניף (3 ספרות) branch
מספר חשבון בנק (5-7 ספרות) account

שדה זה מציין את הסיסמא לשירותי טרנזילה.

*יש לשלוח רק במידה ומערכת הטוקנים מופעלת והוגדרה סיסמאת עסקאות

 TranzilaPW

דגשים לשרות מס"ב:

  • בעסקאות הו"ק בנקאיות (מס"ב) ניתן לסלוק רק בש"ח.
  • לא ניתן לבצע זיכוי או ביטול עסקה עבור עסקאות מס"ב, ביטול או זיכוי עסקת מס"ב יבוצע ישירות מול הבנק, במידה והעסקה שודרה למס"ב.
  • לא ניתן לבצע עסקאות תשלומים בעסקת מס"ב.
  • ניתן להוסיף שדות חופשיים נוספים כגון שם הלקוח המשלם, כתובת מייל וכ"ד , כפי שמתבצע בעסקאות כרטיסי אשראי.
  • יש להגדיר במסוף עצמו את תאריכי השידור ושעת השידור למס"ב. ניתן להגדיר שידור קבוע ברמה יומית,שבועית או חודשית.