סייר
 
אפשריות
Rss קטגורייות

ממשק ישיר

מספר מאמר: AA-00477 צפיות: 5398 נוצר: 08/06/2017 10:31 עדכון אחרון: 27/02/2020 10:10 0 דירוג/ מצביע


ממשק ישיר

ממשק ישיר נועד למערכות סגורות ומאובטחות / אפליקציות נייטיב סגורות שרוצות לחייב לקוחות ללא הפניה לדף סליקה בתקן PCI 
( לא מתאים לאתרי  WEB  - לאתר WEB יש לעבוד עם פרופיל נמוך -
http://kb.cardcom.co.il/article/AA-00402/0/  )

 בעבודה מול ממשק ישיר אין אפשרות לקבל תקן PCI של קארדקום  - יש להשיג עצמאית תקן PCI מחברת האשראי.


הערות ל Name to Value:

  1. חובה לבצע פנייה רק ב POST.
  2. חובה לבצע urlencode לכל הערכים המועברים למערכת.
  3. יש להוסיף את הפרמטר codepage=65001  , פרמטר זה אומר את סוג הקידוד המועבר למערכת יוניקוד במקרה זה.
  4. התשובה המתקבלת היא במבנה : ResponseCode=4&Description=NoPemition&LowProfileCode=601.


ממשק POST :

כתובת Name to Value היא :   https://secure.cardcom.solutions/Interface/Direct2.aspx


לאחר ההתחברות יש לשלוח את הנתונים במבנה הבא :

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 - של פס מגנטי
 יש להעביר או את הפס המגנטי או את מספר הכרטיס
 Cvv3 ספרות בגב הכרטיס 123
Jparameterסוג בדיקת הכרטיס2=בדיקה או 5=אישור(מסגרת) 
Approvalnumberמספר אישור ( אופציונאלי ב J5 )00214215
NumOfPaymentsמספר תשלומים
1


UniqAsmachta
מזהה ייחודי של עסקה - רצוי
יש להעבר את המזהה היחודי של העסקה במערכת שלך , אם נקבל שוב את אותו מזהה המערכת תחזיר - עסקה כפולה. ולא תחייב את העסקה .
מחרוזת של עד 25 תווים.
UniqAsmachtaReturnOriginal
האם להחזיר את התשובה המקורית בעת עסקה כפולה במקום שגיאה עסקה כפולה ?

 false


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