react-native-masterpass-kit

Getting started

$ yarn add react-native-masterpass-kit

iOS setup

Copy framework

You need to copy corresponding MasterPassKit.framework to node_modules/react-native-masterpass-kit/ios/Frameworks

Methods

1. checkout
   • code: string (required) This is the code created by calling the Masterpass API representing the transaction.
   • apiKey: string (required) This is the API key provided by Masterpass that will enable the library to be used. This can be found on the Masterpass Portal under the Lib Lite Tokens menu item.
   • system: 'test' | 'live' (required) Representing the Masterpass backend system to connect to.
   • preMsisdn: string (optional) This is an optional field if you know the client’s mobile number.
   • hash: string (optional) [Android only] This allows capability for the app to read the SMS for registration. Details on how to generate the HASH key can be String found here https://developers.google.com/identity/sms-retriever/verify#computing_your_apps_hash_string
2. preRegister
   • apiKey: string (required)
   • system: 'test' | 'live' (required)
   • preMsisdn: string (optional)
3. manageCardList
   • apiKey: string (required)
   • system: 'test' | 'live' (required)
   • preMsisdn: string (optional)

Events

1. registerUserDidCancelEvent Call when user aborted the process
2. registerPaymentSucceededEvent Call when payment success
   • transaction: string This is the reference for the transaction. This reference will be used to tie up the transaction on the 3rd party backend system
3. registerErrorEvent Call when an error has occurred before the payment
   • code: string Error code. Prefer below
   • location: number [Android only] This is the location of the error. This can be used to debug the error when requesting support from Oltio.
4. registerPaymentFailedEvent Call when the payment failed
   • transaction: string This is the reference for the failed transaction in the event the 3rd party needs to request more information regarding the failure
5. registerInvalidCodeEvent Call when the code param invalid
6. registerUserRegisterEvent Call when the user has registered with Masterpass
7. registerUserCompletedWalletEvent Call when user done with wallet

Error codes

- OTPError
- NetworkError
- ExceptionOccored
- PaymentError
- InvalidApiKeyParameter
- InvalidCodeParameter
- SecureCodeNotSupported
- Unknown

Usage

import RNMasterpassKit from 'react-native-masterpass-kit';

RNMasterpassKit.checkout({
    code: '6799782555',
    apiKey: '1234567890',
    system: 'test',
});

const subcription = RNMasterpassKit.registerUserDidCancelEvent(() => {
    console.warn('User cancelled');
});
// And later on
subcription.remove();