CGRedirect · ךותמ דומע - סקפ - ןופלט לאומש תעבג ןוירוג ןב מ"עב דראג טידרק םייוניש תמישר ךרוע םידומע רואת ךיראת

28 מתוך 1 עמוד www.creditguard.co.il ,03-7370790, פקס: 03-7370737, גבעת שמואל , טלפון: 18קרדיט גארד בע"מ, בן גוריון

CGRedirectתבניות ממשק

2.5גרסא:

13/08/2012תאריך:

CreditGuard 2011 LTD ©

All rights reserved

גרסא מחבר תאריך הערה מסמך

עידן גוזלן 06/01/2011 1.0

צביקה וליץ 06/11/2011 2.0

עידן גוזלן 22/11/2011 2.1

שני קלימן 13/12/2011 2.2

עידן גוזלן 29/12/2011 2.3

נועם שיש 07/05/2012 2.4

איתמר לסק 13/08/2012 2.5

אישור


רשימת שינויים

גרסא תאריך תאור עמודים עורך

1.0 06/01/2011 גרסא ראשונה כל המסמך עידן גוזלן

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

06/11/2011 2.0

CVV 22/11/2011 2.1הוספת סיבה ל 4 עידן גוזלן

userData1-10 13/12/2011 2.2-הוספת נספחים לשימוש ב כל המסמך שני קלימן

2.4 07/05/2012 הוספת הסבר בנוגע לתשלומים כל המסמך נועם שיש

2.5 13/08/2012 שינוי פורמט המסמך כל המסמך איתמר לסק

ייניםתוכן ענ

4 כללי

4 .......................................................................................................................................... רקע .1

5 ............................................................................................................. הבסיסית התבנית הכרת .2

6 ................ (שלב אחר שלב) האשראי כרטיס פרטי קליטת בדף לתצוגה המחדל ברירת בתבניות שימוש .3

6 .............................................................................. (שלב אחר שלב) אישית מותאמת תבנית יצירת .4

7 ......................................................................................................... מחדל ברירת תבניות פירוט -' א נספח

7 .................................................................................................................................... 0 פורמט .1

9 .................................................................................................................................... 1 פורמט .2

10 .................................................................................................................................. 2 פורמט .3

11 .................................................................................................................................. 3 פורמט .4

12 ..................................................................................................... אישית מותאמת תבנית יצירת -' ב נספח

12 ................................................................................................................................... הקדמה .1

12 שלב אחר שלב .2

15 ..................................................................................................................... נוספים פרמטרים .3

USERDATA1-10 .............................................................................................. 18 בשדות שימוש –' ג נספח

18 ................................................................................................................................... הקדמה .1


21 ...................................................................................................... דינאמיים בפרמטרים שימוש –' ד נספח

21 ................................................................................................................................... הקדמה .1


21 ..................................................................................................................................דוגמאות .3

25 ............................................................................................................... מידע אבטחת הנחיות –' ה נספח

25 ................................................................................................. ספציפיות מידע אבטחת הנחיות .1


LOADING: ................................................................................................................... 27 מנגנון –' ו נספח

27 .................................................................................................................................. :הקדמה .1

27 :במנגנון שימוש .2


כללי

רקע .1

ע"י כך שבאמצאות ממשק זה PCI DSSמשמש מערכת משלימה לעבודה בתקן CGRedirectממשק ה 1.1

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

.CreditGaurdבשרתי

.HTML FORM יעודי המציג WEBבדפדפן בדף פרטי כרטיס האשראי נעשית קליטת 1.1

פרטי האשראי. קליטתמסך כברירת מחדל לתצוגת מציע מספר תבניות CGRedirectממשק 1.1

פרטי האשראי בהתאם לצרכים קליטתמאפשר לשנות את תצוגת מסך CGRedirectבנוסף ממשק 1.1

העסקיים של הסוחר.

.CGRedirectממשק של תבניות ברירת מחדל על יפרטמסמך זה 1.1

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

האשראי.כרטיס

.CGRedirect-לקוחות המעוניינים לבצע התאמה אישית לעיצוב ממשק המסמך זה הינו רלוונטי עבור 1.1

ויש לקרוא אותם לפני עיון במסמך זה. CGRedirect-המסמך מסתמך על מסמכי האפיון של ה 1.7.1

CGRedirect Transaction Setup

CGRedirect Security Procedures for Custom Hosted Page

מסמך זה ידון בנושאים לפי החלוקה הבאה: 1.1

הכרת התבניות הבסיסיות 1.8.1

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

יצירת תבנית מותאמת אישיתהסבר על השלבים ל 1.8.3

וט תבניות ברירת מחדלפיר 1.8.4

יצירת תבנית מותאמת אישיתהסבר מפורט על 1.8.5

מידע אבטחת מגבלות 1.8.6


הכרת התבנית הבסיסית .1

מאפייני התבנית 1.1

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

לריבוי הוראות בנוגע (אולם ישנה תמיכה מלאה בריבוי שפות ,התבניות אינן תומכות בריבוי שפות 2.1.2

.)שפות בהמשך המסמך

התבנית מורכבת משני אזורי תצוגה 2.1.3

מציג את פרטי העסקה: )ממוקם בצדו העליון של הדף( –אזור א' 2.1.4

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

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

האשראי.מציג את שדות הקלט לפרטי כרטיס –אזור ב' 2.1.5

מספר כרטיס

תוקף

CVV

תעודת זהות

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

.)פרטי תשלומים )במקרה הצורך

:כברירת מחדל לתבניות מספר פורמטים 1.1

, פרטי , ת.זCVVפרטי העסקה, מספר כרטיס, תוקף כרטיס, תנאי העסקה, מציג: 0פורמט 2.2.1

הצורך(.תשלומים )במקרה

, פרטי תשלומים )במקרה הצורך(.מספר כרטיס, תוקף כרטיסתנאי העסקה, מציג: 1פורמט 2.2.2

, פרטי תשלומים )במקרה הצורך(.תנאי העסקה, פס מגנטי מציג: 2פורמט 2.2.3

, פרטי תשלומים )במקרה פרטי העסקה, מספר כרטיס, תוקף כרטיסתנאי העסקה, מציג: 3פורמט 2.2.4

הצורך(.

לומי המסך של התצוגה הסופית של כל פורמטיאת צלמצוא המסמך ניתןבהמשך 2.2.5

בקש מנציג קרדיטגארד את הדוגמה הרצויה.ל יש 2.2.6

דף הזנת פרטי כרטיס אשראי: 1.1

enterCreditCardDetails.jsp הינופרטי כרטיס האשראי קליטת שם קובץ 2.3.1

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


ימוש בתבניות ברירת המחדל לתצוגה בדף קליטת פרטי כרטיס האשראי )שלב אחר שלב(ש .1

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

CGRedirectאנא עדכן את איש המכירות של קרדיט גארד כי הינך מעוניין בחשבון טסט עבור 1.1

שה לחשבון הטסטנציג התמיכה יעדכן אותך בפרטי הגי 1.1

על מנת לבחור את התבנית הרצויה עבורך)פירוט תבניות ברירת מחדל( אנא העזר בנספח א' 1.1

אנא יידע את נציג קרדיט גארד על בחירת התבנית 1.1

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

()שלב אחר שלב יצירת תבנית מותאמת אישית .1

אם בחרת לשנות את תצוגת דף קליטת פרטי כרטיס האשראי, אנא בצע את השלבים הבאים: 1.1

.CGRedirectאנא עדכן את איש המכירות של קרדיט גארד כי הינך מעוניין בחשבון טסט עבור 4.1.1

נציג התמיכה יעדכן אותך בפרטי הגישה לחשבון הטסט. 4.1.2

enterCreditCardDetails.jspץ אנא בקש מנציג האינטגרצייה של קרדיט גארד את הקוב 4.1.3

הבאים: קרא בעיון את הפרקים HTMLלפני שאתה מתחיל בשינוי ה 4.1.4

'תבניות ברירת מחדלפירוט –נספח א

'יצירת תבנית מותאמת אישית -נספח ב

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

'שימוש בשדות –נספח גuserData1-10

'פרמטרים דינאמיםשימוש ב –נספח ד

מגבלות אבטחת מידע -' ונספח

HTMLשנה את תצוגת ה 1.1

שאותו ערכת בשילוב )במידת הצורך( עם קבצי ה enterCreditCardDetails.jsp יש למסור את הקובץ 1.1

images, css, javascript לנציגיCreditGuard .להעלאה לשרת

בדוק את התצוגה ובצע שינויים במידת הצורך. 1.1

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

והקבצים לחשבון שהוכן עבורך בשרת הייצור.

הקבצים החדשים בחשבונך ייבדקו ע"י בודק אבטחת מידע מטעם קרדיט גארד ורק לאחר אישורו יהיה 1.1

ניתן להעלות את החשבון לפעולה בשרת הייצור.


פירוט תבניות ברירת מחדל -א' נספח

0פורמט .1

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



1פורמט .1

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


1פורמט .1

תשלומים וללא פרטי תשלומים. , פרטיתנאי העסקה, פס מגנטי


1פורמט .1

פרטי העסקה, מספר כרטיס, תוקף כרטיסתנאי העסקה,


יצירת תבנית מותאמת אישית -נספח ב'

הקדמה .1

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

כרטיס האשראי.

גם על כמו כן , PCI DSSשראי חלים מגבלות אבטחת מידע בהתאם לתקן על דף קליטת פרטי כרטיס הא 1.1

כל שינוי בדף לעמוד במגבלות אלו.

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

נספח זה מחולק לשני פרקים 1.1

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

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

התבנית.

מפרט על משתנים העומדים לרשותך על מנת למשוך/להציג את נתוני העסקה ועל מנת לתמוך –פרק שני 1.1

בריבוי שפות.

העוסק במגבלות אבטחת המידע. ספחנהאנא קרא בעיון גם את 1.1

שלב אחר שלב .1

enterCreditCardDetails.jsp -פתח את קובץ תבנית ברירת המחדל 1.1

לקובץ החדש את הקטעים הבאים: יש לשמר או להעתיק 1.1

תחילת הקובץ:מ HEADERSמקטע ה 1.1

כללי 2.3.1

<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8" errorPage="/error.jsp"%> <jsp:useBean id="transactionDetails" scope="request" type="com.creditguard.common.transactions.TransactionDetails" /> <%@ include file="/merchantPages/WebSources/includes/main.jsp" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="cache-control" content="no-cache"> <meta http-equiv="pragma" content="no-cache"> <meta http-equiv="expires" content="-1"> <script src="merchantPages/WebSources/js/<%=lang%>.js"></script> <script src="merchantPages/WebSources/js/main.js"></script> <link href="merchantPages/WebSources/css/main.rtl.css" rel="stylesheet" type="text/css" /> <%=engCSS%> <title><%=pageTitle%></title> </head> <body onload="resetForm();">


:והשדות שבו FORMאובייקט ה 2.3.2

<form id="creditForm" onsubmit="return formValidator(10);" method="POST" action="ProcessCreditCard"> <input type="hidden" name="txId" value="<%=mpiTxnId%>"/> <input type="hidden" name="lang" value="<%=lang%>"/> <input type="hidden" name="track2" value="" autocomplete="off" /> <input type="hidden" name="last4d" value="" autocomplete="off" /> <input type="hidden" name="cavv" value="" autocomplete="off" /> <input type="hidden" name="eci" value="" autocomplete="off" /> <input type="hidden" name="transactionCode" value="Phone" autocomplete="off" />

:FORMהעתק את כל שאר שדות אבייקט ה 2.3.3

כרטיס אשראי 2.3.4

<input type="text" id="cardNumber" name="cardNumber" maxlength="19" style="width: 160px;" autocomplete="off"/>

תוקף )שדה שנה( 2.3.5

<select id="expYear" name="expYear"><%=expYear%></select>

תוקף )שדה חודש( 2.3.6

<select id="expMonth" name="expMonth"> <option value="01">01</option> <option value="02">02</option> <option value="03">03</option> <option value="04">04</option> <option value="05">05</option> <option value="06">06</option> <option value="07">07</option> <option value="08">08</option> <option value="09">09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option>

</select>

CVVשדה ה 2.3.7

<input type="text" name="cvv" id="cvv" maxlength="4" style="width: 50px;" autocomplete="off"/>

שדה תעודת הזהות 2.3.8

<input type="text" id="personalId" name="personalId" maxlength="9" style="width: 160px;" autocomplete="off"/>

:שדות תשלומים 2.3.9

div id="divPayments" style="display:<%=showPayments%>"; >

מספר התשלומים

<div class="grid_12 rowPayments";> <div class="grid_4 rowPayments td_style_fieldPayments"><%=numberOfPaymentsLabel%></div> <div class="grid_3 rowPayments td_style_fieldValue"> <%=NumberOfPaymentvalue%> <select id="numberOfPayments" name="numberOfPayments" style="display:<%=showSelectNumberOfPayments%>" onchange=<%=onchangeNumberOfPayments%>> <%=NumberOfPaymentsOptions%> </select> </div> <div class="grid_12 row12 td_style_invalidField" style="width: 100%;" id="invalidNumberOfPayments"> </div> </div>

תשלום ראשון ושאר התשלומיםשדות


<div class="grid_12 rowPayments" style="display:<%=showFirstAndPeriodicalPayment%>"; > <div class="grid_4 rowPayments td_style_fieldPayments"><%=FirstPaymentLabel%></div> <div class="grid_2 rowPayments td_style_fieldValue"> <div id="firstPaymentDisp" class="data_style_payment" disabled="disabled" ><%=getFirstPayment()%></div> </div> <div class="responsive_page_line_break"></div> <div class="grid_4 rowPayments td_style_fieldPayments"><%=periodicalPaymentLabel%></div> <div class="grid_2 rowPayments td_style_fieldValue"> <div id="firstPaymentDisp" class="data_style_payment" disabled="disabled" ><%=getFirstPayment()%></div> </div> <div class="responsive_page_line_break"></div> <div class="grid_4 rowPayments td_style_fieldPayments"><%=periodicalPaymentLabel%></div> <div class="grid_2 rowPayments td_style_fieldValue"> <div id="periodicalPaymentDisp" class="data_style_payment" disabled="disabled" ><%=getPeriodicalPayment()%></div> </div>

</div>

שדה סכום הריבית

<div class="grid_12 rowPayments" style="display:<%=showPaymentsInterest%>"> <div class="responsive_page_line_break"></div> <div class="grid_4 rowPayments td_style_fieldPayments"><%=paymentsInterestLabel%></div> <div class="grid_2 rowPayments td_style_fieldValue"> <div id="paymentsInterestDisp" disabled="disabled" class="data_style_payment"><%=paymentsInterest%></div> </div> </div>

</div>

FORMכפתורי ה 2.3.10

<input type="submit" id="submitBtn" value="<%=formSend%>" /> <input id="resetBtn" type="reset" value="<%=formReset%>" />

hidden( שאין בהן צורך לתצוגה יוגדרו כ inputשדות ) 1.1

"autocomplete="offעבור property( יתווסף ה inputלכל שדה ) 1.1

עבור דפי התבנית המותאמת. UTF-8יש להשתמש בקידוד 1.1

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

<select id="expYear" name="expYear"> <%=expYear%> </select>

מחושבים בקוד ומוצגים בדף.שדות התשלומים ערכי 1.1

במאפיין noneמים, יש לאתחל את הערך שלומשדות הת יותרבמידה ומעוניינים שלא יופיע אחד או 4.7.1

style="display: של אותוdiv מעוניינים להורידאותו ש.

לשרת הבדיקותקוד להעלאה יצירת 1.1

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

עמוד ה-Redirect .יישמר בתיקיית העל של הלקוח


" קבצי התמונות ישמרו בתיקיית"images.

קבציjava script " ישמרו בתיקייתjs."

קבציcss ישמרו בתיקיית"css".

, CVV לצרף שדה אשר יאפשר ללקוח לבחור סיבה מדוע אינו הזין את שדה ה במידה ומעוניינים 1.4

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

: cvv_wneb ששמו Select שלך את אלמנט ה



התוצאה שתתקבל היא הוספת השדה להלן: 4.9.1

נוספים פרמטרים .1


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

שבהם יש להשתמש על מנת לממש את אפשרות ריבוי השפות.( CAPTIONS)משתני התרגום

מנת להציג את ערכי העסקה )למשל הערך הטבלה הבאה מתארת את הפרמטרים בהם ניתן להשתמש על 1.1

המספרי של הסכום הכולל של העסקה(

:HTMLלהצגת סכום העסקה בקוד amountדוגמא לשילוב במשתנה 1.1

<html> <body>

>%=amount%>

</body> </html>

תמיכה בריבוי שפות 1.1

, אשר מציגים (CAPTIONS)הכותרת על מנת לקבל תמיכה בריבוי שפות, יש להשתמש גם במשתני 3.4.1

לאותה הטראנזקציה ששודרה. langבהתאם לשפה שהוגדרה במשתנה לשדה את התרגום המתאים

תיאור משתנה )הצגת הערך(שם ה

double amount של העסקה סכום כולל

String customerEmail דוא"ל המשלם

String currency מטבע

String orderId מספר הזמנה

double firstPayment סכום תשלום ראשון

double periodicalPayment סכום שאר השתלומים

int numberOfPayments מספר תשלומים

String description תיאור

String lang ערכים אפשריים( שפה נבחרת- HE /EN)

String userData1 שדה טקסט חופשי










boolean isPayments שקר( \שדה בוליאני )אמת

boolean isFullPaymentDetails שקר( \שדה בוליאני )אמת

boolean isDetailedPayments שקר( \שדה בוליאני )אמת

Double paymentsInterest סכום הריבית

תיאור כותרת בעברית כותרת באנגלית משתנהשם ה


String paymentAmount Amount סכום כולל סכום לתשלום

String paymentCEmail Payer Email דוא"ל המשלם דוא"ל הרוכש

String paymentCurrency Currency מטבע מטבע חיוב

String paymentOrderId Order ID מספר הזמנה מספר הזמנה

String paymentFirstPayment First Payment סכום תשלום ראשון ראשון תשלום

String

paymentPeriodicalPayment

Periodical Payments סכום שאר השתלומים שאר התשלומים

String paymentNOPayments Total Payments מספר תשלומים מספר תשלומים

String paymentDesc Description תיאור תיאור נוסף

String CCNumber Card Number תרגום לתווית "כרטיס אשראי" ר כרטיסמספ

String CCExp Card Expiration תוקף תוקף כרטיס

String CCPId Owner ID תרגום לתווית "ת.ז רוכש" ת.ז בעל כרטיס

String formSend PAY תווית כפתור "שליחה" שליחה

String formReset RESET תווית כפתור "נקה" ניקוי

String pageTitle Secured Payment כותרת העמוד דף תשלום מאובטח

String pageDesc In this page you can pay for the order you placed on the

site. The payment process is fully secure and complies with the highest standards of data

protection. Please first confirm the details of the payment amount and the

installment details. Then, please insert your credit

card details as required below. Payment for the order will only be auctioned after you click on the 'Pay' button at the bottom on the screen.

עמוד זה הינו עמוד התשלום ה שביצעת באתר.עבור העסק

תשלום בעבור ההזמנה יבוצע רק לאחר בחירה בכפתור "אישור"

שבתחתית המסך.אנא אשר תחילה כי כל הפרטים

בדף זה נכונים והזן את פרטי כרטיס האשראי כנדרש.

. . . . עמוד זה הינותיאור לעמוד "."

String paymentDetails Secured Payments Details פרטי תווית כותרת לטבלה " טחתפרטי עסקה מאוב "עסקה מאובטחת

String CCDetails Credit Card Details הזנת פרטי כרטיס אשראי לתשלום

פרטי תווית כותרת לטבלה " "כרטיס אשראי

String

paymentPaymentsInterest

Amount of interest סכום ריבית עבור התשלומים סכום הריבית


userData1-10דות שימוש בש –נספח ג'

הקדמה .1

פשר ללקוח להכניס מטרת השדות הן לא לשימוש הלקוח.שדות הינם userData10עד userData1שדות 1.1

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

בצורה זו שדות .customerDataתחת תג txnSetupכבר בבקשה הראשונה של להישלח יםיכולהשדות 1.1

בשלב יצירת הטרנזקציה. CGRedirect-אלו ישלחו ל

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

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

ניתן להציג ולשנות את השדות בשלב פרטי הזנת כרטיס האשראי. 1.1

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

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

בפרטי העסקה אך לא יועברו לשב"א. CG Console-השדות יוצגו ב 1.1


שלב ראשון 1.1

customerData. השדות יופיעו תחת תג txnSetupים בשדות אלו בבקשת נשלח ערכבשלב זה 2.1.1

בבקשה.

לדוגמא, נשלח בקשה עם השדות הבאים: 2.1.2

אשר מכיל את שם המשתמש באתר של הלקוח. שדה זה יוצג בדף של הזנת פרטי userData1שדה 2.1.3

הכרטיס אך לא ניתן יהיה לשנות אותו.

של המשתמש. שדה זה יוצג בדף הזנת פרטי הכרטיס אשר מכיל את מספר הטלפון userData2שדה 2.1.4

אך ניתן יהיה לשנות אותו.

ישלח ריק וישמש להזנת כתובת המשלוח של המשתמש. userData3שדה 2.1.5

דוגמאת הבקשה: 2.1.6

<ashrait> <request> <version>1000</version> <language>EN</language> <dateTime/> <command>doDeal</command> <requestid/> <doDeal> <terminalNumber>096XXXXX</terminalNumber> <cardNo>CGMPI</cardNo> <total>10000</total> <transactionType>Debit</transactionType> <creditType>RegularCredit</creditType> <currency>ILS</currency> <transactionCode>Phone</transactionCode> <validation>TxnSetup</validation> <user>request identifier</user>


<eci></eci> <mid>123456</mid> <uniqueid>837683509-84983498539</uniqueid> <mpiValidation>AutoComm</mpiValidation> <description>added description to payment page</</description> <email>[email protected]</email> <customerData> <userData1>userName</userData1> <userData2>037370703</userData2> <userData3/> <userData4/> <userData5/> <userData6/> <userData7/> <userData8/> <userData9/> <userData10/> </customerData> </doDeal> </request> </ashrait>

שלב השני 1.1

(.JSP-נוסיף את השדות הללו לדף הזנת פרטי כרטיס האשראי )דף הבשלב זה 2.2.1

אך לא יהיה ניתן לשינוי יש להוסיף אתטיס האשראי על מנת שהשדה יוצג בדף הזנת פרטי כר 2.2.2

:JSP-השורה הבאה בקובץ ה

<%=userData1%>

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

:JSP-הבאה בקובץ ה

<input type="text" id="userData2" name="userData2" maxlength="256" style="width: 160px;" value="<%=userData2%>"/>

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

:JSP-השורה הבאה בקובץ ה

<input type="text" id="userData3" name="userData3" maxlength="256" style="width: 160px;" value=""/>

לדפי התשובה. חשוב לשלוח את שמות השדות בהתאם על מנת שיועברו לאחר מכן 2.2.5

חשוב לוודא שלא מוגדרים עוד שדות בשם זה בדף. אם יש שדות מוסתרים בשם זה יש למחוק את 2.2.6

השורה שלהם. לדוגמא שדה מוסתר:

<input type="hidden" name="userData1" value=""/>


השלבים הראשונים המתוארים למעלה מיושמים 2כאשר להלן דף דוגמא 2.2.7

"התמלא בערך של שדה שדה "שם משתמשuserData1 .ואינו ניתן לשינוי

שדה "מספר טלפון" התמלא בערך של שדהuserData2 .ניתן לשינוי

.שדה "כתובת למשלוח" הינו ריק וניתן למילוי על ידי המשתמש

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


ים דינאמייםשימוש בפרמטר –נספח ד'

הקדמה .1

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

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

להזנת פרטי דפים שונים אך עדיין להחזיק רק דף אחדשונים הינה להציג למשתמשים ההדגמהמטרת 1.1

יש צורך האתר, אך משתמשי ל ללהציג דף עם הלוגו של האתר לכ למשל יישום שבו יש צורך הכרטיס.

לוגו שונה. יוצג VIPשתמשי שלמ

. הסבר על פרמטרים אלו ואיך ניתן לשלב אותם בדף ניתן userData1-10הפרמטרים לשימוש דינאמי הם 1.1

.פח ג'נסלקרוא ב

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

כיוון שהדף כפוף למגבלות של אבטחת מידע )כפי שמתואר בנספח ו'( לא ניתן לשלוח בפרמטרים אלו 1.1

לנתיב בספרייה של הלקוח.. ניתן לשלוח רק שם של קובץ ולקשר אותו בדף URLנתיב של


ראשון לב ש 1.1

customerData. השדות יופיעו תחת תג txnSetup-יש לשלוח את הערכים הדינאמיים בבקשת ה 2.1.1

בבקשה.

שנישלב 1.1

יש לשנות את דף פרטי כך שיציג את הערך שנשלח בבקשה. 2.2.1

על מנת לשנות את הלוגו יש לערוך את שורת הלוגו: 2.2.2

<img src="merchantPages/ClientDir/images/<%=userData1%>"/>

.userData1בשורה הוכנס ספרייה של שם הלקוח ושם הקובץ נלקח ממשתנה בשם 2.2.3

נו יכול להכיל נתיב מלא של קובץ ממגבלות אבטחת מידע.הנתיב של הקובץ תמיד יהיה יחסי ואי

על מנת לשנות את צבע הרקע יש להוסיף את התג של צבע הרקע: 2.2.4

style="background: <%=userData2%>"

מתאר את צבע הרקע. userData2המשתנה 2.2.5

קובעים את תמונות הלוגו בדף ואת userData2-ו userData1בעליית הדף הוא יבנה כאשר המשתנים 2.2.6

הרקע שלו.

דוגמאות .1

:לוגו דינאמייישום ל אמגדו 1.1

המצביע על שם הקובץ: userData1עם המשתנה txnSetupשליחת בקשת 3.1.1

<ashrait> <request> <version>1000</version> <language>EN</language> <dateTime/>


<command>doDeal</command> <requestid/> <doDeal> <terminalNumber>096XXXXX</terminalNumber> <cardNo>CGMPI</cardNo> <total>10000</total> <transactionType>Debit</transactionType> <creditType>RegularCredit</creditType> <currency>ILS</currency> <transactionCode>Phone</transactionCode> <validation>TxnSetup</validation> <user>request identifier</user> <eci></eci> <mid>123456</mid> <uniqueid>837683509-84983498539</uniqueid> <mpiValidation>AutoComm</mpiValidation> <description>added description to payment page</</description> <email>[email protected]</email> <customerData> <userData1>myLogo.jpg</userData1> <userData2/> <userData3/> <userData4/> <userData5/> <userData6/> <userData7/> <userData8/> <userData9/> <userData10/> </customerData> </doDeal> </request> </ashrait>

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

<img src="merchantPages/ClientDir/images/<%=userData1%>"/>


הדף יראה כך: 3.1.3

:רקע דף דינאמידוגמא ל 1.1

המצביע על שם צבע הרקע: userData1עם המשתנה txnSetupשליחת בקשת 3.2.1

<ashrait>כ

<request> <version>1000</version> <language>EN</language> <dateTime/> <command>doDeal</command> <requestid/> <doDeal> <terminalNumber>096XXXXX</terminalNumber> <cardNo>CGMPI</cardNo> <total>10000</total> <transactionType>Debit</transactionType> <creditType>RegularCredit</creditType> <currency>ILS</currency> <transactionCode>Phone</transactionCode> <validation>TxnSetup</validation> <user>request identifier</user> <eci></eci> <mid>123456</mid> <uniqueid>837683509-84983498539</uniqueid> <mpiValidation>AutoComm</mpiValidation> <description>added description to payment page</</description>


<email>[email protected]</email> <customerData> <userData1>Silver</userData1> <userData2/> <userData3/> <userData4/> <userData5/> <userData6/> <userData7/> <userData8/> <userData9/> <userData10/> </customerData> </doDeal> </request> </ashrait>

:userData1שינוי תגי הרקע שיקבעו על ידי המשתנה 3.2.2

style="background: <%=userData1%>"

דף התוצאה יראה כך: 3.2.3


אבטחת מידע הנחיות –' הנספח

הנחיות אבטחת מידע ספציפיות .1

מטה. יש לעמוד בהגבלות אבטחת המידע המפורטות Redirect-במימוש דף ה 1.1

.PCIהנחיות אלה ממומשות כדי לעמוד בתקן 1.1

כל חריגה מהנחיות אלה דורשת אישור מפורש ובכתב מחברת קרדיט גארד. פרט לכך, לא תתאפשר כל 1.1

חריגה ועל כן יש לעקוב אחר הוראות אלה.

הוספת קוד דינאמי 1.1

קטעי הקוד בדף שסופק, לדוגמא ע"י הוספת jsp-ואין לשנות את קוד ה jspאין להוסיף קבצי 1.4.1

הבאים:

<%@ include file="xxx.jsp" %>

<% .... %>

<%= .... %>

לדף שסופקHTML FORM שינוי שדות 1.1

אין לשנות/להוסיף שדות קלט נוספים מעבר לקיימים בדף שסופק. 1.5.1

java scriptהוספת ספריות / קוד 1.1

מלבד עבור בדיקות תקינות קלט. java scriptאין להוסיף קוד 1.6.1

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

אשר יסופקו בנתיב הבא: jQueryקיימת אפשרות להשתמש בספריות 1.6.3

<script src="merchantPages/WebSources/js/jquery.js"></script>

שנוסף. java script-את כלל השימוש בקוד ה בטבלה )ראה בהמשך(יש לתעד 1.6.4

מחיקת תגיות 1.1

אין למחוק את התגיות הבאות: 1.7.1

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

<meta http-equiv="cache-control" content="no-cache">

<meta http-equiv="pragma" content="no-cache">

<meta http-equiv="expires" content="-1">

.HTML FORM-בקלטי ה "autocomplete="offנות את הפרמטר אין לש 1.7.2

לדוגמא:

<input type="hidden" name="track2" value="" autocomplete="off" />

<input type="text" id="cardNumber" name="cardNumber" maxlength="19" style="width: 160px;"

autocomplete="off"/>

שרת הבדיקותל יצירת קוד להעלאה 1.1

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


עמוד ה-Redirect .יישמר בתיקיית העל של הלקוח

" קבצי התמונות ישמרו בתיקיית"images.

קבציjava script " ישמרו בתיקייתjs."

קבציcss ישמרו בתיקיית"css".

צוע בדיקות קודיסופי בדיקות, לצורך בשמוש בנתוני כרטיסי אשראי ומ 1.4

כרטיסי אשראי לצורך בדיקות קוד.פרטי יתכן ופתוח מסויים ידרוש שימוש בחשבונות ו 1.9.1

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

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

.קרדיט גארד ייצור, אפשרי בתאום עםהבסביבת בדיקותמסופי שימוש ב 1.9.3

java scriptתיעוד שימושי 1.10

הערות java script-קוד ה תתיאור הפונקציונאליו

1

1

1

1

1

1

1

1


:loadingמנגנון – 'נספח ו

:הקדמה .1

, המנגנון הופך את דף התשלום ללא מאופשר התשובהמנגנון זה מופעל בזמן עיבוד העיסקה והמתנה לדף 1.1

צג לקונה על רקע אפור.ומומציג טקסט מתאים ש

:במנגנון שימוש .2

: loadingתצוגת ברירת מחדל של מנגנון 2.1

: loadingעיצוב מנגנון 1.1

ה של קרדיט גארד גם את , בקש מנציג האינטגרצייloadingבמידה ואתה מעונין לשנות את עיצוב מנגנון

.loading.ltr.css ,loading.rtl.cssהקבצים:

loading.ltr.css.או loadin.rtl.css –והתאם אותו לעיצוב שלך פתח את קובץ ברירת המחדל 2.2.2

הטקסט המוצג ללקוח, צריך לשנות את השורה הבאה:שינוי דוגמא לל 2.2.2.2

p.loading_msg_visible:after{ padding-right: 3em; /* 48px */ height: 3em; /* 48px */ margin-top: 32.5625em; /* 521px */ font-size: 1.25em; /* 18px */ font-weight: bold; line-height: 2.8125em; /* 45px */ color: #FF0000; opacity: 1.0; content:"מעבד בקשה, אנא המתן..."; }

. classes-ושמות ה css-להקפיד לשמור על מבנה היש 2.2.2.2


.enterCreditCardDetails.jspפתח את הקובץ 2.2.2

שבספריית הלקוח: css -ל css -נתיב הנה את ש 2.2.2

<link href="merchantPages/ResponsiveWebSources/css/loading.<%=loadingCSSLang%>.css" rel="stylesheet" type="text/css" />

-לשנות ל

<link href="merchantPages/ClientDir/css/loading.<%=loadingCSSLang%>.css" rel="stylesheet" type="text/css" />

Documents

CGRedirect · ךותמ דומע - סקפ - ןופלט לאומש תעבג ןוירוג ןב מ"עב דראג טידרק םייוניש תמישר ךרוע םידומע רואת ךיראת