Mobile Apps (JavaScript)

If you'd like to implement Paylink in your mobile app, there is a solution if your app is based on JavaScript code.

First of all you will need to Create a Paylink Gateway. You will get an URL for your gateway. Display this URL in an iFrame.
After that, you need to add an event listener on the window which will forward all pushed messages from Paylink Gateway iFrame to the function handleMessage.

JavaScript

window.addEventListener('message', handleMessage(this), false);

Now we need to add a function handleMessage which will check whether the transaction has been completed or not:

JavaScript

function handleMessage(e) {
    try {
        var transaction = JSON.parse(e.data);
        if (typeof transaction === 'object' && transaction.length > 0) {
            if (transaction.status === 'confirmed') {
                // on successful transaction
            } else {
                // on failed transaction
            }
        }
    } catch (e) {}
}

At this point, the iFrame won't have the rights to push any message to its parent (your mobile app).
That's why you need the following code snippet called each time the iFrame content has been loaded.

JavaScript

function showFrame() {
    var iFrame = document.getElementById('paylink');
    iFrame.contentWindow.postMessage(
        JSON.stringify({
            origin: window.location.origin
        }),
        iFrame.src
    )
}

This will tell our Paylink Gateway which Origin the parent has (most time it will be NULL for web apps). But it is actually necessary to tell the Paylink page this information, so it will be able to push messages to your main window.