react-native-upier
v1.0.5
Published
UPI Payments handler for react native apps
Downloads
42
Readme
react-native-upier
UPI handler for react native apps react-native-upier is a tiny plugin to integrate the UPI payment interface made by NPCI from your react native apps. This plugin allows you to enable peer to peer payments via UPI in your react native apps. Linking specs have been followed as per this doc
Installation
npm install react-native-upier
yarn add react-native-upier
Usage
Android
Automatic Installation
react-native run link
Manual Installation
Open android/settings.gradle
add the following
include ':react-native-upier'
project(':react-native-upier').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-upier/android')
Open android/app/build.gradle
add the following in the dependencies section
dependencies {
implementation project(':react-native-upier')
}
Open MainApplication.java
// Other imports
import com.rvuyyuru.rnupier.UpierPackage;
// Add this in the Main Application Class
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
//... Other packages
new UpierPackage() // <- Add this line
);
}
Usage
import RNUPISDK from 'react-native-upier';
RNUPISDK.initializePayment(
{
pa: 'xxxx@upi', // or can be xxx@ybl or mobileNo@upi
pn: 'xxxx xxx',
am: '1',
tf: 'xxxx-xxx-xxx-xxrefid',
},
successCallback,
failureCallback
);
// or
RNUPISDK.initializePayment(
'upi://pay?pa=xxx@upi&am=1&pn=xxxx&tf=xxxx-xxx-xxx-xxrefid', // UPI encodedURI string
successCallback,
failureCallback
);
Config docs
Callbacks
function successCallback(data) {
// do whatever with the data
}
function failureCallback(data) {
// do whatever with the data
}
Responses
SUCCESS CASE
{
/**
* SUCCESS STATUS
* */
Status: "SUCCESS",
/**
* Transaction Id of bank to which upi has been initiated
* */
txnId: "AXId8c71205eb7d459889bb7018bdf2c056",
/**
* 00 response code, for success
* transaction is successful money has been debited
* */
responseCode: "00",
/**
* Transaction reference stated in init obect
* */
txnRef: "xxxx-xxx-xxx-xxrefid"
}
FAILURE CASES
{
/**
* Status Sent on transaction
* If the user presses back or closes app
* */
status: "FAILURE",
/**
* If the user presses back or closes app
* */
message: "No action taken"
} // No action
{
/**
* FAILURE STATUS
* */
Status: "FAILURE",
/**
* Transaction Id of bank to which upi has been initiated
* */
txnId: "AXIa463c7ca81a24e168df5ac9c1359c38c",
/**
* Non 0 response code,
* If the user enters the wrong pin
* */
responseCode: "ZM",
/**
* Transaction reference stated in init obect
* */
txnRef: "xxxx-xxx-xxx-xxrefid"
}
Contributing
See the contributing guide to learn how to contribute to the repository and the development workflow.
License
MIT