@zezosoft/react-native-zezopay

ZezoPay React Native SDK – Seamlessly integrate secure payments for subscriptions, digital products, or one-time purchases in your React Native app. ZezoPay provides a smooth checkout experience, manages payment flows, and returns results via callbacks.

Currently supports Razorpay, with more payment providers coming soon.

🚀 Installation

npm install @zezosoft/react-native-zezopay
# or
yarn add @zezosoft/react-native-zezopay

📦 Quick Start Example

import React from 'react';
import { View, Alert } from 'react-native';
import { ZezoPay } from '@zezosoft/react-native-zezopay';

export default function App() {
  const handleSuccess = (data) => {
    console.log('Payment Successful:', data);

    const won = Math.random() < 0.3; // 30% chance lottery
    if (won) Alert.alert('🎉 Congratulations!', 'You won a prize!');
  };

  return (
    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
      <ZezoPay
        publicKey="YOUR_PUBLIC_KEY"
        title="Checkout"
        onBack={() => console.log('Back pressed')}
        summaryItems={[
          {
            id: 'pro',
            name: 'Pro Plan',
            price: 200,
            discount: { type: 'fixed', amount: 20 },
            duration: '3 months',
          },
        ]}
        userInfo={{
          _id: '123',
          name: 'John Doe',
          email: '[email protected]',
          phone: '9876543210',
        }}
        callbacks={{ onSuccess: handleSuccess }}
      />
    </View>
  );
}

📝 ZezoPay Component Props

| Prop | Required | Description | | ------------------ | -------- | ----------------------------------------------------------------------------- | | publicKey | ✅ | ZezoPay public key for authentication. | | subscriptionId | ❌ | Optional subscription plan ID. | | digitalProductId | ❌ | Optional digital product ID for one-time purchases. | | summaryItems | ✅ | Array of items for checkout summary, including price, discount, and duration. | | userInfo | ✅ | Customer information (_id, name, email, phone). | | title | ✅ | Checkout screen title. | | onBack | ✅ | Callback triggered when the back button is pressed. | | callbacks | ❌ | Object containing onSuccess and onFailure callbacks. |

🔄 Callbacks (callbacks prop)

| Callbacks | Description | | ----------- | -------------------------------------------------------------- | | onSuccess | Triggered after a successful payment. Returns payment details. | | onFailure | Triggered if payment fails or is canceled. Returns error info. |

👤 Summary Items & User Info

Example Summary Item:

summaryItems = [
  {
    id: 'pro',
    name: 'Pro Plan',
    price: 200,
    discount: { type: 'fixed', amount: 20 }, // or { type: 'percentage', amount: 10 }
    duration: '3 months',
  },
];

Example User Info:

userInfo = {
  _id: '123',
  name: 'John Doe',
  email: '[email protected]',
  phone: '9876543210',
};

💳 Supported Payment Providers

Available now:

'razorpay'

Coming soon:

'stripe' | 'ccavenue' | 'phonepe'

👨‍💻 Contributors

📜 License

Released under the MIT License