Getting started

First, you need to clone the repo and install dependencies:

$ yarn add react-native-mpos-native
$ npx react-native link react-native-mpos-native

Android setup

You must confirm that ./android/build.gradle has the following configuration:

allProjects {
  repositories {
	  // ...
	  maven {
	    url "https://dl.bintray.com/vivareal/maven"
	  }
	  flatDir {
	    dirs "$rootDir/../node_modules/react-native-mpos-native/android/libs"
	  }
  }
}

Then inside of ./android/app/build.gradle add:

dependencies {
  // ...
  implementation 'br.com.vivareal:cuid-android:0.1.0'
}

Then inside of ./android/app/src/main/AndroidManifest.xml add:

xmlns:tools="http://schemas.android.com/tools" tools:replace="android:allowBackup"

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools"
  package="com.package">

	<application 
	  ...
      android:allowBackup="false"
      tools:replace="android:allowBackup"
	>
	</application>
</manifest>

Then inside of ./android/app create a folder libs if not exists. Copy files: mpos-android.native.jar and mpos-android.aar from /appFolder/node_modules/react-native-mpos-native/android/libs/ If you trying to run a SDK version builded by yourself, you should copy mpos-android.native.jar and mpos-android.aar to /appFolder/node_modules/react-native-mpos-native/android/libs/

Rebuild project

iOS

1. Required iOS 10.3 or later.

2. Install Pods.

$ cd ios/
$ pod install

3. Open your iOS project workspace on XCode.

4. Add MposSDK.framework and Result.framework in Frameworks, Libraries, and Embedded Content. Use the node_modules reference ./node_modules/react-native-mpos-native/ios/libs to drag to the project.

5. Add "$(SRCROOT)/../node_modules/react-native-mpos-native/ios/libs" in Build Settings > Framework Search Paths.

6. Set Enable Bitcode to No.

Basic Usage

Pinpad/Mpos

mpos.addListeners({
  // iOS will most probably start from `receiveInitialization` once `openConnection` is
  // called.
  //
  // The implementation of this listener is only required for Android.
  bluetoothConnected: () => {
    setTransactionStatus('Bluetooth connected, initializing pinpad...');
    mpos.initialize();
  },
  bluetoothDisconnected: () => {
    setTransactionStatus('Lost bluetooth connection...');
  },
  bluetoothErrored: (error) => {
    setTransactionStatus(`An error occurred: ${error}`);
  },
  // This function is called once the pinpad is connected and ready to start
  // receiving messages.
  receiveInitialization: () => {
    // Check for emv table updates.
    //
    // If you want to force a table update, without even
    // checking if it's necessary, simply change this flag to `true`.
    mpos.downloadEmvTablesToDevice(false);

    setTransactionStatus('Checking for emv table updates...');
    mpos.displayText('CHECKING UPDATES');
  },
  // Called everytime the pinpad sends a notification back to the app.
  receiveNotification: (notification) => {
    console.log(`[${selectedDevice.name}] Sent notification: `, notification);
  },
  // Called as result of `downloadEmvTablesToDevice` once there's a confirmation
  // that the emv tables inside the pinpad are up to date or have been reloaded.
  receiveTableUpdated: () => {
    setTransactionStatus('Emv tables are up to date. Insert credit card...');

    const method = mpos.PaymentMethod.CreditCard; // Another possibility is `DebitCard`.
    mpos.payAmount(amount, method);
  },
  // Called once a card hash has been generated. Here's where a transaction
  // must be created at pagar.me's API.
  receiveCardHash: async (result) => {
    mpos.displayText('PROCESSING...');
    setTransactionStatus('Received card hash. Creating transaction...');

    try {
      const transaction = await transactionService.createTransaction({
        amount,
        api_key: credentials.apiKey,
        card_hash: result.cardHash,
        local_time: new Date().toString(),
      });
      setLocalTransactionId(transaction.local_transaction_id);
      onTransactionSuccess(transaction, result.shouldFinishTransaction);
    } catch (error) {
      setTransactionError(error);
      onTransactionError(result.shouldFinishTransaction);
    }
  },
  // Called as result of `finishTransaction`.
  receiveFinishTransaction: () => {
    if (transactionError) {
      // This will just present an alert and close the pinpad.
      onTransactionError(false);
    } else {
      onTransactionSuccess(null, false);
    }
  },
  receiveError: async (error) => {
    //If received one of this contactless error, you should call mpos.payAmount again disabling contactless
    // const modelName = await mpos.getModelName()
    
    switch(error) {
      case abecsErrors.ST_CTLSCOMMERR:
      case abecsErrors.ST_CTLSIFCHG:
        mpos.payAmount(amount, mpos.PaymentMethod.CreditCard, true);
        break;
      case abecsErrors.ST_TABVERDIF:
        mpos.displayText('UPDATE TABLE IS NECESSARY');
        await sleep(2000);
        mpos.downloadEmvTablesToDevice(true);
        break;
      case abecsErrors.ST_CTLSMULTIPLE:
        mpos.displayText('PRESENT ONE CARD ONLY');
        await sleep(2000);
        mpos.payAmount(amount, mpos.PaymentMethod.CreditCard);
        break;
      case abecsErrors.ST_CTLSINVALIDAT:
        mpos.close('BLOCKED CARD');
        break;
      case abecsErrors.ST_CTLSEXTCVM:
        mpos.payAmount(amount, mpos.PaymentMethod.CreditCard);
        break;
      case abecsErrors.ST_CTLSPROBLEMS:
        mpos.close('CARD NOT SUPPORTED');
        break;
      case abecsErrors.ST_CTLSAPPNAV:
        mpos.close('NO APPLICATION');
        break;
      case abecsErrors.ST_CARDINVALIDAT:
        mpos.close('INVALID CARD');
        break;
      case abecsErrors.ST_DUMBCARD:
      case abecsErrors.ST_ERRCARD:
      case abecsErrors.ST_CARDAPPNAUT:
        const modelName = await mpos.getModelName();
        if (modelName === 'D180') {
          mpos.displayText('CHIP ERROR. USE MAGSTRIPE');
          await sleep(2000);
          mpos.payAmount(amount, mpos.PaymentMethod.CreditCard);
        } else {
          mpos.close('CHIP CANNOT BE READ');
        }
        break;
      case -3:
        mpos.close('TRANSACTION DENIED GOC');
        break;
      case -4:
        await refundTransaction();
        mpos.close('TRANSACTION DENIED FNC');
        break;
      case -5:
        mpos.displayText('USE CHIP');
        mpos.payAmount(amount, mpos.PaymentMethod.CreditCard);
        break;
      case 1006:
        mpos.close('Allowable PIN tries exceeded');
        break;
      case 1017:
        mpos.close('INCORRECT PIN');
        break;
      case 1023:
        mpos.payAmount(amount, mpos.PaymentMethod.CreditCard, true);
        break;
      case 9111:
        mpos.close('TRANSACTION TIME OUT');
        await refundTransaction();
        break;
      default:
        setTransactionStatus(null);
        Alert.alert('Error', `An error occurred:\n${JSON.stringify(error)}`);
        const errorCode = Platform.OS === 'ios' ? error.code : error;
        mpos.close(`ERROR: ${errorCode}`);
        break;
    }
  },
  receiveClose: () => {
    // Close bluetooth connection
    mpos.closeConnection();
    // Dispose resources and invalidate callbacks after finishing a transaction.
    mpos.dispose();
  },
  // Those are kind of optional listeners.
  receiveOperationCancelled: () => null,
  receiveOperationCompleted: () => null,
});

Functions

// Create a new instance Mpos. Required pass the paired device selected
mpos.createMpos(selectedDevice, credentials.encryptionKey);

// Starts the payment workflow.
mpos.openConnection(true);

// Clear all listeners
mpos.dispose();

// Show Message on the pinpad/mpos
mpos.displayText('Message');

// Return pinpad/mpos model name
mpos.getModelName();

// Initialize payment flow, receives a third optinal parameter that disables contactless when is true, by default is false. The contactless should be disabled when receive a contactless error, as explained above on receiveError function.
mpos.payAmount(amount, paymentMethod, disabledCtls = false);

// Close payment flow
mpos.close('Message');

// Avaiable listeners
mpos.addListeners({
  // iOS will most probably start from `receiveInitialization` once `openConnection` is
  // called.
  //
  // The implementation of this listener is only required for Android.
  bluetoothConnected: () => {},

  bluetoothDisconnected: () => {},

  bluetoothErrored: (error) => {},

  // This function is called once the pinpad is connected and ready to start
  // receiving messages.
  receiveInitialization: () => {},

  // Called everytime the pinpad sends a notification back to the app.
  receiveNotification: (notification) => {},

  // Called as result of `downloadEmvTablesToDevice` once there's a confirmation
  // that the emv tables inside the pinpad are up to date or have been reloaded.
  receiveTableUpdated: () => {},

  // Called once a card hash has been generated. Here's where a transaction
  // must be created at pagar.me's API.
  receiveCardHash: (result) => {},

  // Called as result of `finishTransaction`.
  receiveFinishTransaction: () => {},

  receiveError: (error) => {},

  receiveClose: () => {},

  // Those are kind of optional listeners.
  receiveOperationCancelled: () => null,

  receiveOperationCompleted: () => null,
});

The simplest usage was 'quite' documented on example ./src/screens/DeviceDetails.

Bluetooth

The simplest usage was 'quite' documented on ./src/screens/BluetoothDevices.

Example

To run the example:

$ yarn

Then you need to start react-native

$ npx react-native start

On Linux, if you have the error:

React Native Error: ENOSPC: System limit for number of file watchers reached

You should modify the number of system monitoring files:

$ sudo gedit /etc/sysctl.conf

Add a line at the bottom

fs.inotify.max_user_watches=524288

Then save and exit!

Android

$ yarn run android

iOS

$ cd ios/
$ pod install
$ cd ..
$ yarn run ios