מרכז הידע / תוכנת קארדקום

שאלו את ה-AI

✦ תשובת ה-AI

חושב…

מקורות

    WEBHOOK (וובהוק) - קבלת פרטי עסקה מדפי אישורית זהב אל מערכת חיצונית צד ג

    שימו לב.

    1.  עליך לדעת לטפל בדיווח כפול. ניתן לבדוק דיווחים כפולים לפי המספר עסקה עם פרטר InternalDealNumber.

      ניתן לקבל את פרטי העסקה שבוצע בדף אישורית זהב בדחיפה לאתר שלך או לאתרים צד ג' . 
      לדוגמא חיבור למערכות crm , zapier , וכו .

    על מנת להפעיל אפשרות זו  לכלל דפי הנחיתה יש לבצע הגדרה מתאימה בהגדרות >5. אישורית זהב  > 2. הגדרות לפי שפה.  למטה הגדרות למפתחים

    בשדה "האם לבצע וידוא עסקה" יש לבחור "כן"  ולהוסיף את "כתובת קבלת פרטי עסקה" המתאימה.

    mceclip1.png

     

    מערכת הסליקה תבצע פנייה לדף לאחר סליקה שמבוצעת בפרוטוקול HTTP  GET / POST  עם הפרמטרים הבאים ( ראה דוגמה בסוף )

     

    או בהגדרה לדף ספציפי בלבד נכנס אל לשונית פעילות שוטפת->4. דף נחיתה לתשלום

    נערוך את דף הנחיתה ע"י לחיצה על העיפרון הכחול-> נעבור אל לשונית "מתקדם"

    ונכניס את הכתובת לדיווח הרלוונטית בשדה "  "

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

     

    הערות:

    1. פרמטרים באדום תמיד מועברים , שאר הפרמטרים מועברים רק אם קיימים במערכת.
    2. הדיווח הוא על סליקה שבוצעה בהצלחה ובכישלון . יש לבדוק הפרמטר  responsecode לראות אם העסקה בוצעה בהצלחה.
    3. לא לשכוח להפעיל את הפנייה בהגדרות אישורית זהב.
    4. ניתן לשנות את שמות הפרמטרים על מנת להתאים אותם למערכות שונות דרך : הגדרות -> דף אישורית זהב -> שינוי שמות לממשק.
       
    5. ניתן להגדיר דיווחים גם ב רמת דף אישורית בודד ( בעריכת דף - לשונית מתקדם - האם לבצע דיווח עסקה נוסף )
    6. בהגדרות -> 5 הגדרות דף אישורית זהב -> 2. הגדרות כלליות, יש כתובת נוספת לדיווח. זה לא כתובת שלישית, זה רק בשביל שלא יהיה צורך לעשות כתובת אחרת עבור כל שפה.
    7. בפועל אפשר לעשות עד שני כתובות דיווח שונות, גם בדף נחיתה וגם בהגדרות לפי שפה.

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

     

    מספר פרמטר ערכים אפשריים לדוגמה תיאור
     1  responsecode  0 - חיוב בהצלחה
     אחרת חיוב נכשל    		 קוד תשובה של ביצוע העסקה
     2  xparameter  123 פרמטר מוחזר : ערך הפרמטר DealIdentityCode שמועבר לדף הסליקה.
    ראה : טבלת פרמטרים : העברת פרמטרים לדף אישורית מספרים בלבד!
     3  terminalnumber  1000   מספר מסוף מבצע העסקה
     4  ReturnData  AFFI123

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

    העברת פרמטרים אל דף אישורית זהב 4

     , מחרוזת 25 תווים
     5  internaldealnumber  12345 מזהה ייחודי של העסקה במערכת אישורית זהב. רצוי לשמור פרמטר זה
     6  suminfull  1.00 עבור שקל.
    1 עבור עסקה של שקל.
    (מקבלים סימן נקודה)    		  סכום עסקה בעשרוני
     7  suminagorot  100 עבור עסקה של שקל.
    150 עבור עסקה של שקל וחצי.
    (לא מקבלים סימן נקודה)    		  סכום העסקה באגורות

     
     8  cointype  0  : מטבע ISO
     1  : שקל
     2 : דולר    		  מטבע חיוב
     9  ApprovelNumber   0012345 מספר אישור לעסקה מחברות האשראי
     10  responsdescription  תקין   תיאור התשובה בהתאם לקוד התשובה responsecode
     11  ProdName  אופניים עם 4 גלגלים

     שם/תיאור המוצר הנרכש   

    בריבוי פריטים שנרכשו ("בחירה מרובה"), פריט ראשון יופיע ProdName, שני ואילך ממוספרים.

    (ProdName, ProdName1, ProdName2...)
     12  ProdGroupID  2 מספר הקבוצה / הדף שאליה שייך המוצר. בהתאם מספר הקבוצה / הדף שמופיע במערכת הניהול
     13  GroupDescription  קורסים  תיאור שם קבוצה/דף
     14  ProdItemID 2  מספר הפריט . בהתאם למספר הפריט שמופיע במערכת הניהול של קארדקום.
     15  ProdQuantity  1

    כמות שנרכשה עבור פריט
    בריבוי פריטים שנרכשו ("בחירה מרובה"), פריט ראשון יופיע ProdItemID, שני ואילך ממוספרים.

    (ProdQuantity, ProdQuantity1, ProdQuantity2...) 
      ProdPrice 50 מחיר הפריט הנרכש
     16  CardOwnerName  אלי כהן  שם בעל הכרטיס
     17  CardOwnerPhone  050-8855444 טלפון בעל הכרטיס
     18  CardOwnerID  123456789 תעודת זהות בעל הכרטיס
     19  Lest4Numbers  5874 4 ספרות של סיומת כרטיס
     20  MutagName  ויזה כאל שם מותג הכרטיס  ראה:  קודי מותג
     21  MutagId  2 קוד המותג   ראה:  קודי מותג
     22  UserEmail  MyEmail@Site.com  כתובת דואר שהוקלד
     23  UserIP  UserIP  כתובת IP של המשתמש
     24  ProductID  AVCD123 

     קוד פריט / מק"ט כפי שהמשתמש הגדיר על הפריט.
     

    בריבוי פריטים שנרכשו ("בחירה מרובה"), פריט ראשון יופיע ProductID, שני ואילך ממוספרים.

    (ProductID, ProductID1, ProductID...)
     25  AffiliateID  123   קוד רשימת התפוצה שנבחרה
     26  DelivarySum  100.12   סכום המשלוח שנבחר
     27  DelivaryProductID  ABC  קוד מוצר משלוח 
     28  NumberOfPaymentsToPrint  6 מספר תשלומים כולל  
     29  FirstPayment  13  בעסקת תשלומים מה סכום התשלום הראשון
    יש לחלק חלקי 100 , הסכום מופיע באגורות
     30  ConstPayment  123 בעסקת תשלומים מה הסכום שאר התשלומים
    יש לחלק חלקי 100 , הסכום מופיע באגורות
      NumberOfPaymentsToPrint 3 מספר תשלומים כולל שמודפס על החשבונית
     31  IsTrumaDebite     true  האם מצב תרומה
     32  NumOfPaymentForTruma  12 מספר תשלומים במצב תרומה
      AffiliateID 12 מספר אפליאט אי די / מספר הדף
     33  RecurringCode  0 - הצלחה אחרת כישלון   במידה ומוסיפים להוראת קבע בענן קוד התשובה של ההוספת
     34  RecurringIsNewAccount  true   הוראת קבע בענן : האם נוצר חשבון לקוח חדש
     35  RecurringAccountID  123    הוראת קבע בענן : מספר חשבון לקוח החדש
     36  RecurringOrderID  3   הוראת קבע בענן : מספר הוראה לחיוב  
     37  CardYear  2019 תוקף הכרטיס YYYY
     38  CardMonth  12 תוקף הכרטיס חודש M
     39  Token 4cf8e168-XXXX-4613-XXXX-000332986b24 אסימון הכרטיס – רק למי שיש מודל הוראת קבע בענן בהרשאות למסוף.
    40 SuspendedDealId 1451512 מספר עסקה מושהית שנוצרה
    41 screamid 1055 מספר scream למי שעובד עם ממשק זה
    42 TotalCommition   2.5 עמלה שחברת UPAY גבתה במקרה של תשלומים בקרדיט במסופי UPAY
    43

    CreditCardIssuer

     

    Tourist
     

    Isracard
    CAL
    Diners
    American Express
    JCB

    MAX

    		 מנפיק הכרטיס

     

    פרטי חשבונית

    מספר פרמטר ערכים אפשריים לדוגמה תיאור
     1  invNumber  123   מספר חשבונית
     2  invType  1 : חשבונית מס / קבלה
     2 : קבלה  תרומה    		  סוג חשבונית
     3  invResponseCode  0 : חשבונית נוצרה
    אחר 
    קוד השגיאה של יצירת חשבונית     		  קוד תשובה ליצירת חשבונית
     4  intTo  משה   חשבונית לכבוד
     5  invCompanyID  012345678  תעודת זהות / ח.פ  לחשבונית
     6  intCity  אילת   חשבונית עיר
     7  InvAddress    חשבונית כתובת שורה אחת
     8  InvAddress2    חשבונית כתובת שורה 2
     9  InvPhone    טלפון חשבונית
     10  InvMobile    טלפון נייד חשבונית
     11  CouponNumber  12GF11  מספר קופון שהוכנס במערכת
      ProdPrice 50  מחיר פריט 
     12  ProdTotalLines  2  מספר כולל של שורות מסמך

     

    פרמטרים למשלוח ( הפעלת שדות למשלוח בעיצוב חדש בלבד )

    מספר פרמטר ערכים אפשריים לדוגמה תיאור
     1 DelivaryProductID delivery normal  קוד המשלוח , קוד פריט לחשבונית
     2 DeliveryCity  חולון  עיר למשלוח
     3 DeliveryStreet  הרוקמים   רחוב למשלוח
     4 DeliveryBuilding  26  מספר בית
     5 DeliveryApartment  4  מספר דירה
     6 DeliveryFloor  1  קומה
     7 DeliveryEntrance  ב  מספר כניסה
     8 DeliveryNotes הערות עד 250 תווים הערות לשליח
     9 DeliveryMethod 2  מספר קוד המשלוח, מספר תוספת


    שדות מותאמים אישית:

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

    שדות אלו מועברים באופן דיפולטיבי במידה וקיים ערך. (ז"א גם אם לא הועברו שדות מותאמים אישית, שדות אלו מועברים תמיד אם יש ערך, לדוגמה: לקוח ביצע רכישה מדף אישורית עם קופון,

    אזי יופיע בוובהוק: Custom22=example2024).

     

             שם שדה            תיאור שדה
    Custom19 קוד קבוצה
    Custom20 מספר תשלומים
    Custom21 קוד פריט
    Custom22 מספר קופון
    Custom23 כמות
    Custom24 תיאור פריט

     

    פרמטרים נוספים של UTM 

    19 utm_source facebook פרמטרים נוספים שעוברים לדף הצלחה יש לסמן וי בממשק - העברת פרמטרים נוספים
    20 utm_medium medium פרמטרים נוספים שעוברים לדף הצלחה יש לסמן וי בממשק - העברת פרמטרים נוספים 
    21 utm_campaign campaignNAME פרמטרים נוספים שעוברים לדף הצלחה יש לסמן וי בממשק - העברת פרמטרים נוספים 
    22 utm_content content פרמטרים נוספים שעוברים לדף הצלחה יש לסמן וי בממשק - העברת פרמטרים נוספים 
    23 utm_term term פרמטרים נוספים שעוברים לדף הצלחה יש לסמן וי בממשק - העברת פרמטרים נוספים 


     

    שדות מותאמים אישית מתחילים ב Custom ולאחר מיכן שתי ספרות של מספר השדה כפי שמופיע במערכת הניהול. רק שדות עם ערך מועברים בממשק . 

    לדוגמה אם הלקוח הקליד ערך בשדות מספר 4 ו8 מה שיעבור הוא :

    Custom04=Today&Custom08=Male

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

    http://www.yoursite.co.il/yourpage.aspx?responsecode=0&UserEmail=yaniv@smsendsr.co.il&suminfull=120.50 .....

    שם לב!

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

     

    ניתן לראות LOG של הדיווח על העסקה עצמה בדוחות סליקה יש ללחוץ על העסקה עצמה .

    ולאחר מכן יש ללחוץ על לשונית ממשקים .
    ניתן לבדוק את הדיווחים כאן.

    הטיים אווט של הדיווחים הם 10 שניות בדיווח הראשון .

    אם לא מצליח שולח שוב ושוב 7 ניסיונות

     

    ניתן להיעזר באתר זה :

    https://meyerweb.com/eric/tools/dencoder/

    אתר Webhook חינמי לבדיקות :
    https://webhook.site/#!/1e592943-0f07-4f7c-819d-c35f63db860a

       

    במקרה שהמערכת לא תצליח לדווח למתכנת גם , בעל העסק יקבל התראה על כך - מצב תמונה.

    mceclip0.png

     

    * במקרה של תקלה בדיווח עסקה מהשרת של קארדקום לשרת של הלקוח * 

    נדרש לפתוח את כל טווחי הכתובת IP הבאים של קארדקום בחומת האש של החברה (גם ב cloudflare למי שיש)

    - 82.80.227.17/255.255.255.248 (CIDR 29) >> מחשבון subnet

    - 82.80.222.124/255.255.255.248 (CIDR 29) >> מחשבון subnet

    בנוסף יש לפתוח כמובן PORT ים : 80 , 8080 , 443 .

     

    האם המאמר הזה עזר לך?