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

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

מספר מאמר: AA-00240 צפיות: 11824 נוצר: 03/05/2012 17:51 עדכון אחרון: 15/02/2018 10:54 100 דירוג/ 1 מצביע

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

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

יש לבדוק שפרמטר 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.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 שווה אפס!

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

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

    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.solutions/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
    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
    כל הזכויות שמורות לחברת קארדקום בע"מ