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