Mobile Apps (JavaScript)

If you'd like to implement OkePay 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 OkePay 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 OkePay Gateway iFrame to the function handleMessage.

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:

function handleMessage(e) {
    try {
        var transaction = JSON.parse(;
        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.

function showFrame() {
    var iFrame = document.getElementById('okepay');
            origin: window.location.origin


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