Pass Micro Transaction package of React Native
Platform Support
| Android | iOS |
|---|---|
| ✔️ | ✔️ |
🔨 Installation
$ npm install -g @databank.mn/pass_mtx_rtn_module
⚙ IOS Setup
$ RCT_NEW_ARCH_ENABLED=1 bundle exec pod install
⚙ Android Setup
1. Open the android/gradle.properties file
2. Scroll down to the end of the file and switch the newArchEnabled property from false to true.
🔨 Turbo Native module documentation
Documentation: https://reactnative.dev/docs/next/the-new-architecture/pillars-turbomodules
⚙ Import
import PassMtxRTN from '@databank.mn/pass_mtx_rtn_module/js/NativePassMtx';⚙ Initialization key config
After import package you need to create keys.json file in same directory in package.json and put below json in it. That fields are used to initialize pass mtx rtn library and used to make purchase through pass gateway safely.
{
"name": "<your org name>",
"app_id": "<you app id>",
"app_user_id": "<your app user id>",
"client_id": "<client id from databank>",
"private_key": "<private key from databank>",
"public_key": "<public key from databank>",
"pos_ids": [
"<allowed terminal id list>"
]
}🕹️ Usage/Example
Initialization & Check connection
Development purpose you can use passStageInit function for select environment of PASS Purchase or other methods. When development done, change it to passInit.
const keys = require('./keys.json')
// Initialize For Staging ENV using AppID ClientID, PrivateKey, PublicKey,
passStageInit(String appId, String clientId, String privatePem, String publicPem);
// Initialize For Production ENV using AppID ClientID, PrivateKey, PublicKey,
passInit(String appId, String clientId, String privatePem, String publicPem);
// Get Pass API Status
getPassPing();
// Get Pass Version Info
getPassVersion();
// Initialization example using release mode
var passInitResult = await PassMtxRTN?.passInit(keys.app_id, keys.client_id, keys.private_key, keys.public_key) ??
'Unknown platform version';
// Initialization example using debug mode
var passStageInitResult =
await PassMtxRTN?.passStageInit(keys.app_id, keys.client_id, keys.private_key, keys.public_key) ??
'Unknown platform version';Card Methods
Included methods of Card registration and Get card lists you added in PASS wallet or delete it.
// Get card token by UserID
getCard(String userId);
// Saving user card info
saveCard(String userId, String szPan, String cvv, String expDate, String cardHolderName);
// Verify Card
verifyCard(String userId, String verificationMethod, String verificationValue)
// Delete User card
deleteCard(String userId, String cardRef);
// Set Default card
setDefaultCard(String userId, String cardRef);Purchase
Direct Purchase
Pass MTX RTN included micro transaction method makePassPurchase. paymentAmount field need to multiple by 100 for original amount. If user enters 1000 in TextEditor, multiply it 1000 * 100 than send it through paymentAmount field. HEY PASS ME...
// Make Pass Purchase
purchase( String userId, String orderId, String paymentToken, String paymentAmount, String expDate, String dbRefNo, String description)
// Make Purchase Example
var convertedAmount = (parseInt(amount) * 100).toString();
var orderId = 'INAPPV1' + Date.now().toString();
var dbRefNo = 'DTB' + Date.now().toString();
var description = paymentDescription ?? 'rtn inapp purchase direct test';
var response = PassMtxRTN?.purchase(
keys.app_user_id,
orderId,
paymentToken,
convertedAmount,
expiryDate,
dbRefNo,
description,
);Customer Presented Mode Purchase
// Inquiry the presented qr scanned by scanner and get process of payment
orderEnquery(String userId, String orderId)
// Optional: When amount above under CVM limit
orderConfirm(
String userId,
String orderId,
String confirmMethod,
String confirmResult,
String payToken,
String expDate)
// Cancel order by user
orderCancel(String userId, String orderId)📃 License
/*
#################################################################################
# #
# COPYRIGHT (C) DATABANK LLC since 2017 #
# #
# ALL RIGHTS RESERVED BY DATABANK LLC. THIS PROGRAM MUST BE #
# USED SOLELY FOR THE PURPOSES OF DATABANK LLC AND ITS USERS. #
# NO PART OF THIS PROGRAM MAY BE MODIFIED IN SOURCE OR BINARY FORM BY OTHERS #
# WITHOUT THE PRIOR WRITTEN PERMISSION OF DATABANK LLC. #
# #
# USE OF COPYRIGHT NOTICE DOES NOT EVIDENCE PUBLICATION OF THE PROGRAM. #
# #
#################################################################################
*/