@netappsng/react-native-pay 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 lawrence
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Netappspay.podspec

@@ -0,0 +1,22 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "Netappspay"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => "15.1" }
+  s.source       = { :git => "https://gitlab.com/talktothelaw/react-native-netapps-pay.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+  s.dependency "NetAppsPaySDK"
+
+  install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,190 @@
+# @netappsng/react-native-pay
+
+NetAppsPay React Native SDK — accept card, bank transfer, USSD, and PayAttitude payments in your React Native app. Supports **iOS** and **Android**.
+
+## Installation
+
+```sh
+npm install @netappsng/react-native-pay
+# or
+yarn add @netappsng/react-native-pay
+```
+
+### iOS
+
+```sh
+cd ios && pod install
+```
+
+The SDK uses the native [NetAppsPaySDK](https://gitlab.com/netapps-sdk/netappspay-sdk-ios) Swift package, which is linked automatically via CocoaPods.
+
+### Android
+
+The Android SDK is pulled from Maven Central automatically — no extra setup needed.
+
+Make sure your project's `android/build.gradle` includes `mavenCentral()` in repositories (this is the default for new React Native projects).
+
+## Usage
+
+```tsx
+import { presentPayment } from '@netappsng/react-native-pay';
+import type { PaymentConfig } from '@netappsng/react-native-pay';
+
+function handlePayment() {
+  const amountNaira = 100;
+  const amountKobo = Math.round(amountNaira * 100);
+
+  const config: PaymentConfig = {
+    publicKey: 'pk_live_xxxxxxxxxxxxxxxxxxxx',
+    amount: amountKobo, // ₦100.00 = 10000 kobo
+    currency: 'NGN',
+    email: 'john@example.com',
+    fullName: 'John Doe',
+    phoneNumber: '08106720418',
+    narration: 'Dev Test Payment',
+    paymentChannels: ['card', 'transfer', 'ussd', 'payattitude', 'moniflow'],
+    defaultChannel: 'card',
+    address1: 'Customer Address',
+    metadata: { inputAmount: amountNaira, env: 'development' },
+    businessName: 'Demo Store',
+    showTransactionSummary: true,
+  };
+
+  const cleanup = presentPayment(config, {
+    onSuccess: (payload) => {
+      console.log('Payment successful!', payload.transactionRef);
+      // payload: { status, merchantRef, transactionRef, amount, currency, channel, message, timestamp }
+    },
+    onFailed: (payload) => {
+      console.log('Payment failed:', payload.message);
+      // payload: { status, amount, currency, message, timestamp, errorCode? }
+    },
+    onCancel: () => {
+      console.log('Payment cancelled');
+    },
+    onReady: () => {
+      console.log('Payment UI ready');
+    },
+  });
+
+  // Call cleanup() to remove event listeners when unmounting
+  // e.g. in useEffect: return cleanup;
+}
+```
+
+### With React Hook
+
+```tsx
+import React, { useCallback, useRef } from 'react';
+import { Button } from 'react-native';
+import { presentPayment } from '@netappsng/react-native-pay';
+import type { PaymentConfig } from '@netappsng/react-native-pay';
+
+export default function CheckoutScreen() {
+  const cleanupRef = useRef<(() => void) | null>(null);
+
+  const pay = useCallback(() => {
+    cleanupRef.current?.();
+
+    const config: PaymentConfig = {
+      publicKey: 'pk_live_xxxxxxxxxxxxxxxxxxxx',
+      amount: 10000, // ₦100.00
+      currency: 'NGN',
+      email: 'john@example.com',
+      fullName: 'John Doe',
+      phoneNumber: '08106720418',
+      narration: 'Dev Test Payment',
+      paymentChannels: ['card', 'transfer', 'ussd', 'payattitude', 'moniflow'],
+      defaultChannel: 'card',
+      address1: 'Customer Address',
+      metadata: { env: 'development' },
+      businessName: 'Demo Store',
+      showTransactionSummary: true,
+    };
+
+    cleanupRef.current = presentPayment(config, {
+      onSuccess: (payload) => {
+        console.log('Ref:', payload.transactionRef);
+        cleanupRef.current?.();
+      },
+      onFailed: (payload) => {
+        alert(payload.message);
+        cleanupRef.current?.();
+      },
+      onCancel: () => {
+        console.log('Cancelled');
+        cleanupRef.current?.();
+      },
+    });
+  }, []);
+
+  return <Button title="Pay ₦100" onPress={pay} />;
+}
+```
+
+## Configuration
+
+### Required Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `publicKey` | `string` | Your NetAppsPay public key |
+| `amount` | `number` | Amount in minor units (kobo/cents). ₦15.00 = `1500` |
+| `currency` | `'NGN' \| 'USD'` | Payment currency |
+| `email` | `string` | Customer email |
+| `fullName` | `string` | Customer full name |
+| `narration` | `string` | Payment description |
+| `paymentChannels` | `PaymentChannel[]` | Channels to display |
+| `defaultChannel` | `PaymentChannel` | Initially selected channel |
+
+### Optional Fields
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `phoneNumber` | `string` | — | Customer phone number |
+| `transactionRef` | `string` | auto-generated | Custom transaction reference |
+| `address1` | `string` | `'Customer Address'` | Customer address line 1 |
+| `address2` | `string` | — | Customer address line 2 |
+| `city` | `string` | `'Lagos'` | Customer city |
+| `postalCode` | `string` | — | Customer postal code |
+| `locality` | `string` | — | Country code (e.g. `'NG'`) |
+| `administrativeArea` | `string` | — | State/province (e.g. `'Lagos'`) |
+| `chargeAllocation` | `'CUSTOMER' \| 'MERCHANT'` | `'CUSTOMER'` | Who bears the transaction charge |
+| `businessName` | `string` | — | Merchant display name |
+| `logoURL` | `string` | — | Merchant logo URL |
+| `productName` | `string` | — | Product name |
+| `metadata` | `Record<string, any>` | — | Custom key-value metadata |
+| `cardHolderName` | `string` | — | Pre-filled cardholder name |
+| `customerId` | `string` | — | Your internal customer ID |
+| `enableSaveCard` | `boolean` | `false` | Allow saving cards for future payments |
+| `showTransactionSummary` | `boolean` | `true` | Show transaction summary |
+
+### Payment Channels
+
+| Channel | Description |
+|---------|-------------|
+| `'card'` | Card payment (Visa, Mastercard, Verve) |
+| `'transfer'` | Bank transfer |
+| `'ussd'` | USSD payment |
+| `'payattitude'` | PayAttitude (USSD push) |
+| `'moniflow'` | MoniFlow marketplace |
+
+### Callbacks
+
+| Callback | Payload | Description |
+|----------|---------|-------------|
+| `onSuccess` | `PaymentSuccessPayload` | Payment completed successfully |
+| `onFailed` | `PaymentFailedPayload` | Payment failed |
+| `onCancel` | — | User dismissed the payment sheet |
+| `onReady` | — | Payment sheet is fully loaded |
+
+## Native SDKs
+
+This package bridges the native NetAppsPay SDKs:
+
+- **iOS**: [NetAppsPaySDK](https://github.com/nicenapp/NetAppsPaySDK) (Swift Package)
+- **Android**: `ng.netapps:netappspay:1.0.0` (Maven Central)
+
+## License
+
+MIT

package/android/build.gradle

@@ -0,0 +1,68 @@
+buildscript {
+  ext.Netappspay = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36,
+    targetSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return Netappspay[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.netappspay"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "ng.netapps:netappspay:1.0.0"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/netappspay/NetappspayModule.kt

@@ -0,0 +1,170 @@
+package com.netappspay
+
+import android.app.Activity
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import com.netappspay.sdk.PaymentSDK
+import com.netappspay.sdk.models.*
+
+class NetappspayModule(reactContext: ReactApplicationContext) :
+  NativeNetappspaySpec(reactContext) {
+
+  private var listenerCount = 0
+
+  companion object {
+    const val NAME = NativeNetappspaySpec.NAME
+  }
+
+  override fun present(config: ReadableMap) {
+    val activity = currentActivity ?: run {
+      sendEvent("onPaymentFailed", mapOf(
+        "status" to "failed",
+        "message" to "Unable to find current activity"
+      ))
+      return
+    }
+
+    val map = config.toHashMap()
+
+    // Required fields
+    val publicKey = map["publicKey"] as? String ?: ""
+    val amountNum = map["amount"] as? Double ?: 0.0
+    val amount = amountNum.toInt()
+    val currencyStr = (map["currency"] as? String ?: "NGN").uppercase()
+    val email = map["email"] as? String ?: ""
+    val fullName = map["fullName"] as? String ?: ""
+    val narration = map["narration"] as? String ?: ""
+
+    if (publicKey.isEmpty() || email.isEmpty() || fullName.isEmpty() || narration.isEmpty() || amount <= 0) {
+      sendEvent("onPaymentFailed", mapOf(
+        "status" to "failed",
+        "message" to "Missing required config fields (publicKey, amount, email, fullName, narration)"
+      ))
+      return
+    }
+
+    val currency = if (currencyStr == "USD") Currency.USD else Currency.NGN
+
+    // Payment channels
+    val channelStrings = (map["paymentChannels"] as? List<*>)?.mapNotNull { it as? String } ?: listOf("card")
+    val channels = channelStrings.mapNotNull { mapChannel(it) }.ifEmpty { listOf(PaymentChannel.CARD) }
+
+    // Default channel
+    val defaultChannelStr = map["defaultChannel"] as? String
+    val defaultChannel = if (defaultChannelStr != null) mapChannel(defaultChannelStr) ?: channels.first() else channels.first()
+
+    // Metadata
+    @Suppress("UNCHECKED_CAST")
+    val metadata = (map["metadata"] as? Map<String, Any>) ?: emptyMap()
+
+    // Build config
+    val address1Raw = (map["address1"] as? String)?.trim() ?: ""
+    val cityRaw = (map["city"] as? String)?.trim() ?: ""
+
+    val paymentConfig = PaymentConfig(
+      publicKey = publicKey,
+      amount = amount,
+      currency = currency,
+      email = email,
+      fullName = fullName,
+      phoneNumber = (map["phoneNumber"] as? String) ?: "",
+      narration = narration,
+      paymentChannels = channels,
+      defaultChannel = defaultChannel,
+      metadata = metadata,
+      address1 = address1Raw.ifEmpty { "Customer Address" },
+      address2 = (map["address2"] as? String) ?: "",
+      city = cityRaw.ifEmpty { "Lagos" }
+    ).apply {
+      (map["transactionRef"] as? String)?.let { transactionRef = it }
+      (map["businessName"] as? String)?.let { businessName = it }
+      (map["logoURL"] as? String)?.let { logoURL = it }
+      (map["productName"] as? String)?.let { productName = it }
+      (map["cardHolderName"] as? String)?.let { cardHolderName = it }
+      (map["customerId"] as? String)?.let { customerId = it }
+      (map["postalCode"] as? String)?.let { postalCode = it }
+      (map["locality"] as? String)?.let { locality = it }
+      (map["administrativeArea"] as? String)?.let { administrativeArea = it }
+      (map["enableSaveCard"] as? Boolean)?.let { enableSaveCard = it }
+      (map["showTransactionSummary"] as? Boolean)?.let { showTransactionSummary = it }
+      (map["isTest"] as? Boolean)?.let { isTest = it }
+      (map["debugMode"] as? Boolean)?.let {
+        debugMode = it
+        PaymentSDK.debugMode = it
+      }
+      (map["chargeAllocation"] as? String)?.let {
+        chargeAllocation = if (it.uppercase() == "MERCHANT") ChargeAllocation.MERCHANT else ChargeAllocation.CUSTOMER
+      }
+    }
+
+    val listener = object : PaymentSDK.PaymentSDKListener {
+      override fun onSuccess(payload: PaymentSuccessPayload) {
+        sendEvent("onPaymentSuccess", mapOf(
+          "status" to payload.status,
+          "merchantRef" to payload.merchantRef,
+          "transactionRef" to payload.transactionRef,
+          "amount" to payload.amount,
+          "currency" to payload.currency.code,
+          "channel" to payload.channel.code,
+          "message" to payload.message,
+          "timestamp" to payload.timestamp
+        ))
+      }
+
+      override fun onFailed(payload: PaymentFailedPayload) {
+        val body = mutableMapOf<String, Any>(
+          "status" to payload.status,
+          "amount" to payload.amount,
+          "currency" to payload.currency.code,
+          "message" to payload.message,
+          "timestamp" to payload.timestamp
+        )
+        payload.merchantRef?.let { body["merchantRef"] = it }
+        payload.transactionRef?.let { body["transactionRef"] = it }
+        payload.channel?.let { body["channel"] = it.code }
+        payload.errorCode?.let { body["errorCode"] = it }
+        sendEvent("onPaymentFailed", body)
+      }
+
+      override fun onCancel() {
+        sendEvent("onPaymentCancel", emptyMap())
+      }
+
+      override fun onReady() {
+        sendEvent("onPaymentReady", emptyMap())
+      }
+    }
+
+    activity.runOnUiThread {
+      PaymentSDK.present(activity, paymentConfig, listener)
+    }
+  }
+
+  override fun addListener(eventType: String) {
+    listenerCount++
+  }
+
+  override fun removeListeners(count: Double) {
+    listenerCount -= count.toInt()
+    if (listenerCount < 0) listenerCount = 0
+  }
+
+  private fun sendEvent(eventName: String, body: Map<String, Any>) {
+    reactApplicationContext
+      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+      .emit(eventName, com.facebook.react.bridge.Arguments.makeNativeMap(body))
+  }
+
+  private fun mapChannel(str: String): PaymentChannel? {
+    return when (str.lowercase()) {
+      "card" -> PaymentChannel.CARD
+      "transfer", "bank_transfer" -> PaymentChannel.TRANSFER
+      "ussd", "ussd_code" -> PaymentChannel.USSD
+      "payattitude", "ussd_push", "pay_attitude" -> PaymentChannel.PAYATTITUDE
+      "moniflow", "netapps_marketplace", "marketplace" -> PaymentChannel.MONIFLOW
+      "tap_to_pay", "nfc" -> PaymentChannel.TAP_TO_PAY
+      else -> null
+    }
+  }
+}

package/android/src/main/java/com/netappspay/NetappspayPackage.kt

@@ -0,0 +1,31 @@
+package com.netappspay
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class NetappspayPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == NetappspayModule.NAME) {
+      NetappspayModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider() = ReactModuleInfoProvider {
+    mapOf(
+      NetappspayModule.NAME to ReactModuleInfo(
+        name = NetappspayModule.NAME,
+        className = NetappspayModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = true
+      )
+    )
+  }
+}

package/ios/Netappspay-Bridging-Header.h

@@ -0,0 +1,3 @@
+// This file is required so that the Swift compiler generates
+// the <ProductName>-Swift.h header, making Swift classes
+// visible to the Objective-C++ bridge (Netappspay.mm).

package/ios/Netappspay.h

@@ -0,0 +1,6 @@
+#import <NetappspaySpec/NetappspaySpec.h>
+#import <React/RCTEventEmitter.h>
+
+@interface Netappspay : RCTEventEmitter <NativeNetappspaySpec>
+
+@end

package/ios/Netappspay.mm

@@ -0,0 +1,67 @@
+#import "Netappspay.h"
+#import <React/RCTBridge.h>
+#import <React/RCTUtils.h>
+
+// Swift bridging — the actual implementation lives in NetappspayBridge.swift
+// This is auto-generated as <ProductName>-Swift.h by Xcode.
+#if __has_include("Netappspay-Swift.h")
+#import "Netappspay-Swift.h"
+#else
+#import <Netappspay/Netappspay-Swift.h>
+#endif
+
+@implementation Netappspay {
+    NetappspayBridge *_bridge;
+}
+
+RCT_EXPORT_MODULE()
+
+- (instancetype)init {
+    self = [super init];
+    if (self) {
+        _bridge = [[NetappspayBridge alloc] init];
+    }
+    return self;
+}
+
+- (NSArray<NSString *> *)supportedEvents {
+    return @[@"onPaymentSuccess", @"onPaymentFailed", @"onPaymentCancel", @"onPaymentReady"];
+}
+
+- (void)addListener:(NSString *)eventName {
+    [super addListener:eventName];
+}
+
+- (void)removeListeners:(double)count {
+    [super removeListeners:count];
+}
+
+- (void)present:(NSDictionary *)config {
+    __weak Netappspay *weakSelf = self;
+    [_bridge presentWithConfig:config
+        onSuccess:^(NSDictionary *payload) {
+            [weakSelf sendEventWithName:@"onPaymentSuccess" body:payload];
+        }
+        onFailed:^(NSDictionary *payload) {
+            [weakSelf sendEventWithName:@"onPaymentFailed" body:payload];
+        }
+        onCancel:^{
+            [weakSelf sendEventWithName:@"onPaymentCancel" body:@{}];
+        }
+        onReady:^{
+            [weakSelf sendEventWithName:@"onPaymentReady" body:@{}];
+        }
+    ];
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeNetappspaySpecJSI>(params);
+}
+
++ (BOOL)requiresMainQueueSetup {
+    return YES;
+}
+
+@end