# isw-mobile-payment-sdk-react > This library aids in processing payment through the following channels - [x] Card - [x] Verve Wallet - [x] QR Code - [X] USSD Latest version **1.0.9** (published 2021-11-30) · MIT license · 0 weekly downloads ## Install ```sh npm install isw-mobile-payment-sdk-react pnpm add isw-mobile-payment-sdk-react yarn add isw-mobile-payment-sdk-react bun add isw-mobile-payment-sdk-react ``` ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.0.9 | | Published | 2021-11-30 | | First published | 2021-08-27 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 0 | | Unpacked size | 1 MB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 1 | | Author | Ebi Igweze | | Maintainers | interswitchapi | | Keywords | react-native | ## Links - npm: https://www.npmjs.com/package/isw-mobile-payment-sdk-react - Repository: https://github.com/techquest/react-native-isw-mobile-sdk - Homepage: https://github.com/techquest/react-native-isw-mobile-sdk#readme - Issues: https://github.com/techquest/react-native-isw-mobile-sdk/issues - npm.io page: https://npm.io/package/isw-mobile-payment-sdk-react ## Recent versions - 1.0.9 (latest) — 2021-11-30 - 1.0.8 — 2021-11-30 - 1.0.6 — 2021-08-27 - 1.0.5 — 2021-08-27 - 1.0.4 — 2021-08-27 ## README # react-native-isw-mobile-sdk This library aids in processing payment through the following channels - [x] Card - [x] Verve Wallet - [x] QR Code - [X] USSD ## Getting started There are three steps you would have to complete to set up the SDK and perform transaction - Install the SDK as a dependency - Configure the SDK with Merchant Information - Initiate payment with customer details ### Installation `$ npm install react-native-isw-mobile-sdk --save` ### Mostly automatic installation `$ react-native link react-native-isw-mobile-sdk` ### Manual installation #### iOS 1. In XCode, in the project navigator, right click `Libraries` ➜ `Add Files to [your project's name]` 2. Go to `node_modules` ➜ `react-native-isw-mobile-sdk` and add `IswMobileSdk.xcodeproj` 3. In XCode, in the project navigator, select your project. Add `libIswMobileSdk.a` to your project's `Build Phases` ➜ `Link Binary With Libraries` 4. Run your project (`Cmd+R`)< #### Android 1. Open up `android/app/src/main/java/[...]/MainApplication.java` - Add `import com.interswitchng.IswMobileSdkPackage;` to the imports at the top of the file - Add `new IswMobileSdkPackage()` to the list returned by the `getPackages()` method 2. Append the following lines to `android/settings.gradle`: ``` include ':react-native-isw-mobile-sdk' project(':react-native-isw-mobile-sdk').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-isw-mobile-sdk/android') ``` 3. Insert the following lines inside the dependencies block in `android/app/build.gradle`: ``` compile project(':react-native-isw-mobile-sdk') ``` 4. Add the following to you `android/build.gralde` repositories block ``` maven { url "http://dl.bintray.com/techquest/maven-repo" } ``` ### Configuration You would also need to configure the project with your merchant credentials. ```javascript import IswMobileSdk, { IswPaymentInfo, Environment, IswSdkConfig } from 'react-native-isw-mobile-sdk'; // get your credentials const merchantId = "your-merchant-id", merchantCode = "your-merchant-code", merchantSecret = "your-merchant-seceret", currencyCode = "currency-code"; // e.g. 566 // create configuration for payment // using the credentials const config = new IswSdkConfig( merchantId, merchantSecret, merchantCode, currencyCode ) /** * callback function for initialized sdk * @param isSuccessful boolean flag indicating the result of initializing sdk */ const onSdkInitialized = (isSuccessful) => { // handle result } // initialize the sdk at the start of application // you can point to a specific environment -> TEST || PRODUCTION const env = Environment.TEST; IswMobileSdk.initialize(config, env, onSdkInitialized); ``` Once the SDK has been initialized, you can then perform transactions. #### Performing Transactions You can perform a transaction, once the SDK is configured, by providing the payment info and payment callbacks, like so: ```javascript let triggerPayment = (amount) => { // amount expressed in lowest // denomination (e.g. kobo): "N500.00" -> 50000 amount = amount * 100 const customerId = "", customerName = "", customerEmail = "", customerMobile = "", // generate a unique random // reference for each transaction reference = "";; // create payment information object const paymentInfo = new IswPaymentInfo( customerId, customerName, customerEmail, customerMobile, reference, amount, ) // trigger payment with the payment information IswMobileSdk.pay(paymentInfo, userDidComplete, userDidCancel); } ``` #### Handling Result To handle result all you need to do is process the result in the callback methods: whenever the user cancels, `userDidCancel` is called, and when the transaction is complete, `userDidComplete` is called with the result: an object like below is passed to the callback function. | Field | Type | meaning | |-----------------------|---------------|----------| | responseCode | String | txn response code | | responseDescription | String | txn response code description | | isSuccessful | boolean | flag indicates if txn is successful | | transactionReference | String | reference for txn | | amount | Number | txn amount | | channel | String| channel used to make payment: one of `CARD`, `WALLET`, `QR`, `USSD` | ```javascript let userDidComplete = (result) => { // process result } let userDidCancel = () => { // handle cancellation } ```` And that is it you can start processing payment in your react-native app. ## Note The Android Platform might have build exceptions, showing dexing issues, and you would need to enable [Multidexing](https://developer.android.com/studio/build/multidex) to build successfully. You can take a look at the `Application` class in the android project, for reference. --- _Source: https://npm.io/package/isw-mobile-payment-sdk-react · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._