| |
| |
ממשק ישיר
| מספר מאמר: AA-00477 צפיות: 4757 נוצר: 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:
- חובה לבצע פנייה רק ב 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
|
|
קטגורייות