ממשק ישיר
ממשק ישיר נועד למערכות סגורות ומאובטחות / אפליקציות נייטיב סגורות שרוצות לחייב לקוחות ללא הפניה לדף סליקה בתקן PCI
( לא מתאים לאתרי WEB - לאתר WEB יש לעבוד עם פרופיל נמוך - http://kb.cardcom.co.il/article/AA-00402/0/ )
בעבודה מול ממשק ישיר אין אפשרות לקבל תקן PCI של קארדקום - יש להשיג עצמאית תקן PCI מחברת האשראי.
הערות ל Name to Value:
- חובה לבצע פנייה רק ב POST.
- חובה לבצע urlencode לכל הערכים המועברים למערכת.
- יש להוסיף את הפרמטר codepage=65001 , פרמטר זה אומר את סוג הקידוד המועבר למערכת יוניקוד במקרה זה.
- התשובה המתקבלת היא במבנה : ResponseCode=4&Description=NoPemition&LowProfileCode=601.
ממשק POST :
לאחר ההתחברות יש לשלוח את הנתונים במבנה הבא :
ParameterName=Value
לשרשור מספר פרמטרים יש להוסיף את הסימן
ParameterName=Value&ParameterName=Value
התשובה שמתקבלת גם בסגנון NAME TO VALUE:
ParameterName=Value&ParameterName=Value
* כאשר מייצרים אסימון יש לשמור את האסימון וגם את תוקף האשראי
טבלת פרמטרים :
| פרמטר | תיאור | ערכים אפשריים לדוגמה |
|---|
TerminalNumber
| מספר טרמינל לחיוב
| 1000
|
| UserName | שם משתמש | barak9611
|
| UserPassword | סיסמא - רק בזיכויים
| 124512c12
|
| Sum | סכום | 15
|
Languages
| שפה
| he / en
|
| Coinid / CoinISOName | מטבע | ערכי מטבע לפי הטבלה הבאה
|
| email | אימיל בעל הכרטיס
| eli@gmail.com |
| CardOwnerName | שם בעל הכרטיס
| אלי כהן
|
| Identitynumber | תעודת זהות בעל הכרטיס
| 123456789
|
| CardValidityMonth | תוקף חודש הכרטיס
| 12 |
| CardValidityYear | תוקף שנה הכרטיס
| 20
|
| CardNumber | מספר הכרטיס
| 4580000000000000
|
| Token | אסימון כרטיס לחיוב
| AA-BB-CC |
| CardChannel2 | ערוץ 2 Chanel - של פס מגנטי
| יש להעביר או את הפס המגנטי או את מספר הכרטיס |
| Cvv | 3 ספרות בגב הכרטיס | 123
|
| Jparameter | סוג בדיקת הכרטיס | 2=בדיקה או 5=אישור(מסגרת) |
| Approvalnumber | מספר אישור ( אופציונאלי ב J5 ) | 00214215 |
| NumOfPayments | מספר תשלומים
| 1
|
UniqAsmachta
| מזהה ייחודי של עסקה - רצוי
| יש להעבר את המזהה היחודי של העסקה במערכת שלך , אם נקבל שוב את אותו מזהה המערכת תחזיר - עסקה כפולה. ולא תחייב את העסקה .
מחרוזת של עד 25 תווים. |
| UniqAsmachtaReturnOriginal | האם להחזיר את התשובה המקורית בעת עסקה כפולה במקום שגיאה עסקה כפולה ? | |
| CreateToken | האם ליצור אסימון לכרטיס דך תוקף הכרטיס ? (מודל הוראת קבע) | false |
| TokenCompanyUserName | אופציונאלי - איזה חברה נמצא האסימון לחיוב (באסימון נודד) | |
| TokenCompanyPassword | אופציונאלי - איזה חברה נמצא האסימון לחיוב (באסימון נודד)
| |
| TokenSaveTime | אופציונלי -> כמה חודשים לשמור את הכרטיס ללא קשר לתוקף האסימון . | 3 |
| |
|
|
| Credittype | סוג העסקה המשודרת לחברת האשראי
| 1=רגיל 8=תשלומים בקרדיט
|
AvsCity
| עיר מחזיק הכרטיס
| AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.)
|
AvsAddress
| כתובת מחזיק הכרטיס
| AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.)
|
| AvsZip | מיקוד מחזיק הכרטיס | AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.) |
IsAutoRecurringPayment | חיוב הוראת קבע במסוף EMV בלבד יש להעביר את הפרמטר כ true (לא חובה) - העסקה תסומן כהוראת קבע ולא כחיוב רגיל. דרוש אישור מחברות האשראי להעברת פרמטר זה - במסוף הוראת קבע. (ב UPAY הכסף יתקבל אחרי ה 15 לחודש הבא)
דרוש אם רוצים לקבל קובץ מוחלפים מחברות האשראי.עדכון קובץ מוחלפים מחברת האשראי | true
|
פרמטרים לחשבונית (בממשק ישיר) :| InvCreateInvoice | האם ליצור חשבונית 1=כן 0=לא
| 1=ליצור חשבונית , 0= לא ליצור
|
| InvCusAddress1 | כתובת שורה 1
| אבן גבירול |
| InvCusAddress2 | כתובת שורה 2
| מס 120
|
| InvCusCity | עיר / מקום
| ת"א |
| InvCusID | קוד מטבע לחשבונית , חובה שיהיה תואם למטבע החיוב
| 1=שקל , 2=דולר
ראה : http://kb.cardcom.co.il/article/AA-00247 |
| invCustName | שם מקבל החשבונית | אלי כהן בע"מ
|
| invDestEmail | שם מייל הלקוח
| eli@gmail.com |
| InvItemDescription | תאור פריט/מוצר לחשבונית
| item1 |
| InvIsSendSMS | | |
InvItemQuantity |
כמות המוצר בשורה לחשבונית
|
1
|
| InvCustLinePH | טלפון נייד
| 050-8XXXXXX
|
| InvCustNumber | טלפון רגיל
| 03-5XXXXXXX |
| InvDepartmentId | קוד מחלקה לחשבונית
| קוד המחלקה במערכת קארדקום
https://secure.cardcom.solutions/Accounts/Tables/DepartmentsList.aspx |
| InvNoVat | האם החשבונית ללא מע"מ
| |
| InvComments | הערות לחשבונית
| עד 250 תויים
|
| InvSendInvoiceByMail | האם לשלוח חשבונית במייל
| |
| InvLanguages | שפת החשבונית
| he=עברית , en=אנגלית
|
| InvProductID | קוד מוצר לחשבונית
| מקט A1A2A3
|
פרטי התשובה המתקבלת
פרמטר
| תיאור | ערכים אפשריים לדוגמה |
|---|
| ResponseCode | קוד תיאור התשובה
| 0 - תקין
|
| InternalDealNumber | מספר עסקה פנימי ייחודי | 5643 |
| Description | תיאור התשובה המתקבלת | עסקה בוצעה בהצלחה |
| ApprovalNumber | מספר אישור של העסקה | |
InvoiceResponse.ResponseCode
| קוד תשובה ליצירת חשבונית | |
| InvoiceResponse.Description | תיאור תשובה | |
| InvoiceResponse.InvoiceNumber | מספר מסמך שנוצר | |
| InvoiceResponse.InvoiceType | סוג מסמך שנוצר | |
| Token | האסימון שנוצר לכרטיס | |
| Mutag_24 | מותג הכרטיס | |
| Sulac_25 | מספר חברה סולקת | |
| First_Payment_Sum_78 | תשלום ראשון | |
| Const_Patment_86 | תשלום קבוע | |
| IsEMV | האם עסקת EMV | |
| Uid | מזהה עסקה EMV מול חברות האשראי | |
| Rrn | מזהה עסקה EMV מול חברות האשראי | |
| BinId | מספר BinID של הכרטיס | |
| IsJ2ChackIsValid | האם בדיקה J2 תקינה. | |
ממשק Web Service
ניתן לבצע סליקה דרך Web Service כתובת הממשק : https://secure.cardcom.solutions/service.asmx
יש לפנות לפונקציה : PerfromBillVerySimple
טבלת פרמטרים :
| פרמטר | תיאור | ערכים אפשריים לדוגמה |
|---|
TerminalNumber | מספר מסוף מחייב
| 1000
|
UserName
| שם משתמש
| barak9611
|
| SumToBill | סכום לחיוב
| 15
|
| CardValidityMonth | חודש תוקף הכרטיס
| 12
|
| CardValidityYear | שנה תוקף הכרטיס
| 20
|
| CardNumber | מספר כרטיס
| 4580000000000000000
|
בנוסף מתקבלים גם תשובות של חברות האשראי - ראה טבלת פרמטרים : http://kb.cardcom.co.il/article/AA-00241/0
פרטי התשובה המתקבלת :
פרמטר
| תיאור | ערכים אפשריים לדוגמה |
|---|
| ResponseCode | קוד תיאור התשובה
| 0 - תקין
|
| InternalDeal | מספר עסקה פנימי ייחודי | 5643 |
| Description | תיאור התשובה המתקבלת | עסקה בוצעה בהצלחה
|
דוגמא:
Charging a credit card:
https://secure.cardcom.solutions/Interface/Direct2.aspx?TerminalNumber=1000&Sum=1&cardnumber=4580000000000000&cardvalidityyear=2019&cardvaliditymonth=12&identitynumber=0458000000&username=barak9611&Languages=en
Create a Token only, no charge: (Jparameter=2&CreateToken=true )
https://secure.cardcom.solutions/Interface/Direct2.aspx?TerminalNumber=1000&Sum=1&cardnumber=4580000000000000&cardvalidityyear=2019&cardvaliditymonth=12&identitynumber=0458000000&username=barak9611&Languages=en&Jparameter=2&CreateToken=true
Charging a Token (change cardnumber to Token)
https://secure.cardcom.solutions/Interface/Direct2.aspx?TerminalNumber=1000&Sum=1&Token=4cf8e168-261e-4613-8d20-000332986b24&cardvalidityyear=2019&cardvaliditymonth=12&identitynumber=0458000000&&username=barak9611&Languages=en
קטגורייות 