חיוב / ביטול עסקה מושהית בAPI
עסקה מושהית משהה רק את העסקה חד פעמי ומכניס אותה למערכת של קארדקום .
אפשרויות החיוב הם:
בחיוב דרך API
בחיוב דרך המערכת UI של קארדקום לפי מדריך זה -> מדריך עסקה מושהית
לצורך יותר גמישות יש לעבוד עם מודול אסימונים במקום .
חיוב עסקה מושהית
מערכת הסליקה תומכת בשתי סוגי ממשקים , Name To Value ו Web Service. טבלת הפרמטרים זהה לשתי סוגי הממשקים.
1. Web Service
כתובת ה Web Service היא : https://secure.cardcom.solutions/Interface/BillGoldService.asmx
הפונקציה שיש להשתמש לשם חיוב עסקה מושהית היא : SuspendedDealActivateOne
ראה בהמשך טבלאות פרמטרים להעברה וקבלת תשובה.
2. Name To Value
כתובת Name To Value היא: https://secure.cardcom.solutions/interface/SuspendedDealActivate.aspx
מומלץ להעביר פרמטרים ב POST , ב GET זה יותר לבדיקות .
יש להשתמש במשתמש API
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
3. טבלת פרמטרים להעברה לחיוב עסקה מושהית:
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | TerminalNumber | 1000 | מספר מסוף |
| 2 | UserName | TestUser | שם משתמש API |
| 3 | SuspendedDealID | 321321 | מספר עסקה לחיוב כפי שהתקבל בעת היצירה של עסקה מושהית. |
4. טבלת פרמטרים התשובה המתקבלת :
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | ResponseCode | 0 - תקין , אחר שגוי | האם החיוב הצליח. |
| 2 | Description | תקין | תיאור התשובה , במידה ומתקבל שונה מ-0 יש לבצע רישום והתראה למנהל המערכת |
| 3 | InternalDealNumber | 1234567 | מספר עסקה פנימי לחיוב של חיוב כרטיס האשראי (int64) |
| 4 | InvoiceResponse.ResponseCode | 0 | קוד תשובה של יצירת חשבוניות, ישנו מצב שהחיוב תקין אבל ישנה בעיה עם החשבונית. מערכת אישורית זהב נותנת עדיפות לחיוב. |
| 5 | InvoiceResponse.Description | תקין | תיאור תשובה של יצירת חשבונית |
| 6 | InvoiceResponse.InvoiceNumber | 332 | מספר חשבונית, יש לשמור גם את סוג החשבונית לשם זיהוי |
| 7 | InvoiceResponse.InvoiceType | 1 - חשבונית מס קבלה 2 - חשבונית מס זיכוי 3 - קבלה מלכ"ר 4- החזר כסכים לקוחות ( קבלה מלכ"ר זיכוי) |
סוג חשבוניות , יש לשמור את סוג החשבונית ביחד עם מספר החשבונית לזיהוי |
דוגמה לפניה לחיוב עסקה מושהית מהמערכת:
https://secure.cardcom.solutions/Interface/SuspendedDealActivate.aspx?username=TestUser&userpassword=p1234567&terminalnumber=1000&SuspendedDealId=751
________________________________________________________________________________________________________________
ביטול/מחיקה עסקה מושהית
Name To Value
כתובת Name To Value היא: https://secure.cardcom.solutions/interface/DeleteSuspendedDeal.aspx
| מספר | פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | TerminalNumber | 1000 | מספר מסוף |
| 2 | UserName | TestUser | שם משתמש API |
| 3 | SuspendedDealID | 751 | מספר עסקה כפי שהתקבל בעת היצירה של עסקה מושהית. |
| 4 | UserPassword | p1234567 | סיסמת ה API |
דוגמה לפניה לביטול / מחיקה עסקת 751 מהמערכת :
https://secure.cardcom.solutions/Interface/DeleteSuspendedDeal.aspx?