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

ממשק ישיר עותק

מספר מאמר: AA-00507 צפיות: 78 נוצר: 11/06/2020 17:13 עדכון אחרון: 11/06/2020 17:13 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

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

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

הערות
  • אין הערות למאמר זה.
תמיכה 03-9436100
כל הזכויות שמורות לחברת קארדקום בע"מ