React-eyowo NPM

React Eyowo

React integration for Eyowo.

Getting started

Documentation

Example

First, install React Eyowo

npm install react-eyowo --save

or with yarn

yarn add react-eyowo

Usage

import React from 'react';
import { useEyowoPayment, generateBill } from 'react-eyowo';

const App = () => {
	const [billLoading, setLoading] = React.useState('');
	const [billId, setBillId] = React.useState('');
	React.useEffect(() => {
		(async function () {
			setLoading(true);
			try {
				// Returns a bill with an _id required for payment
				const bill = await generateBill('DTGFJ5N-QS84G18-NKWV9PJ-65T9Y9S', 1000);
				setBillId(bill?._id);
			} catch (e) {
				console.log(e);
			}
			setLoading(false);
		})();
	}, []);
	const [loading, makePayment, verificationStatus] = useEyowoPayment({
		billId: billId,
		email: 'joshuaoluikpe@gmail.com',
		eyowoToken: 'DTGFJ5N-QS84G18-NKWV9PJ-65T9Y9S',
		_callback: function () {
			console.log('hi');
		},
		onClose: function () {
			console.log('ooooooooo');
		},
	});

	return billLoading ? 'Generating bill.....' : <button onClick={() => makePayment()}>Pay</button>;
};

export default App;

Variables

These are varaibles to pass to the hooks function

Name	Type	Description
`billId`	`String`	Required. This a mongo id used for the payment.
`email`	`String`	Required. The customer's email.
`eyowoToken`	`String`	Required. This is your API token.It can be found in your dashboard
`_callback`	`Function`	This is trigged after a successful payment.
`onClose`	`Function`	This is trigged when the pop up modal is closed.
`verifyPayment`	`Boolean`	The default is true. It verifies payment in the callback function after successful transaction.

Return Values

These are destructed values returned from the hooks function

Name	Type	Description
`makePayment`	`Function`	It triggers the pop up modal.
`loading`	`Boolean`	Loading state while verifying payment.
`verificationStatus`	`Object`	This returns paymentVerificationStatus('approved' or 'failed') and paymentVerificationErrorMessage(error message if status is failed)