Fundbox Checkout SDK for React Native

A React Native SDK that provides seamless integration with Fundbox's checkout process. This SDK allows you to easily implement Fundbox's payment processing in your React Native applications.

Installation

yarn add react-native-fundbox-checkout-sdk

or

npm install react-native-fundbox-checkout-sdk

Prerequisites

• React Native 0.76.7 or higher
• React 18.3.1 or higher
• Expo dependencies (expo-linking, expo-web-browser)

Usage

import { FundboxCheckout } from 'react-native-fundbox-checkout-sdk';

// Example usage
const handleCheckout = async () => {
  try {
    const result = await FundboxCheckout({
      fbx_transaction_token: 'token',
    });

    if (result.result === 'success') {
      // Payment successful
      console.log('Payment successful with key:');
    } else if (result.result === 'canceled') {
      // Payment was canceled by user
      console.log('Payment was canceled');
    } else {
      // An error occurred
      console.log('Payment failed');
    }
  } catch (error) {
    console.error('Error during checkout:', error);
  }
};

API Reference

FundboxCheckout

The main function to initiate the checkout process.

Parameters

| Parameter | Type | Required | Description | | --------------------- | ------ | -------- | --------------------- | | fbx_transaction_token | string | Yes | The transaction token |

Return Value

Returns a Promise that resolves to a TResultType object with the following structure:

type TResultType = {
  result: 'success' | 'canceled' | 'declined';
};

Error Handling

The SDK handles various scenarios and returns appropriate results:

• success: Payment was successful, includes the payment key
• canceled: User canceled the payment process
• decline: The payment is declined

Contributing

We welcome contributions! Please see our Contributing Guidelines for more information.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support, please open an issue in the GitHub repository.

Made with create-react-native-library