| Operation | הפעולה שמערכת אישורית זהב צריכה לבצע.
שם לב לפעולות יצירת אסימון ועסקה מושהית יש פרמטרים אופציונליים נוספים. | 1. חיוב בלבד.
2. חיוב ויצירת אסימון.
3. יצירת אסימון בלבד.
4. עסקה מושהית. |
| TerminalNumber | המסוף שמבצע את הפעולה | 1000 |
| UserName | שם המשתמש לממשקים. | MyTestUser |
| SumToBill | הסכום לחיוב | 100.56 |
| CoinID | מטבע לחיוב | 1 : שקל
2 : דולר
אחרת מטבע קוד מטבע ISO לפי מאמר:
רשימת קודי מטבעות לחיוב
|
| Language | שפה להצגת דף הסליקה | he - עברית
en - אנגלית
ru - רוסית
ar - ערבית
שפות נוספות
|
| ProductName | שם המוצר שיוצג למשתמש , אורך מקסימלי של 50. במידה ומיצרים חשבונית אין צורך להעביר , פרטי החשבונית יוצגו במקום שדה זה | הזמנה מספר C101G |
| APILevel | גרסה של API . גרסה אחרונה : 10 | 10 |
| MaxNumOfPayments | מספר התשלומים המקסימלי שהמשתמש יכול לבחור
בנוסף יש הגדרות מדרגות תשלומים בתוך המסוף שקובעות יותר -> מדרגות תשלומים לאתר ( פרופיל נמוך)
| 12 |
| MinNumOfPayments | מספר התשלומים המינימלי שהמשתמש יכול לבחור | 3 |
| HideCreditCardUserId | האם להסתיר את הקליטה של ת.ז. הלקוח - משתמש כאשר מחייבים לקוחות חו"ל | false |
| SuccessRedirectUrl | הדף אילו יופנה מחזיק הכרטיס בסיום עסקה שהסתיימה בהצלחה.
ניתן גם להגדיר באופן קבוע בהגדרות מערכת.
* במידה ויש שימוש ב IFRAME יש לדאוג שהקישור יהיה בקידומת https ולא http * (חובה כתובת חיצונית , לא localhost )
| http://www.site.com/Success.html
|
| ErrorRedirectUrl | הדף אילו יופנה מחזיק הכרטיס בסיום עסקה שהסתיימה בכישלון.
ניתן גם להגדיר באופן קבוע בהגדרות מערכת.
* במידה ויש שימוש ב IFRAME יש לדאוג שהקישור יהיה בקידומת https ולא http * (חובה כתובת חיצונית , לא localhost ) | http://www.site.com/Error.html |
| IndicatorUrl | דף ניסתר(דף דיווח קבלת פרטי עסקה ) לקבלת פרטי העסקה. המערכת קורא לדף זה לפני שהלקוח מועבר לדף הצלחה / כישלון.
לאחר קבלת פרטי העסקה יש לפנות את שרת אישורית זהב לבדיקת הנתונים , ראה מאמר : טבלת פרמטרים : קבלת תשובה משרת הסליקה אישורית זהב .
1.כתובת לדיווח משרת לשרת על העסקה שבוצעה.
2.חובה לשימוש! (חובה כתובת חיצונית , ולא localhost ).
3.למה השימוש ? אין להסתמך על דף הצלחה , פתח לבאגים , מחזיק הכרטיס יכול לקבל POPUP ולצאת מהדף ואז השרת שלך לא ידע על ביצוע ההזמנה .
4. מומלץ להעביר מספר הזמנה ולקבל אותו חזרה בפרמטר ReturnValue לדוגמא .
5.אם שרת בית העסק לא מחזיר תשובת HTTP-200 בדיווח לכתובת זו .
השרת של קארדקום יפנה שוב ושוב לדיווח העסקה 7 פעמים:
[הטווח בדקות לדיווח שני והלאה: 1 דקה , 2 , 2 , 16 , 60 דק, 12 שעות , 12 שעות].
ראה מדריך ולוגים : דוח פעילות פרופיל נמוך | http://www.stie.com/hide.aspx |
| CancelUrl | במידה ומוצג לחצן "חזור" לאין יחזור הלקוח.
* במידה ויש שימוש ב IFRAME יש לדאוג שהקישור יהיה בקידומת https ולא http * | http://www.site.com/Cart.aspx |
| CancelType | סוג פעולה של לחצן חזור | 0 - לא להציג לחצן חזור
1 - מדמה לחצן חזור בדפדפן
2 - חוזר אל דף חזור שהועבר |
| SumInStars | סכום לחיוב כרטיס בכוכבים | 0 |
| HideCVV | האם להסתיר את שדה CVV , משתמש למסופים הוראת קבע שבהם אין חובה של CVV. | false |
| CreditType | שם לב!
- חברות האשראי מגבילות את מספר התשלומים למינימום 3. במקרה זה אנו מסדרים את מספר התשלומים למינימום 3 באופן אוטומטי.
- חברות האשראי מגבילות את הסכום המינימלי לחיוב עסקאות קרדיט. יש לדאוג להעביר סכום מתאים. במקרה זה הלקוח יועבר לדף כישלון.
- ישנם כרטיסי אשראי שלא יכולים לשלם בקרדיט. במקרה זה הלקוח יועבר לדף כישלון.
| 1 - חיוב רגיל
6 - קרדיט בתשלומים.
במידה ולא מעברים את הפרמטר אז מבוצע חיוב רגיל או תשלומים רגילים. |
ReturnValue
(מומלץ לשימוש)
| ערך להעביר למערכת הסליקה אשר יוחזר ל INDICATOR.
עד 250 תווים. ( נהוג להעביר מספר הזמנה ממערכת הזמנות באתר )
| AA-1234 |
| DefaultNumOfPayments | מספר התשלומים שיהיה בחורים מראש ללקוח. לדוגמה:
אם ניתן לשלם ב 12 תשלומים ניתן להעביר את הערך 10 ואז מספר התשלומים שיהיו בחור הוא 10.
מספרים בלבד. 1-32 | 10 |
| CardOwnerName | שם בעל הכרטיס
| אלי כהן
|
| HideCardOwnerName | האם לא להציג את השדה שם בעל הכרטיס.
מחרוזת | מחרוזת: true להסתיר
אחרת מציג. |
| SapakMutav | מספר לקוח בעבודה ברב מוטב | 1234 |
| RefundDeal | האם לבצע זיכוי לפרטי האשראי - פעיל בחיוב בלבד. | true |
| ShowCardOwnerPhone | האם להציג שדה טלפון בעל הכרטיס בפרטי האשראי | true |
| CardOwnerPhone | טלפון בעל הכרטיס
| 050-55445841
|
| ReqCardOwnerPhone | האם שדה טלפון בעל הכרטיס חובה | false |
| CardOwnerEmail | אימייל הלקוח (נכנס לפרטי עסקה , לא ניכנס לחשבונית ! )
| eli1980@gmail.com
|
| ShowCardOwnerEmail | האם להציג EMAIL בעל הכרטיס | true |
| |
|
|
| ReqCardOwnerEmail | האם Email בעל הכרטיס שדה חובה | true |
| ShowInvoiceHead | האם להציג ולאפשר ערכיה של פרטי החשבונית ללקוח. פעיל במידה ומפיקים חשבונית. פרטים להזנה לחשבונית .
| true |
| AutoRedirect | במצב טסטים , כאשר AutoRedirect=true במקום לקבל URL הדף יופנה לדף התשלום ישירות , עבודה ב GET [ מומלץ במצב טסטים בלבד]
| true |
| InvoiceHeadOperation | אפשריות נוספות במידה ומעבירים פרטי חשבונית.
0 - לא ליצור חשבוניות ולא להציג.
1 - צור חשבונית לפי פרטי החשבונית שהועברו. - ברירת מחדל אם מעבירים פרטי חשבונית.
2 - הצג פרטי חשבונית אבל לא לבצע יצירה של חשבונית! |
במידה ולא רוצים ליצור חשבונית אלה רק להציג את פרטי הרכישה יש העביר את הפרמטר הזה עם ערך 2.
שדה מחרוזת.
|
| IsVirtualTerminalMode | האם זה סליקה של בית העסקת ?
המערכת תתנהג כמו מסוף ווירטואלי לבית העסק ותציג שדות נוספים.
הדף יציג שדה נוסף של הזנת מספר אישור שבית העסק צריך להעביר.
במכשירי EMV יש להעביר את זה כ true בכדי שיוצא כפתור חייב בפינפד .
חובה לפנות לשרת - secure.cardcom.solutions
מנגנון ה-PINPAD עשוי להיכשל מול שרת וכתובות API ישנות | "true" |
| IsOpenSum | עובד רק במצב של IsVirtualTerminalMode=true הפרמטר יאפשר לסוחר לעדכן את הסכום בעת החיוב
| "true"
|
| ChargeOnSwipe | כאשר מעבירים פס מגנטי ( ערוץ 2 ) יבוצע ישר החיוב | TRUE = בפס מגנטי יבוצע ישר חיוב |
| DocTypeToCreate | לא חובה , ממולץ לא להעביר המערכת יודעת לבד איזה מסמך להפיק לפי ההגדרות שמוגדרות ברמת המסוף.
במידה והמתכנת רוצה לדרוס את הסוג מסמך ניתן לפי פרמטר זה .
| 1- חשבונית מס קבלה
3 - קבלה מלכ"ר
101 - אישור הזמנה מאתר
400 - קבלה רגילה (לחשבונית)
לרשימה המלאה:
א. אינדקס מאמרים ליצירת מסמכים - (חשבונית / קבלה למזומן , המחאות וכו) [הפקת מסמכים ב API]
|
| CSSUrl | כתובת URL של קוד CSS שהמערכת תוסף לדף התשלום. | https://www.site.co.il/mycss.css |
| IsAVSEnable | האם להציג שדות AVS למחזיק הכרטיס בדף תשלום .
נועד לאבטחת מסוף מוגברת
דרוש תמיכה מצג חברות האשראי בפיצר AVS
| עיר , כתובת
ו מיקוד בעל הכרטיס
|
קטגורייות 
