v3.0.0

v3.0.0 Release Notes

Highlights

• Full modernization of the package into a framework-agnostic eSewa ePay v2 SDK.
• New clean bootstrap API with EsewaPayment::make(...).
• Typed, model-first architecture for checkout, callback verification, and status checks.
• Stronger production safety:
  • callback signature verification
  • anti-fraud field consistency checks
  • callback replay protection hooks
  • retry policy for status checks
  • PSR-3 logging integration
• PHP support: 8.1 to 8.5.
• CI + quality tooling: PHPUnit, PHPStan, Rector, GitHub Actions matrix.
• Comprehensive README with secure Laravel integration and usage patterns.

Breaking Changes

• Legacy Omnipay-era architecture and old message classes removed.
• Public integration style changed to new client/module API (checkout, callbacks, transactions).
• Callback handling now requires explicit verification flow for secure production usage.
• Minimum PHP version is now 8.1.

Upgrade Guide

1. Update package:
   • composer require sudiptpa/esewa-payment:^3.0
2. Replace old gateway initialization with:
   • EsewaPayment::make(...) or new EsewaClient(...)
3. Replace old checkout flow with CheckoutRequest + createIntent(...).
4. Replace old callback handling with:
   • CallbackPayload::fromArray(...)
   • verifyCallback(...) (+ VerificationExpectation recommended)
5. Replace old status calls with:
   • transactions()->fetchStatus(new TransactionStatusRequest(...))
6. For production:
   • use persistent idempotency store (Redis/DB) for replay protection
   • keep strict anti-fraud checks enabled
   • rely on callback verification, not redirect-only success

v2.0.1

• Added documentation guide for Epay API v2
• Added working samples
• Added a helper function to generate the signature string

v2.0.0

• Added support for API (v2) Epay.

v1.0.1

• Fixed up Guzzle headers on transaction verify API
• Fixed up tests