בעבודה עם iframe שליחת Event לדף בית העסק מקארדקום - [למתכנת]

כאשר דף תשלום של קארדקום (דף פרופיל נמוך) נפתח מתוך אתר בית העסק / המערכת החיצוני,

ע"י שימוש במנגנון iframe או popup, ניתן מעתה "לתפוס" בצד המערכת אירוע בו הלקוח מופנה לכתובת כלשהי.

אירועים נפוצים למקרה מסוג זה:

• הפניה לדף תשלום חיצוני, כגון PayPal או ביט.
• הפניה לדף הצלחה או כילשון, כהגדרתו בעת פתיחת הדף.

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

שירשם ויאזין לערוץ זה, ולהוסיפו לאובייקט המייצג את הדף. (קרי חלונית הצאצא window instance שמחזיק את דף התשלום של קארדקום).

האירוע יכלול בתוכו אובייקט עם המידע הבא:

• כתובת הדף שאליה הלקוח הועבר ב-context דף התשלום שלנו.  (כתובת אתר התשלום החיצוני למשל)
• מזהה האירוע - בשלב זה קבוע "RedirectingCustOnCardcomPage".

להלן דוגמת קוד:

// see also: https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage

// to catch this event on parent, add the following from parent/opener window:
// ---------------------------------------------------------------------------
// window.addEventListener("message", (event) => {
// if (event.origin !== "https://secure.cardcom.solutions")
// return;
// if (event.data.action == "RedirectingCustOnCardcomPage") {
// let newTarget = event.data.value;
// // handle this info however is relevant...
// }
// }, false);

ניתן לייעל מנגנון זה במקרים בהם אירע כשל טכני בהעברת הלקוח לדף (מחמת מגבלות אבטחה ב-iframe כדוגמא)

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

=============================================