blessedyahaya/rave-reactnative-wrapper-1

Rave By Flutterwave React Native Web View Component

This is the react native SDK for Rave By Flutterwave. that utilizes webview in displaying the Rave modal

This SDK allows you plug-in Rave's payment gateway directly into your react native application and start accepting payment immediately, utilizing all avaliable payment methods, by setting the payment method you want from your Rave Dashboard

This package copies a similar loading design to that of Rave, which makes transistion to Rave's website less noticeable. This package also offers a cancel button, so one can easily cancel if Rave takes a long time to load its content (the onCancel props event is called when this happens).

Compatibility

@react-native-community/cli	react-native
^1.0.0	^0.59.0

Integrating Rave React Native

You can pull in react-native-rave-webview into app with the steps below;

• Change directory into your current project directory from your terminal and enter this command:

  npm install react-native-rave-webview --save

Usage

1. import Rave Component

import {Rave} from 'Rave-ReactNative-Wrapper';

2. Set your success, failure and close methods

constructor(props) {
    super(props);

  }

  onSuccess(data) {
    console.log("success", data);
    // You get the complete response returned that comes from Rave,
    

  }

  onCancel() {
    console.log("error", 'Transaction was Cancelled!');
  }

  onError() {
    //an error occoured

  }

3. Use component (ensure to set currency for the desired payment method to display)

 render() {
     return (
        <View  style={styles.container}>
          <Rave
            buttonText=  "PAY NOW"
            raveKey="<your-api-key-here>"
            amount={20000}
            customerEmail={"[email protected]"}
            customerPhone={"08114089344"}
            billingEmail="[email protected] (optional)"
            billingMobile="08114089344 (optional)"
            billingName="Martins Joseph (optional but advised)"
            ActivityIndicatorColor="black"
            onCancel={this.onCancel}
            onSuccess={this.onSuccess}
            onError={() => { alert('something went wrong') }}
            btnStyles={{backgroundColor:'green', width:100, alignContent:  'center' }}
            textStyles={{ color:'white', alignSelf:  'center', }}
            txref="<your-autogenerated-transaction-reference>"
          />
        </View>
    );
   }

API's

all React-Native-rave-WebView API

Name	use/description	extra
buttonText	Defines text on the button	null
textStyles	Defines styles for text in button	null
btnStyles	Defines style for button	null
raveKey	Public or Private FlutterWave Rave key(visit https://rave.flutterwave.com to get yours)	null
amount	Amount to be paid	null
txref	set TransactionRef for transaction	null
ActivityIndicatorColor	color of loader	default: #f5a623
customerEmail	Customer's email	default: null
customerPhone	Customer's Mobile	default: null
billingEmail	Billers email	default: null
billingMobile	Billers mobile	default: null
billingName	Billers Name	default: null
onCancel	callback function if user cancels, either while web view is loading or after loading	default: null
onSuccess	callback function if transaction was successful (it will return the entire response by Flutterwave's Rave )	default: null
onError	callback function if an error occured during transaction	default: null

Everyone is welcome to create a pull request with detailed description of what it fixes, and I would ensure to test and merge.

This project is licensed under ISC license.

Don't forget to star, like and share :)