סייר
 
אפשריות
Rss קטגורייות

 Featured
פעולות : קבלה (או משיכה) של תשובה משרת הסליקה אישורית זהב [שלב 2]

מספר מאמר: AA-00240 צפיות: 17517 נוצר: 03/05/2012 17:51 עדכון אחרון: 13/02/2020 14:51 100 דירוג/ 1 מצביע

פעולות : קבלה (או משיכה) של תשובה משרת הסליקה אישורית זהב:

פנייה למשיכה של התשובות :

לאחר שמושכים את הנתונים יש לסמן במערכת שלכם שהנתונים נמשכו, זה למנוע בעיה של משיכות חוזרות של העסקה.
ישנם מקרים שהלקוחות / CRULERS גולשים שוב לאותו דף הצלחה או במצעים רענון לדף.
מה שעלול לגרום לכפל עסקאות והזמנות במערכת שלכם. במידה ומסומן שהנתונים נמשכו אין לבצע משיכה שוב.

דוגמה לפנייה ב GET :

https://secure.cardcom.solutions/Interface/BillGoldGetLowProfileIndicator.aspx?terminalnumber=1000&username=APIUserName&lowprofilecode=AA-BB-CC

Web Service

כתובת ה Web Service היא : https://secure.cardcom.solutions/Interface/BillGoldService.asmx
הפונקציה שיש להשתמש לשם קבלת התשובה היא :GetLowProfileIndicator

ראה בהמשך טבלאות פרמטרים לעברה וקבלת תשובה.

Name To Value

כתובת Name To Value היא :https://secure.cardcom.solutions/Interface/BillGoldGetLowProfileIndicator.aspx

הערות ל Name To Value:

  1. חובה לבצע urlencode לכל הערכים המועברים למערכת.
  2. יש להוסיף את הפרמטר codepage=65001  , פרמטר זה אומר את סוג הקידוד המועבר למערכת.
  3. התשובה המתקבלת היא במבנה : ResponseCode=4&Description=NoPemition&LowProfileCode=601.



********* בדיקה האם העסקה תקינה **************

יש לבדוק שפרמטר  OperationResponse == 0

בהתאם לסוג  החיוב שבוצע ניתן לבדוק את הפרמטר המתאים:

ערך אפס משמעותו תקין.

  1. על מנת לבדוק אם חיוב תקין יש לבדוק את פרמטר: DealResponse
  2. על מנת לבדוק אם יצירת אסימון תקינה לבדוק את פרמטר: TokenResponse
  3. על מנת לבדוק אם חשבונית תקינה  יש לבדוק את פרמטר: InvoiceResponseCode
  4. על מנת לבדוק אם יצירת עסקה מושהית תקינה יש לבדוק את פרמטר : SuspendedDealResponseCode

הערות:

  1. פרמטרים באדום תמיד מועברים , שאר הפרמטרים מועברים רק אם קיימים במערכת  , לדוגמה אם לא בוצע בקשה ליצירת אסימון פרמטרים שקשורים לאסימון לא יעוברו.
  2. בנוסף לפרמטרים אלו מתוספים פרמטרים של חברות האשראי ראה מאמר : טבלת פרמטרים : נתונים המתקבלים מחברות האשראי
  3.  הפרמטרים מועברים בHTTP GET לדף הנקבע בצורה של  : http://www.site.com/Indicator.aspx?termianlnumber=1000&lowprofilecode=aa-bb-cc....Operation=1
  4. בעת קבלת תשובה ליצירת אסימון יש לשמור בבסיס הנתונים את הפרמטרים הקשורים לאסימון כפי שמסומן בטבלה.
  5. מומלץ לשמור את כול הנתונים המתקבלים בתשובה זו בסיסי הנתונים.

שם לב ! יתכן ועם הזמן יתווספו פרמטרים נוספים לטבלה זו.

טבלת פרמטרים  לפנייה:

פרמטר  תיאור ערכים אפשריים לדוגמה
terminalnumber   המסוף שביצע  את הפעולה 1000 
 username  שם משתמש ממשקים  APIUserName
 lowprofilecode  קוד העסקה הייחודי  AA-BB-CC

טבלת פרמטרים תשובה המתקבלת :

פרמטר תיאור ערכים אפשריים לדוגמה
terminalnumber    המסוף שמבצע את הפעולה 1000
lowprofilecode קוד הייחודי של העסקה 5BAF4BD5-76FB-4C81-8654-DF481B22EDF3
Operation סוג הפעולה שבוצעה
  • 1 - חיוב בלבד
  • 2 - חיוב + יצירת אסימון
  • 3 - יצירת אסימון בלבד
  • 4 - עסקה מושהית בלבד
  • ProssesEndOK קוד תשובה של התהליך פרמטר פנימי של מערכת לא לשימוש חיצוני!
    OperationResponse  האם החיוב הצליח 0 - תקין
    אחרת לא בוצע חיוב
     
    DealResponse קוד תשובה של חיוב כרטיס האשראי -מועבר רק אם בוצע חיוב אשראי
  • 0 - תקין
  • 3 - סרוב
  • 4 - גנוב
  • וכו...
  • InternalDealNumber מספר ייחודי של העסקה שבוצעה בעת חיוב אשראי
    גודל התשובה יכולה להיות Int64  / Bigint 
    654354685
    TokenResponse קוד תשובה של יציאת אסימון 0 - תקין אחרת שגוי.
    Token מספר האסימון , חובה לשמור בבסיס הנתונים 12F678C4-BC08-4607-ACF2-755FD7FCD3DE
    TokenExDate  תוקף אסימון ,  חובה לשמור בבסיס הנתונים  YYYYMMDD
    CoinId
    קוד מטבע שבוצע העיסקה , ראו קודי מטבע
    1=שקל , 2=דולר
    CardOwnerID ת.ז בעל הכרטיס , חובה לשמור בבסיס הנתונים 012345678
    CardValidityYear תוקף הכרטיס - שנה , ביצירת אסימון יש לשמור בבסיס הנתונים 2014
    CardValidityMonth תוקף הכרטיס - חודש , ביצירת אסימון יש לשמור בבסיס הנתונים 11
     TokenApprovalNumber  מספר האישור חד פעמי המתקבל בעת יצירת אסימון עם בדיקה מסוג  J5 ביצירת אסימון  - יש לשמור בבסיס הנתונים על מנת לבצע חיוב עתידי לעסקה  12345 
    SuspendedDealResponseCode קוד תשובה לעסקה מושהית 0 - תקין אחרת כשלון
    SuspendedDealId מספר עסקה מושהית 1234
    SuspendedDealGroup קבוצה של עסקה מושהית 90
    InvoiceResponseCode קוד תשובה של יצירת חשבונית 0 - הצלחה
    InvoiceNumber מספר חשבונית 55050
    InvoiceType סוג חשבונית 1- חשבונית חיוב
    2 - חשבונית זיכוי
    3- קבלה
    4- החזר כספי ללקוח ( קבלה
    זיכוי)
     CallIndicatorResponse  תיאור התשובה מהשרת שלך בעת קריאה ל IndicatorURL  
     ReturnValue

     הערך כפי שהועבר בעת יצורה של בקשה לחיוב.  
     NumOfPayments

      מספר תשלומים שהלקוח בחר בטופס סליקה .
     
     CardOwnerEmail  אימייל בעל הכרטיס  
     CardOwnerName שם בעל הכרטיס   
     CardOwnerPhone טלפון בעל הכרטיס   
     AccountId  מספר לקוח במערכת אישורית זהב,  רק אם נוצר או בוצע איחוד לכרטיס ללקוח  
     ForeignAccountNumber  מספר הנהלת חשבונית של הלקוח, רק אם נוצר או בוצע איחוד לכרטיס ללקוח  
     SiteUniqueId  מספר מזהה יחודי של לקוח, רק אם נוצר או בוצע איחוד לכרטיס ללקוח  

      בנוסף לפרמטרים אלו ישנם פרמטרים נוספים :

     1. טבלת פרמטרים : נתונים המתקבלים מחברות האשראי 

     2. שדות בהתאמה אישית

     
    קוד לדוגמה :
     
     
     
    הערות
    • אין הערות למאמר זה.
    תמיכה 03-9436100
    כל הזכויות שמורות לחברת קארדקום בע"מ