ממשק ישיר
ממשק ישיר נועד למערכות סגורות ומאובטחות שרוצות לחייב לקוחות ללא הפניה לדף סליקה בתקן 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 | מטבע | ערכי מטבע לפי הטבלה הבאה
|
| 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 |
dealtype
| סוג עסקה חיוב / זיכוי
| 1=חובה או 51=זכות (בררת מחדל 1 מוזן כבר)
|
AvsCity
| עיר מחזיק הכרטיס
| AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.)
|
AvsAddress
| כתובת מחזיק הכרטיס
| AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.)
|
| AvsZip | מיקוד מחזיק הכרטיס | AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.) |
IsAutoRecurringPayment | חיוב הוראת קבע במסוף EMV בלבד יש להעביר את הפרמטר כ true (לא חובה) - העסקה תסומן כהוראת קבע ולא כחיוב רגיל. דרוש אישור מחברות האשראי להעברת פרמטר זה - במסוף הוראת קבע. (ב UPAY הכסף יתקבל אחרי ה 15 לחודש הבא)
דרוש אם רוצים לקבל קובץ מוחלפים מחברות האשראי.עדכון קובץ מוחלפים מחברת האשראי | true
|
פרטי התשובה המתקבלת
פרמטר
| תיאור | ערכים אפשריים לדוגמה |
|---|
| 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
ללקוחות שעובדים עם ממשק ישיר אנו לא יכולים לספק להם תקן PCI - עליהם להשיג לבד תקן זה מחברת האשראי .
קטגורייות 