חיוב/ זיכוי אסימון (דרוש מודול אסימונים) - [שלב 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 | המסוף הפנימי (לא שבא) שמבצע את הפעולה. (יש לבדוק אם יש לבית העסק מסוף נוסף לחיוב האסימון - מסוף ללא CVV) |
| 2 | UserName | TestUser | שם משתמש |
| 3 | CodePage | 65001 | פרמטר זה אומר את סוג הקידוד המועבר למערכת. |
| 4 | TokenToCharge.Token | AA-BB-CC | האסימון לחיוב |
| 5 | TokenToCharge.CardValidityMonth | 03 | תוקף כרטיס חודש MM |
| 6 | TokenToCharge.CardValidityYear | 21 | תוקף כרטיס שנה YY. (בשימוש אסימון אם התוקף עומד להיגמר ב 3 חודשים האחרונים המערכת תבצע הארכה של התוקף אוטומטי לחצי שנה קדימה) |
| 7 | TokenToCharge.SumToBill | 4500.50 | סכום לחיוב |
| 8 | TokenToCharge.ApprovalNumber | 014591 | 1.במידה והמסוף חייב ב CVV לא ניתן לחייב אסימון עסקה ללא העברת פרמטר זה. 2. מספר האישור אשר התקבל בעת ביצוע J5 לכרטיס יש להשתמש במספר אישור רק פעם אחת.(מנצל את התפיסת מסגרת - במסופי EMV נשלח המספר עסקה של קארדקום בעסקת J5 כ מספר האישור) 3.במידה והמסוף לא חייב ב CVV אין צורך להעביר פרמטר זה (מתאים להוראות קבע מתחדשות). 4. לקוחות שסולקים עם מאגד UPAY - אין להעביר פרמטר זה. |
| 9 | TokenToCharge.IdentityNumber | 040617644 | ת.ז. בעל הכרטיס לא חובה להעביר אם אין דרישה לבדיקה של ת.ז |
| 10 | TokenToCharge.CoinID | 1 - שקל 2 - דולר אחרת :רשימת קודי מטבעות לחיוב |
מטבע לחיוב |
| 11 | TokenToCharge.APILevel | 10 | גרסה של API. גרסה אחרונה: 10 (אם לא יועבר יתקבל קצת פרמטרים בתשובה , יש להעביר בכדי לקבל סולק מותג ועוד פרמטרים) |
| 12 | TokenToCharge.DocTypeToCreate | 1- חשבונית מס קבלה 3 - קבלה מלכ"ר 101 - אישור הזמנה מאתר 400 - קבלה רגילה (לחשבונית) |
סוג מסמך להפקה , במידה ולא מועבר זה הולך לברירת מחדל של המסוף |
| 13 | TokenToCharge.SumInStars | סכום לחיוב בכוכבים | |
| 14 | TokenToCharge.NumOfPayments | 5 | מספר תשלומים לחיוב האסימון - אם רוצים לפצל. מומלץ להעביר 1 וכל חודש לחייב מחדש. |
| 15 | TokenToCharge.RefundInsteadOfCharge | False - חיוב אסימון True - זיכוי אסימון |
האם לבצע זיכוי לאסימון במקום חיוב. ( זה לא משחרר מסגרת אשראי , זה ממש מזכה את מחזיק הכרטיס , שחרור מסגרת מתבצע אוטומטי ע"י חברת האשראי או שימוש בפרמטר 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 (ערך קבוע) | פרמטר לשחרור מסגרת אשראי (דרוש להעביר איתו את המספר אישור , שזה מספר העסקה בקארדקום של התפיסת מסגרת בפועל . TokenToCharge.ApprovalNumber ) |
| 26 | TokenToCharge.JParameter | תפיסת מסגרת - 5 בדיקה לכרטיס - 2 |
אסימון שקיים במערכת ורוצים שוב לבצע תפיסת מסגרת ניתן להעביר פרמטר זה עם ערך 5 ( אופציונאלי ) |
| 27 | TokenToCharge.UniqAsmachta |
יש להעביר את המזהה הייחודי של העסקה במערכת שלך , אם נקבל שוב את אותו מזהה המערכת תחזיר - עסקה כפולה. ולא תחייב את העסקה .
סוג - מחרוזת של עד 25 תווים.כדי להימנע מתקלות T/O בחיובים, יש להימנע משליחת ריבוי בקשות עם פרמטר זה במקביל. (לעבוד טורי) |
מזהה ייחודי של עסקה - רצוי ל בדיקת עסקאות כפולות. (ברמת מסוף ).
|
| 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 - חשבונית מס קבלה 2 - חשבונית מס זיכוי 3 - קבלה מלכ"ר 4- החזר כסכים לקוחות ( קבלה מלכ"ר זיכוי) |
סוג חשבוניות , יש לשמור את סוג החשבונית ביחד עם מספר החשבונית לזיהוי |
| 9 | InvoiceResponse.AccountID | 1001 | מספר לקוח במערכת רק אם נוצר או בוצע איחוד לכרטיס לקוח. |
| 10 | Token | AA-BB-CC | אסימון הכרטיס |
| 11 | Mutag_24 | 0 - כרטיס פרטי של חברה מנפיקה 1 - מאסטרכרד 2 - ויזה 3 - דיינרס 4 - אמקס 5 - ישראכראט 6 - JCB 7 - discover 8 - מאסטרו (כרטיס של מאסטרכארד) |
מותג הכרטיס |
| 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 חודשים ממועד ביצוע העסקה)