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

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

מספר מאמר: AA-00240 צפיות: 9619 נוצר: 03/05/2012 17:51 עדכון אחרון: 13/08/2017 17:14 0 דירוג/ מצביע

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

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

יש לבדוק שפרמטר OperationResponse שווה אפס!

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

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

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

 

שלבים :

  1. קבלת לקוח לדף הצלחה או  indicator URL אישורית זהב לאחר רכישה.
  2. משיכת תשובה משרת אישורית זהב לשם בדיקה אם העסקה הסתימה בהצלחה.


קבלת פנייה  לדף הצלחה או  indicator URL :

 החל מגרסה API 9 ומעלה הפרמטרים שהמערכת שלכם מקבלת בדף הצלחה / indicator URL הם  :

שם לב חייבם לפנות לשרת הסליקה אישורית זהב לשם וידו הפרמטרים !

פרמטר  תיאור ערכים אפשריים לדוגמה
terminalnumber    המסוף שביצע  את הפעולה 1000 
 lowprofilecode  קוד העסקה לבדיקה  AA-BB-CC
 Operation  קוד הפעולה שבוצעה  
  • 1 - חיוב בלבד
  • 2 - חיוב + יצירת אסימון
  • 3 - יצירת אסימון בלבד
  • 4 - עסקה מושהית בלבד
  • לדוגמה :

    http://www.site.com/page.aspx?terminalnumber=1000&lowprofilecode=aa-bb-cc....&Operation=1


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

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


    Web Service

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

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


    Name To Value

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

    הערות ל Name To Value:

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

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

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

    יש לבדוק שפרמטר OperationResponse שווה אפס!

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

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

    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

    דוגמה ל GET :

    https://secure.cardcom.co.il/Interface/BillGoldGetLowProfileIndicator.aspx?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
    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
    כל הזכויות שמורות לחברת קארדקום בע"מ