חיוב/ זיכוי אסימון (דרוש מודול אסימונים) - [שלב 3]
פיתוח חדש למתכנת - יש לעבוד עם ממשק JSON חדש
Do Transaction Operation
פעולות חיוב / זיכוי אסימון
מערכת הסליקה תומכת בשתי סוגי ממשקים, Name To Value, ו-Web Service.
לחיוב אסימון חייב להיות מסוף ללא חובה ל-CVV בחברות האשראי,
מסוף בתצורה כזו לא בודק תוקף העיקר שיהיה עתידי, לא בודק CVV, ובדיקת תעודת הזהות היא אופציונלית תלוי בהסכם מול חברת האשראי.
ממשק API 10 Web Service
כתובת ה Web Service היא: https://secure.cardcom.solutions/Interface/BillGoldService.asmx
הפונקציה שיש להשתמש לשם העברת פרטי העסקה לחיוב בלבד היא: LowProfileChargeToken
ראה בהמשך טבלאות פרמטרים להעברה וקבלת תשובה.
ממשק (נפוץ יותר) Name to Value
חובה לבצע פנייה רק ב POST.
חובה לבצע urlencode לכל הערכים המועברים למערכת.
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
טבלת פרמטרים להעברה לחיוב אסימון
כתובת ה-Name To Value היא: https://secure.cardcom.solutions/interface/ChargeToken.aspx
מספר | פרמטר | ערכים אפשריים לדוגמא | תיאור |
1 | TerminalNumber | 1000 | המסוף הפנימי (לא שבא) שמבצע את הפעולה. |
2 | UserName | TestUser | שם משתמש |
3 | CodePage | 65001 | פרמטר זה אומר את סוג הקידוד המועבר למערכת. |
4 | TokenToCharge.Token | AA-BB-CC | האסימון לחיוב |
5 | TokenToCharge.CardValidityMonth | 03 | תוקף כרטיס חודש MM |
6 | TokenToCharge.CardValidityYear | 21 | תוקף כרטיס שנה YY. |
7 | TokenToCharge.SumToBill | 4500.50 | סכום לחיוב |
8 | TokenToCharge.ApprovalNumber | 014591 | 1.במידה והמסוף חייב ב CVV לא ניתן לחייב אסימון עסקה ללא העברת פרמטר זה. |
9 | TokenToCharge.IdentityNumber | 040617644 | ת.ז. בעל הכרטיס |
10 | TokenToCharge.CoinID | 1 - שקל | מטבע לחיוב |
11 | TokenToCharge.APILevel | 10 | גרסה של API. גרסה אחרונה: 10 |
12 | TokenToCharge.DocTypeToCreate | 1- חשבונית מס קבלה | סוג מסמך להפקה , במידה ולא מועבר זה הולך לברירת מחדל של המסוף |
13 | TokenToCharge.SumInStars |
| סכום לחיוב בכוכבים |
14 | TokenToCharge.NumOfPayments | 5 | מספר תשלומים לחיוב האסימון - אם רוצים לפצל. |
15 | TokenToCharge.RefundInsteadOfCharge | False - חיוב אסימון | האם לבצע זיכוי לאסימון במקום חיוב. TokenToCharge.MTI בהמשך הטבלה ). בזיכוי דרוש להעביר גם הפרמטר *בזיכוי אין צורך הפרמטר TokenToCharge.ApprovalNumber |
16 | TokenToCharge.UserPassword | aSD34SDF-1asd | במידה ומבצעים זיכויים עם אסימון יש להעביר את סיסמת API לזיכויים של אותו משתמש |
17 | TokenToCharge.CardOwnerName |
| שם בעל הכרטיס להצגה בדוחות |
18 | TokenToCharge.CardOwnerPhone |
| טלפון בעל הכרטיס |
19 | TokenToCharge.CardOwnerEmail |
| אימייל הלקוח (נכנס לפרטי עסקה , |
20 | TokenToCharge.SapakMutav | 1234 | מספר לקוח בעבודה ברב מוטב. |
21 | TokenToCharge.TokenCompanyUserName |
| אופציונאלי - איזה חברה נמצא האסימון לחיוב. |
22 | TokenToCharge.TokenCompanyPassword |
| אופציונאלי - איזה חברה נמצא האסימון לחיוב. |
23 | TokenToCharge.FirstPaymentSumAgorot |
| אופציונאלי - סכום תשלום ראשון בתשלומים לב! הסכומים הם באגורות - ראה הערה בסוף הטבלה |
24 | TokenToCharge.ConstPaymentAgorot |
| אופציונאלי - סכום שאר התשלומים לב! הסכומים הם באגורות - ראה הערה בסוף הטבלה |
25 | TokenToCharge.MTI | 420 (ערך קבוע) | פרמטר לשחרור מסגרת אשראי |
26 | TokenToCharge.JParameter | תפיסת מסגרת - 5 | אסימון שקיים במערכת ורוצים שוב לבצע תפיסת מסגרת |
27 | TokenToCharge.UniqAsmachta | יש להעביר את המזהה הייחודי של העסקה במערכת שלך , אם נקבל שוב את אותו מזהה המערכת תחזיר - עסקה כפולה. ולא תחייב את העסקה . סוג - מחרוזת של עד 25 תווים. | מזהה ייחודי של עסקה - רצוי ל בדיקת עסקאות כפולות. (ברמת מסוף ).
|
28 | TokenToCharge.UniqAsmachtaReturnOriginal | false | האם להחזיר את התשובה המקורית בעת עסקה כפולה במקום שגיאה עסקה כפולה? |
29 | TokenToCharge.IsAutoRecurringPayment | true | יש להעביר פרמטר זה כ true רק כאשר המסוף מוגדר מסוף הוראת קבע בחברת האשראי ו ש.ב.א. אם המסוף מוגדר טלפוני/ רגיל ללא CVV אין הגבלה בסוג הכרטיס בשימוש בהוראת קבע , המערכת מזהה את סוג הכרטיס ופועלת בהתאם.( כרטיס דואר , חיוב מיידי וכו) |
30 | TokenToCharge.AvsCity | AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.) | עיר מחזיק הכרטיס |
31 | TokenToCharge.AvsAddress | AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.) | כתובת מחזיק הכרטיס |
32 | TokenToCharge.AvsZip | AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.) | מיקוד מחזיק הכרטיס |
בחיוב עם מסמך חשבונאי יש להעביר בנוסף פרמטרים ליצירת חשבונית לפי מדריך זה : טבלת פרמטרים: יצירת מסמך (חשבונית / קבלה וכו') לעסקת אשראי. (לעסקת פ.נמוך ראשונית או חיוב אסימון)
-הערה: לתשלום ראשון תשלום קבוע, יש לבצע את הבדיקה הבאה
סכום לחיוב=שווה ל=תשלום ראשון+ תשלום קבוע*(מספר התשלומים)
טבלת פרמטרים התשובה המתקבלת:
מספר | פרמטר | ערכים אפשריים לדוגמא | תיאור |
1 | ResponseCode | 0 - תקין , אחר שגוי | קוד תשובה המקבל |
2 | Description | תקין | תיאור התשובה , במידה ומתקבל שונה מ-0 יש לבצע רישום והתראה למנהל המערכת |
3 | ApprovalNumber | 0014215 | מספר אישור שהתקבל מחברות האשראי |
4 | InternalDealNumber | 1234567 | קוד ייחודי של עסקה במערכת אישורית זהב - יש לשמור קוד זה לביצוע בירורים עתידיים גודל השדה הוא BIGINT (אורך של 64 ביטים) |
5 | InvoiceResponse.ResponseCode | 0 | קוד תשובה של יצירת חשבוניות, ישנו מצב שהחיוב תקין אבל ישנה בעיה עם החשבונית. מערכת אישורית זהב נותנת עדיפות לחיוב. |
6 | InvoiceResponse.Description | תקין | תיאור תשובה של יצירת חשבונית |
7 | InvoiceResponse.InvoiceNumber | 332 | מספר חשבונית, יש לשמור גם את סוג החשבונית לשם זיהוי |
8 | InvoiceResponse.InvoiceType | 1 - חשבונית מס קבלה | סוג חשבוניות , יש לשמור את סוג החשבונית ביחד עם מספר החשבונית לזיהוי |
9 | InvoiceResponse.AccountID | 1001 | מספר לקוח במערכת רק אם נוצר או בוצע איחוד לכרטיס לקוח. |
10 | Token | AA-BB-CC | אסימון הכרטיס |
11 | Mutag_24 | 0 - כרטיס פרטי של חברה מנפיקה | מותג הכרטיס |
12 | Sulac_25 | קודים של חברה סולקת בהתאם למאמר :תיאור קודים חברות האשראי | חברה סולקת |
13 | First_Payment_Sum_78 | 10.00 | סכום תשלום ראשון |
14 | Const_Patment_86 | 15.00 | סכום תשלום קבוע |
15 | IsEMV | true\false | האם עסקת EMV |
16 | Uid | 1005412 | מזהה מספר מכשיר |
17 | Rrn | קוד מותג הכרטיס | מזהה מנפיק |
18 | Tokef_30 | 1229 | תוקף הכרטיס |
19 | CardNumStart | 4580 | 4 ספרות ראשונות |
20 | CardNumEnd | 0000 | 4 ספרות אחרונות |
21 | CardTypeCode_60 | קודים של חברה סולקת בהתאם למאמר :תיאור קודים חברות האשראי | קוד חברת האשראי המנפיקה |
22 | CardName104 |
| שם הכרטיס |
23 | ClubCode68 |
| מספר מזהה מועדון |
24 | CouponNumber | 120112011 | מספר שובר - מחרוזת |
מצורף קוד לדוגמא (בתחתית המדריך)
יש ליצור קשר עם התמיכה לקבלת שם משתמש לבדיקות.
הערה בנושא שמירת פרטי אשראי:
בעת חיוב כרטיס אשראי אנו יוצרים טוקן (אסימון) ושומרים אותו לשימוש התוכנה (למידה ובית עסק ירצה לזכות את העסקה בעתיד).
חברת קארדקום שומרת את האסימון לתקופה מסויימת ע"פ הסעיפים הבאים:
אם יש לבית העסק מודול (מוצר) אסימונים / הוראות קבע, אנו שומרים את האסימון עד סיום תוקף הכרטיס
אם לבית העסק אין מודול הו"ק / אסימונים אנו שומרים את האסימון ל 6 חודשים בלבד לצורכי זיכויים עתידיים (משמע שעסקה רגילה אפשר לזכות רק עד 6 חודשים ממועד ביצוע העסקה)