1.0.2 • Published 8 months ago

cordova-plugin-new-upi-payment v1.0.2

Weekly downloads
-
License
MIT
Repository
github
Last release
8 months ago

cordova-plugin-new-upi-payment

Cordova plugin to pay via UPI supported apps via intent based

Supported Platform:

  • Android

Installations:

cordova plugin add cordova-plugin-new-upi-payment

After installation, the upi plugin would be avilable in "window" object.

Methods:

  • Fetch UPI supported apps.
let successCallback = function (apps) {
    console.log("UPI supported apps", apps);
}
let failureCallback = function (err) {
    console.error("Issue in fetching UPI supported apps ", err);
}

window["UPI"].supportedApps(successCallback, failureCallback);
  • Start a transaction you can start a transaction either by passing upistring or parsed value as given below.
let config = {
        "pa": "pa", // VPA no from UPI payment acc
        "pn": "pn", // Merchant Name registered in UPI payment acc
        "me": "me", // Merchant Code from UPI payment acc
        "tid": "tid", // Unique transaction id for merchant's reference
        "tr": "tr", // Unique transaction id for merchant's reference
        "tn": "tn", // Note that will displayed in payment app during transaction
        "am": "am", // Amount 
        "mam": "mam", // its optional. Minimum amount that has to be transferred 
        "cu": "cu", // Currency of amount
        "url": "url" // URL for the order
};

or

let config = {
        "payeeVPA": "pa", // VPA no from UPI payment acc
        "payeeName": "pn", // Merchant Name registered in UPI payment acc
        "payeeMerchantCode": "me", // Merchant Code from UPI payment acc
        "transactionId": "tid", // Unique transaction id for merchant's reference
        "transactionRef": "tr", // Unique transaction id for merchant's reference
        "transactionNote": "tn", // Note that will displayed in payment app during transaction
        "amount": "am", // Amount 
        "minimumAmount": "mam", // its optional. Minimum amount that has to be transferred 
        "currency": "cu", // Currency of amount
        "transactionRefUrl": "url" // URL for the order
};
let successCallback = function (result) { 
    /* success and failure of payment will be given in this method, this is because each payment uses different name to represent the status of transaction under "Status" field.*/
    console.log("result of success interaction of payment app", result);
}
let failureCallback = function (err) {
    console.error("Issue in interaction and completion of payment with UPI", err);
}
/* Use Case 1: Open android intent for all UPI apps */
let UpiIntent = null;
window["UPI"].acceptPayment(config, UpiIntent, successCallback, failureCallback);

/* Use Case 2: Open single upi app */
let UpiIntent = 'com.phonepe.app';
window["UPI"].acceptPayment(config, UpiIntent, successCallback, failureCallback);

/* Use Case 3: Open intent for custom UPI apps */
let UpiIntent = ['com.phonepe.app','com.google.android.apps.nbu.paisa.user'];
window["UPI"].acceptPayment(config, UpiIntent, successCallback, failureCallback);

Sample response of successful payment

{
  "ApprovalRefNo": "932413452",
  "Status": "SUCCESS",
  "message": "txnId=764900774.690841&responseCode=00&Status=SUCCESS&txnRef=417855597.31908274&ApprovalRefNo=932413452",
  "responseCode": "00",
  "status": "SUCCESS",
  "txnId": "764900774.690841",
  "txnRef": "417855597.31908274",
  "appId": "com.phonepe.app.preprod",
  "appName": "PhonePe Preprod",
}

Sample response of failure payment

{
  "Status": "FAILURE",
  "message": "txnId=901818401.3087038&responseCode=ZD&Status=FAILURE&txnRef=654595701.7025663",
  "responseCode": "ZD",
  "status": "FAILURE",
  "txnId": "901818401.3087038",
  "txnRef": "654595701.7025663",
  "appId": "com.phonepe.app.preprod",
  "appName": "PhonePe Preprod",
}

Release Notes:

1.0.2:

Initial Release of cordova plugin for upi transaction Response must be changed for different UPI apps. "Status" is the common key for verification for all UPI apps.

1.0.2

8 months ago

1.0.1

8 months ago

1.0.0

8 months ago