front-end event notification

I found this post https://community.onespan.com/forum/signercomplete-event-does-not-get-received-addeventlistener

it seems those event are only available via launching from iFrame. do you know if client complains not to receive the event, they received some but not all, what could be the issue? where to start troubleshoot?

thanks,

Cindy

they are not getting these events: ESL:MESSAGE:SUCCESS:SIGNER_COMPLETE, ESL:MESSAGE:SUCCESS:SIGNER_COMPLETE_REVIEWED, ESL:MESSAGE:SUCCESS:PACKAGE_OPT_OUT, ESL:MESSAGE:SUCCESS:PACKAGE_DECLINE

they are getting only one event MSL:MESSAGE:REGISTER

Hi Cindy,

Yes, when the signing ceremony is embedded in an iFrame, OSS sends Javascript notifications to your parent window when specific actions are triggered.

You can find an iFrame example for how to listen for OneSpan Sign events from this guide "Using JavaScript Event Notifiers".

Typically a listener function looks like this:

function receiveMessage(event) {
      var origin = event.origin || event.originalEvent.origin;
      var data = event.data;
      console.log(data, origin);
 
      switch (data) {
            case 'ESL:MESSAGE:REGISTER':
                  event.source.postMessage('ESL:MESSAGE:ACTIVATE_EVENTS', origin);
                  break;
            default:
                  event.source.postMessage(data, origin)
                  break;
      }
}

As the signing process goes, you should be able to see a list of events printed in the dev console.

Duo

thanks Duo, I will refer to the post you posted.

Hi Duo,

if signer clicks handover button, is there front-end event listen to that? if so, what's the event name?

thanks,

Cindy

Hi Cindy,

Unfortunately, there's no JS event for handover button. But if the handover page shares the same origin as the parent window, in the handover page, you can call an IIFE JavaScript function to notify our parent window like below:

(function(){ window.parent.postMessage('ESL:MESSAGE:SUCCESS:HANDOVER_URL', "*"); })();

You must use a source that shares the same origin as the parent window, because this source is used to establish the cross-window communication between the iFrame and the parent page. 

Once the redirect is triggered, the parent window can receive the post message sent from the hook link, and this message can be handled just like other notifications sent from OneSpan Sign. Below is a sample code:

function receiveMessage(event) {

var origin = event.origin || event.originalEvent.origin;

var data = event.data;

console.log(data, origin);

switch (data) {

case 'ESL:MESSAGE:SUCCESS:HANDOVER_URL':

// call your function here break;

default:

event.source.postMessage(data, origin)

break;

}

}

Duo

thanks for the information, I will let my client know. 

thanks,

Cindy

Hi Duo,

I have another question as my client is asking if during signing ceremony anything failed, does OSS sent event notification back to app? if not, how can the control back to app in case of any error during signing ceremony?

P.S my client is using iframe to launch OSS.

thanks,

Cindy

also if signing token is expired, how the calling app knows that?