ממשק ישיר
ממשק ישיר נועד למערכות סגורות ומאובטחות / אפליקציות נייטיב סגורות שרוצות לחייב לקוחות ללא הפניה לדף סליקה בתקן 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