ממשק ישיר (לאפליקציות ותוכנות סגורות)
פיתוח חדש למתכנת - יש לעבוד עם ממשק JSON חדש
מדריך על הפונקציה - חיוב פרטי אשראי בממשק ישיר. (Do Transaction)
הפונקציה בסוואגר - Do Transaction
מודול ממשק ישיר נועד למערכות סגורות ומאובטחות או אפליקציות IOS / Android נייטיב סגורות.
כשהחיוב מתבצע ללא הפניה לדף סליקה של קארדקום בתקן PCI.
המודול אינו מתאים לאתרי WEB, לעבודה עם אתרי WEB יש לעבוד במקום עם מודול ''פרופיל נמוך''.
ראו מדריך - > ממשק פרופיל נמוך - חיוב,יצירת אסימון וכו [שלב 1 + 2]
חשוב: בעבודה מול ממשק ישיר אין אפשרות לקבל תקן PCI של קארדקום - יש להשיג עצמאית תקן PCI ולהגיש אותו לקארדקום . שים לב ! אין לשמור את פרטי האשראי , רק להעבירם בממשק , אין לשמור CVV גם אם אתה מגיש תעודה שאתה עומד בתקן.
בממשק ישר, בWEB חייב תקן PCI, בלי זה העסק חשוף לפריצות ולהונאות.
באפליקציות, תקן PIC פחות חשוב, כי פריצה לאפליקציה לא מהווה פריצה לפרטים של כל שאר הלקוחות.
--------------------------------------------------------------------------------------------------------------------
ממשק ל Name to Value:
1. חובה לבצע פנייה רק ב - POST שיותר מאובטח , פניה ב GET נועד לטסטים .
2. חובה לבצע urlencode לכל הערכים המועברים למערכת.
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
כתובת הפונקציה ב - Name to Value היא: https://secure.cardcom.solutions/Interface/Direct2.aspx
טבלת פרמטרים לבקשה:
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | TerminalNumber | 1000 | מספר טרמינל פנימי (מסוף) לחיוב - לא מספר שבא. |
| 2 | UserName | FDS32423$@324E | משתמש ממשקים API |
| 3 | UserPassword | 124512c12 | סיסמת ממשקים - דרוש בזיכויים |
| 4 | Sum | 15 | סכום |
| 5 | Languages | he/en | שפה |
| 6 | Coinid/CoinISOName | ערכי מטבע לפי הטבלה הבאה |
מטבע דוגמא- Coinid=1 CoinISOName=ILS |
| 7 | eli@gmail.com | אימייל בעל הכרטיס | |
| 8 | CardOwnerName | אלי כהן | שם בעל הכרטיס |
| 9 | Identitynumber | 123456789 | תעודת זהות בעל הכרטיס |
| 10 | CardValidityMonth | 12 | תוקף חודש הכרטיס, יש לשמור ב DB אם רוצים לחייב באסימון לאחר מכן |
| 11 | CardValidityYear | 20 | תוקף שנה הכרטיס, יש לשמור ב DB אם רוצים לחייב באסימון לאחר מכן |
| 12 | CardNumber | 4580280000000008 | מספר הכרטיס בדיקות , עד 5 אלף הצלחה מעל כישלון |
| 13 | codepage | 65001 | סוג הקידוד המועבר למערכת יוניקוד |
| 14 | Token | AA-BB-CC |
אסימון לחיוב הכרטיס יש לשמור ב DB אם רוצים לחייב באסימון לאחר מכן |
| 15 | UniqAsmachta | מזהה ייחודי של עסקה - רצוי auto num מחרוזת של עד 25 תווים. AABB12347 |
יש להעביר את המזהה הייחודי של העסקה במערכת שלך, אם נקבל שוב את אותו מזהה המערכת תחזיר - עסקה כפולה. ולא תחייב את העסקה. (UniqAsmachta הוא ב רמת מסוף) |
| 16 | CardChannel2 | יש להעביר או את הפס המגנטי או את מספר הכרטיס | ערוץ 2 Channel - של פס מגנטי |
| 17 | Cvv | 123 | 3 ספרות בגב הכרטיס |
| 18 | Jparameter | 2=בדיקה או 5=תפיסת מסגרת (מסגרת) | סוג בדיקת הכרטיס |
| 19 | Approvalnumber | 00214215 | מספר אישור (אופציונאלי בJ5) |
| 20 | Mti | 420 (ערך קבוע) | פרמטר לשיחרור מסגרת אשראי (דרוש להעביר גם מספר אישור בנוסף) |
| 21 | NumOfPayments | 1 | מספר תשלומים (תשלומים שווים) |
| 22 | firstpaymentsum | 200 | תשלום ראשון (ניתן להגדיר תשלום ראשון שונה משאר התשלומים) (אופציונלי) |
| 23 | constpayment | 50 | תשלום קבוע (שני והלאה) (אופציונלי) |
| 24 | UniqAsmachtaReturnOriginal | false | האם להחזיר את התשובה המקורית בעת עסקה כפולה במקום שגיאה עסקה כפולה? |
| 25 | CreateToken | false | האם ליצור אסימון לכרטיס דרך מספר הכרטיס ? (מודל הוראת קבע \ אסימונים) |
| 26 | TokenCompanyUserName | אופציונלי - איזו חברה נמצא האסימון לחיוב (באסימון נודד) | |
| 27 | TokenCompanyPassword | אופציונלי - איזו חברה נמצא האסימון לחיוב (באסימון נודד) | |
| 28 | TokenSaveTime | 3 | אופציונלי - כמה חודשים לשמור את הכרטיס ללא קשר לתוקף האסימון |
| 29 | Credittype |
1=רגיל, 8=תשלומים בקרדיט=6 |
סוג העסקה המשודרת לחברת האשראי |
| 30 | AvsCity | AVS - פעיל רק במסופי EMV | עיר מחזיק הכרטיס |
| 31 | AvsAddress | AVS - פעיל רק במסופי EMV | כתובת מחזיק הכרטיס |
| 32 | AvsZip | AVS - פעיל רק במסופי EMV | מיקוד מחזיק הכרטיס |
| 33 | IsAutoRecurringPayment | true |
יש להעביר פרמטר זה כ true רק כאשר המסוף מוגדר מסוף הוראת קבע בחברת האשראי ו ש.ב.א. אם המסוף מוגדר טלפוני/ רגיל ללא CVV
אין הגבלה בסוג הכרטיס בשימוש בהוראת קבע , המערכת מזהה את סוג הכרטיס ופועלת בהתאם.( כרטיס דואר , חיוב מיידי וכו) |
| 34 | SapakMutav | מסוף צריך להיות מוגדר בקארדקום - רב מוטב. מספר לקוח בעבודה ברב מוטב - דרוש אישור מחברת האשראי |
|
| 35 | deferMonths |
1 - חודש קדימה (שותף 30) |
מספר חודשי דחיית העסקה , שותף 30 + 60 וכו |
| 36 | CardInfo |
0 - רגיל ישראלי |
סוג הכרטיס |
| 37 | dealtype | 1 - עסקת חובה 51 - (לא בשימוש פרמטר ישן )! (הופך ל 53 בצד שרת) 52 - עסקת ביטול 53 - עסקת זכות |
סוג העסקה |
רשימת פרמטרים להפקת מסמכים חשבונאיים - ממשק חדש
רשימת פרמטרים להפקת מסמכים חשבונאיים - ממשק ישן
פרטי התשובה המתקבלת:
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | ResponseCode |
0 - תקין |
קוד תיאור תשובה |
| 2 |
InternalDealNumber |
5643 | מספר עסקה פנימי ייחודי |
| 3 | Description |
עסקה בוצעה בהצלחה |
תיאור התשובה המתקבלת |
| 4 | ApprovalNumber | מספר אישור של העסקה | |
| 5 |
InvoiceResponse.ResponseCode |
קוד תשובה ליצירת חשבונית | |
| 6 | InvoiceResponse.Description | תיאור תשובה | |
| 7 | InvoiceResponse.InvoiceNumber | מספר מסמך שנוצר | |
| 8 | InvoiceResponse.InvoiceType | סוג מסמך שנוצר | |
| 9 | Token | האסימון שנוצר לכרטיס | |
| 10 | Mutag_24 | מותג הכרטיס | |
| 11 | Sulac_25 | מספר חברה סולקת | |
| 12 | First_Payment_Sum_78 | תשלום ראשון | |
| 13 | Const_Patment_86 | תשלום קבוע | |
| 14 | IsEMV | האם עסקת EMV | |
| 15 | Uid | מזהה עסקה EMV מול חברות האשראי | |
| 16 | Rrn | מזהה עסקה EMV מול חברות האשראי | |
| 17 | BinId | מספר BinID של הכרטיס | |
| 18 | IsJ2ChackIsValid | האם בדיקה J2 תקינה. | |
| 19 | Tokef_30 | תוקף כרטיס | |
| 20 | CardNumStart | תחילת הכרטיס | |
| 21 | CardNumEnd | סיומת כרטיס |
ממשק Web Service:
ניתן לבצע סליקה דרך Web Service - כתובת הממשק: https://secure.cardcom.co.il/service.asmx
יש לפנות לפונקציה: PerfromBillVerySimple
טבלת פרמטרים:
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | TerminalNumber | 1000 | מספר מסוף מחייב |
| 2 | UserName | barak9611 | שם משתמש |
| 3 | SumToBill | 15 | סכום לחיוב |
| 4 | CardValidityMonth | 12 | חודש תוקף הכרטיס |
| 5 | CardValidityYear | 26 | שנה תוקף הכרטיס |
| 6 | CardNumber | 4580000000000000000 | מספר כרטיס |
בנוסף - מתקבלות גם תשובות של חברות האשראי, ניתן לראות - טבלת פרמטרים
פרטי התשובה המתקבלת:
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | ResponseCode | 0 - תקין | קוד תיאור תשובה |
| 2 | InternalDeal | 5643 | מספר עסקה פנימי ייחודי |
| 3 | Description |
עסקה בוצעה בהצלחה |
תיאור התשובה המתקבלת |
ניתן להוריד קוד לדוגמה ↓
למתכנתים ש לא רוצים לעבוד עם אסימונים , ורוצים לייצר עסקה מושהית דרך ממשק ישיר ולחייב אותה בממשק של קארדקום , ניתן להשתמש ב קוד לדוגמא SuspendedDealDeposit שמצורף למטה. (עדיף אסימונים לצורך הגמישות).
יש ליצור קשר עם התמיכה לקבלת שם משתמש לבדיקות.