esewa-react

A React library for integrating eSewa payment gateway into your React applications. This library handles hash signatures, base64 URL encoding, and provides a simple interface for initiating and verifying eSewa payments.

Installation

npm install esewa-react
# or
yarn add esewa-react

Quick Start

import { useEsewa } from 'esewa-react';

function PaymentButton() {
  const { initiatePayment, loading, error } = useEsewa({
    merchantId: 'YOUR_MERCHANT_ID',
    successUrl: 'https://your-domain.com/success',
    failureUrl: 'https://your-domain.com/failure',
    secretKey: 'YOUR_SECRET_KEY',
    isTest: true, // Set to false for production
  });

  const handlePayment = () => {
    initiatePayment({
      amount: '100',
      productId: 'TXN_ID',
      successUrl: 'https://your-domain.com/success',
      failureUrl: 'https://your-domain.com/failure',
    });
  };

  return (
    <div>
      {error && <div className="error">{error}</div>}
      <button 
        onClick={handlePayment}
        disabled={loading}
      >
        {loading ? 'Processing...' : 'Pay with eSewa'}
      </button>
    </div>
  );
}

Features

• 🚀 Simple React hook for easy integration
• 🔒 Secure payment handling with proper signatures
• 📦 TypeScript support out of the box
• 🧪 Test and production environment support
• ⚡️ Lightweight and fast

API Reference

useEsewa Hook

const { initiatePayment, loading, error } = useEsewa(config);

Config Options

| Option | Type | Required | Description | |--------|------|----------|-------------| | merchantId | string | Yes | Your eSewa merchant ID | | secretKey | string | Yes | Your eSewa secret key | | successUrl | string | Yes | URL to redirect after successful payment | | failureUrl | string | Yes | URL to redirect after failed payment | | isTest | boolean | No | Set to true for test environment |

Payment Data

| Field | Type | Required | Description | |-------|------|----------|-------------| | amount | string | Yes | Payment amount | | productId | string | Yes | Unique transaction ID | | successUrl | string | Yes | Success callback URL | | failureUrl | string | Yes | Failure callback URL |

Security Best Practices

1. Always use environment variables for sensitive data:

VITE_ESEWA_MERCHANT_ID=your_merchant_id
VITE_ESEWA_SECRET_KEY=your_secret_key
VITE_ESEWA_SUCCESS_URL=https://your-domain.com/success
VITE_ESEWA_FAILURE_URL=https://your-domain.com/failure

2. Use HTTPS for all URLs in production
3. Keep your secret key secure and never expose it in client-side code
4. Test thoroughly in test mode before going to production

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

• GitHub Repository
• Report Issues
• NPM Package