Pay3 Javascript SDK
Callback URL

4min
Introduction
The application can call transaction functions using an optional parameter called callbackUrl. Once this parameter is set Pay3 payment modal will redirect the user to this URL with in couple of seconds after transaction is complete. Pay3 payment modal also added an additional parameter data as a query parameter so that your user can be shown the transaction result within this page. 
This works well with the mode=redirect or mode=returnUrl where Pay3 will not be able to send Javascript events to the starting page. 
Example
JS
const checkoutObj = {
  "requestId": requestId,
  "user": {
    "email": "[email protected]"
  },
  "payment": [
    {
      "amount": "20.25",
      "name": "brl_bz",
    }
  ],
  "mode": "redirect",
  "callbackUrl": "https://your-whitelisted-url.com/xyz"
};
pay3Pay.openCheckout(checkoutObj);
const checkoutObj = {
  "requestId": requestId,
  "user": {
    "email": "user@email.address"
  },
  "payment": [
    {
      "amount": "20.25",
      "name": "brl_bz",
    }
  ],
  "mode": "redirect",
  "callbackUrl": "https://your-whitelisted-url.com/xyz"
};
pay3Pay.openCheckout(checkoutObj);
﻿
Payment Results
Payment results are added to the callbackUrl using a parameter data. The value of the parameter is a base64 encoded, JSON string of the result. 
Sample code to decode the data payload
JS
// After completing transaction, Pay3 payment modal will redirect
// to callbackUrl - For example
// https://your-whitelisted-url.com/xyz?data=eyJkYXRhIjp7InN0YXR1cyI6IlNVQ0NFU1MiLCJtZXNzYWdlIjoiVHJhbnNhY3Rpb24gY29tcGxldGVkIHN1Y2Nlc3NmdWxseSIsIm9yZGVySWQiOiIwOWQ4Mzc1Zi04MDUxLTQyNTctYWI0NC1hNTY1OGIzNTBiZDMiLCJyZXF1ZXN0SWQiOjQ2ODg3NywicmVjZWlwdCI6InR4blJlY2VpcHQifX0= 

data='eyJkYXRhIjp7InN0YXR1cyI6IlNVQ0NFU1MiLCJtZXNzYWdlIjoiVHJhbnNhY3Rpb24gY29tcGxldGVkIHN1Y2Nlc3NmdWxseSIsIm9yZGVySWQiOiIwOWQ4Mzc1Zi04MDUxLTQyNTctYWI0NC1hNTY1OGIzNTBiZDMiLCJyZXF1ZXN0SWQiOjQ2ODg3NywicmVjZWlwdCI6InR4blJlY2VpcHQifX0=';
resultObj = JSON.parse(atob(data));

/*
{
    "data": {
        "status": "SUCCESS",
        "message": "Transaction completed successfully",
        "orderId": "09d8375f-8051-4257-ab44-a5658b350bd3",
        "requestId": 468877,
        "receipt": "txnReceipt"
    }
}
*/
// After completing transaction, Pay3 payment modal will redirect
// to callbackUrl - For example
// https://your-whitelisted-url.com/xyz?data=eyJkYXRhIjp7InN0YXR1cyI6IlNVQ0NFU1MiLCJtZXNzYWdlIjoiVHJhbnNhY3Rpb24gY29tcGxldGVkIHN1Y2Nlc3NmdWxseSIsIm9yZGVySWQiOiIwOWQ4Mzc1Zi04MDUxLTQyNTctYWI0NC1hNTY1OGIzNTBiZDMiLCJyZXF1ZXN0SWQiOjQ2ODg3NywicmVjZWlwdCI6InR4blJlY2VpcHQifX0= 

data='eyJkYXRhIjp7InN0YXR1cyI6IlNVQ0NFU1MiLCJtZXNzYWdlIjoiVHJhbnNhY3Rpb24gY29tcGxldGVkIHN1Y2Nlc3NmdWxseSIsIm9yZGVySWQiOiIwOWQ4Mzc1Zi04MDUxLTQyNTctYWI0NC1hNTY1OGIzNTBiZDMiLCJyZXF1ZXN0SWQiOjQ2ODg3NywicmVjZWlwdCI6InR4blJlY2VpcHQifX0=';
resultObj = JSON.parse(atob(data));

/*
{
    "data": {
        "status": "SUCCESS",
        "message": "Transaction completed successfully",
        "orderId": "09d8375f-8051-4257-ab44-a5658b350bd3",
        "requestId": 468877,
        "receipt": "txnReceipt"
    }
}
*/
﻿
Payload
data (Type Object): Following keys are present in this object 
status (Type string): The status can have one of these values - SUCCESS or ERROR or INITIATED.
message (Type string): User-friendly message returned after completion of the transaction.
orderId (Type string): Pay3 Order ID.  
requestId (Type string): Unique ID passed by Application
Whitelisting of Callback URL
The domain of the callback URL needs to be whitelisted for the clientId. Please reach out to support if you see following error. The domain needs to be whitelisted. According to the above example https://your-whitelisted-url.com needs to be whitelisted.
﻿
Domain not whitelisted error
﻿
﻿
Updated 28 Jun 2024
Did this page help you?
Event Listeners
Pay3 Unity Integration