@haroldtran/react-native-pax 0.1.7

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2023 santinello
+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/README.md

@@ -0,0 +1,311 @@
+# @haroldtran/react-native-pax
+
+[![npm version](https://badge.fury.io/js/%40haroldtran%2Freact-native-pax.svg)](https://badge.fury.io/js/%40haroldtran%2Freact-native-pax)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+React Native library to integrate with PAX payment devices using the POSLink SDK. This library provides a bridge between React Native applications and PAX payment terminals for processing various payment transactions.
+
+**Maintained and enhanced by [@phattran1201](https://github.com/phattran1201)**
+
+## Features
+
+- 🔄 Initialize PAX device connection
+- 💳 Process credit card payments (Sale, Auth, Post-Auth)
+- 🔄 Handle transaction adjustments and voids
+- 📊 Batch operations and settlement
+- 🔙 Process returns and refunds
+- 📱 Support for both iOS and Android platforms
+
+## Installation
+
+```sh
+npm install @haroldtran/react-native-pax
+```
+
+or with yarn:
+
+```sh
+yarn add @haroldtran/react-native-pax
+```
+
+### iOS Setup
+
+1. Navigate to your iOS project directory and install pods:
+```sh
+cd ios && pod install
+```
+
+2. Make sure your iOS deployment target is 11.0 or higher in your `Podfile`:
+```ruby
+platform :ios, '11.0'
+```
+
+### Android Setup
+
+The Android setup is automatic. The library will be linked automatically when you rebuild your project.
+
+## Usage
+
+### Import the library
+
+```js
+import {
+  initPOSLink,
+  makePayment,
+  makeAuth,
+  makePostAuth,
+  makeReturn,
+  makeAdjustment,
+  voidTransaction,
+  closeBatch
+} from '@haroldtran/react-native-pax';
+```
+
+### Initialize Connection
+
+First, initialize the connection to your PAX device:
+
+```js
+try {
+  const success = await initPOSLink(
+    'TCP',        // Connection type: 'UART', 'TCP', 'SSL', 'HTTP', 'HTTPS', 'BLUETOOTH', 'USB', 'AIDL'
+    '30000',      // Timeout in milliseconds
+    false,        // Use proxy
+    '192.168.1.100', // Device IP (for TCP/IP connections)
+    '10009'       // Port number
+  );
+
+  if (success) {
+    console.log('PAX device initialized successfully');
+  }
+} catch (error) {
+  console.error('Failed to initialize PAX device:', error);
+}
+```
+
+### Process a Payment
+
+```js
+try {
+  const result = await makePayment('10.00', '1.50'); // amount, tip
+  console.log('Payment result:', result);
+
+  // Result contains transaction details like:
+  // - AuthCode
+  // - RefNum
+  // - ApprovedAmount
+  // - CardType
+  // - MaskedPAN
+  // etc.
+} catch (error) {
+  console.error('Payment failed:', error);
+}
+```
+
+### Authorization Only
+
+```js
+try {
+  const result = await makeAuth('25.00');
+  console.log('Authorization result:', result);
+} catch (error) {
+  console.error('Authorization failed:', error);
+}
+```
+
+### Post Authorization (Capture)
+
+```js
+try {
+  const result = await makePostAuth(
+    '25.00',           // amount
+    'REF123456',       // original reference number
+    'AUTH123'          // authorization code
+  );
+  console.log('Post-auth result:', result);
+} catch (error) {
+  console.error('Post-auth failed:', error);
+}
+```
+
+### Process a Return
+
+```js
+try {
+  const result = await makeReturn('15.00');
+  console.log('Return result:', result);
+} catch (error) {
+  console.error('Return failed:', error);
+}
+```
+
+### Void a Transaction
+
+```js
+try {
+  const result = await voidTransaction(
+    'REF123456',       // original reference number
+    'AUTH123'          // authorization code
+  );
+  console.log('Void result:', result);
+} catch (error) {
+  console.error('Void failed:', error);
+}
+```
+
+### Adjust a Transaction
+
+```js
+try {
+  const result = await makeAdjustment(
+    '12.50',           // new amount
+    'REF123456'        // original reference number
+  );
+  console.log('Adjustment result:', result);
+} catch (error) {
+  console.error('Adjustment failed:', error);
+}
+```
+
+### Close Batch
+
+```js
+try {
+  const result = await closeBatch();
+  console.log('Batch close result:', result);
+
+  // Result contains batch summary:
+  // - BatchNum
+  // - CreditCount, CreditAmount
+  // - DebitCount, DebitAmount
+  // etc.
+} catch (error) {
+  console.error('Batch close failed:', error);
+}
+```
+
+## API Reference
+
+### initPOSLink(type, timeout, proxy, ip?, port?)
+
+Initializes the connection to the PAX device.
+
+**Parameters:**
+- `type` (string): Connection type - 'UART', 'TCP', 'SSL', 'HTTP', 'HTTPS', 'BLUETOOTH', 'USB', 'AIDL'
+- `timeout` (string): Timeout in milliseconds
+- `proxy` (boolean): Whether to use proxy
+- `ip` (string, optional): Device IP address (for network connections)
+- `port` (string, optional): Port number (for network connections)
+
+**Returns:** `Promise<boolean>`
+
+### makePayment(amount, tip?)
+
+Processes a sale transaction.
+
+**Parameters:**
+- `amount` (string): Transaction amount
+- `tip` (string, optional): Tip amount (default: "0")
+
+**Returns:** `Promise<PaymentResponse>`
+
+### makeAuth(amount)
+
+Processes an authorization-only transaction.
+
+**Parameters:**
+- `amount` (string): Authorization amount
+
+**Returns:** `Promise<PaymentResponse>`
+
+### makePostAuth(amount, refNum, authCode)
+
+Captures a previously authorized transaction.
+
+**Parameters:**
+- `amount` (string): Capture amount
+- `refNum` (string): Original reference number
+- `authCode` (string): Authorization code
+
+**Returns:** `Promise<PaymentResponse>`
+
+### makeReturn(amount)
+
+Processes a return transaction.
+
+**Parameters:**
+- `amount` (string): Return amount
+
+**Returns:** `Promise<PaymentResponse>`
+
+### makeAdjustment(amount, refNum)
+
+Adjusts a previous transaction amount.
+
+**Parameters:**
+- `amount` (string): New amount
+- `refNum` (string): Original reference number
+
+**Returns:** `Promise<PaymentResponse>`
+
+### voidTransaction(refNum, authCode)
+
+Voids a previous transaction.
+
+**Parameters:**
+- `refNum` (string): Original reference number
+- `authCode` (string): Authorization code
+
+**Returns:** `Promise<PaymentResponse>`
+
+### closeBatch()
+
+Closes the current batch and settles transactions.
+
+**Returns:** `Promise<BatchResponse>`
+
+## Response Objects
+
+### PaymentResponse
+
+Contains transaction details including:
+- `AuthCode`: Authorization code
+- `RefNum`: Reference number
+- `ApprovedAmount`: Approved amount
+- `CardType`: Type of card used
+- `MaskedPAN`: Masked card number
+- `ResultCode`: Transaction result code
+- `ResultTxt`: Result description
+- And many more fields...
+
+### BatchResponse
+
+Contains batch settlement details including:
+- `BatchNum`: Batch number
+- `CreditCount` / `CreditAmount`: Credit transaction totals
+- `DebitCount` / `DebitAmount`: Debit transaction totals
+- `ResultCode`: Batch result code
+- And more batch summary fields...
+
+## Requirements
+
+- React Native 0.63+
+- iOS 11.0+
+- Android API level 21+
+- PAX payment terminal with POSLink SDK support
+
+## Contributing
+
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
+
+## License
+
+MIT
+
+## Support
+
+For PAX device documentation and support, visit [PAX Developer Portal](https://developer.pax.us).
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/build.gradle

@@ -0,0 +1,82 @@
+buildscript {
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:7.2.1"
+  }
+}
+
+def isNewArchitectureEnabled() {
+  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
+}
+
+apply plugin: "com.android.library"
+
+
+def appProject = rootProject.allprojects.find { it.plugins.hasPlugin('com.android.application') }
+
+if (isNewArchitectureEnabled()) {
+  apply plugin: "com.facebook.react"
+}
+
+def getExtOrDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["PaxPoslink_" + name]
+}
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["PaxPoslink_" + name]).toInteger()
+}
+
+android {
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+  }
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+
+dependencies {
+  // For < 0.71, this will be from the local maven repo
+  // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
+  //noinspection GradleDynamicVersion
+  implementation "com.facebook.react:react-native:+"
+
+  //! https://developer.pax.us/resources/section/250038301709316096?sectionName=POSLink%202&articleId=352771637260593152
+  //! POSLink_Core_Android_V2.00.07_20240914
+  //! https://developer.pax.us/api/v1/files/314390436447793152/download/private#POSLink_Semi_Integration_Java_Android_V2.01.00_20240914.zip
+  implementation files('libs/POSLink_Core.jar')
+}
+
+if (isNewArchitectureEnabled()) {
+  react {
+    jsRootDir = file("../src/")
+    libraryName = "PaxPoslink"
+    codegenJavaPackageName = "com.paxposlink"
+  }
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+PaxPoslink_kotlinVersion=1.7.0
+PaxPoslink_minSdkVersion=21
+PaxPoslink_targetSdkVersion=31
+PaxPoslink_compileSdkVersion=31
+PaxPoslink_ndkversion=21.4.7075529

package/android/src/main/AndroidManifest.xml

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