Download the PHP package kendenigerian/payzephyr without Composer
On this page you can find all versions of the php package kendenigerian/payzephyr. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kendenigerian/payzephyr
More information about kendenigerian/payzephyr
Files in kendenigerian/payzephyr
Package payzephyr
Short Description A unified payment abstraction layer for Laravel supporting multiple providers (Paystack, Flutterwave, Monnify, Stripe, PayPal, Square, OPay, Mollie, NOWPayments) with automatic fallback and webhooks.
License MIT
Homepage https://github.com/ken-de-nigerian/payzephyr
Informations about the package payzephyr
PayZephyr
PayZephyr is a Laravel package that makes accepting payments simple. Instead of writing different code for each payment provider (Paystack, Stripe, PayPal, etc.), you write code once and PayZephyr handles the rest.
Features
- One API for all providers - Switch between Paystack, Stripe, PayPal, and more without changing your code
- Automatic fallback - If one provider fails, PayZephyr automatically tries another
- Built-in security - Webhook signature validation, replay protection, and data sanitization
- Production ready - Comprehensive error handling, transaction logging, and extensive testing
- Enterprise subscriptions - Enhanced subscription management with automatic transaction logging and lifecycle events
- Transaction logging - All subscription operations automatically logged to database with full audit trail
- Idempotency support - Prevent duplicate subscriptions with automatic UUID generation or custom keys
- Lifecycle events - Webhook events for subscription created, renewed, cancelled, and payment failed
- Business validation - Built-in validation prevents duplicate subscriptions and validates plan eligibility
- State management - Comprehensive subscription status enum with state machine logic and transition validation
- Query builder - Advanced subscription filtering with fluent interface for complex queries
See Provider Details for currency and channel support.
Installation
New to PayZephyr? Check out our Getting Started Guide.
Requirements
- PHP 8.2 or higher
- Laravel 10.x, 11.x, or 12.x
- Composer
Quick Install
That's it! You're ready to start accepting payments.
Alternative: Manual setup:
Configuration
Add provider credentials to .env:
See Configuration Guide for all options.
Quick Start
What happens: Customer clicks "Pay" → Redirected to payment page → Returns to your site → You verify payment
Initialize Payment
Verify Payment
After customer returns from payment page:
Webhooks
Queue workers required. Configure webhook URLs in provider dashboards:
- Paystack:
https://yourdomain.com/payments/webhook/paystack - Stripe:
https://yourdomain.com/payments/webhook/stripe - See Webhook Guide for all providers
Setup
See Webhook Guide for complete setup.
Subscriptions
Currently, only PaystackDriver supports subscriptions. Support for other providers will be added in future releases.
PayZephyr provides enterprise-grade subscription management with automatic transaction logging, idempotency support, lifecycle events, business validation, and comprehensive state management. All subscription operations are automatically logged to the database for audit and analytics.
Quick Example
Key Features:
- Automatic transaction logging - All subscriptions logged to database automatically with full audit trail
- Idempotency support - Prevent duplicate subscriptions with automatic UUID generation or custom keys
- Lifecycle events - Webhook events for subscription created, renewed, cancelled, and payment failed
- Business validation - Built-in validation prevents duplicates and validates plan eligibility
- State management - Comprehensive subscription status enum with state machine logic and transition validation
- Query builder - Advanced subscription filtering with fluent interface:
Payment::subscriptions()->forCustomer()->active()->get()
📖 See Subscriptions Guide for complete documentation
👨💻 Developers: Want to add subscription support for a new driver? See the Developer Guide.
Transaction Logging
All payment and subscription transactions are automatically logged:
Testing
Use sandbox credentials for testing:
See Testing Guide for examples.
Advanced Usage
See Architecture Guide for advanced patterns.
Troubleshooting
Webhooks not processing? Ensure queue workers are running:
Provider not found? Check .env:
Health check endpoint: GET /payments/health - Monitor provider availability
See Troubleshooting Guide for more.
Documentation
- Getting Started - Step-by-step tutorial
- Complete Guide - Full documentation
- Webhooks - Webhook setup
- Providers - Provider details
- Architecture - System design
Contributing
Contributions welcome! See Contributing Guide.
Changelog
See CHANGELOG.md for version history.
Latest: v1.8.0 - Major subscription enhancements with enterprise-grade features
v1.8.0 Highlights:
- Subscription Transaction Logging - Automatic logging of all subscription operations to database
- Idempotency Support - Prevent duplicate subscriptions with automatic UUID generation or custom keys
- Lifecycle Events - Comprehensive webhook events (SubscriptionCreated, SubscriptionRenewed, SubscriptionCancelled, SubscriptionPaymentFailed)
- Business Validation - Built-in validation prevents duplicate subscriptions and validates plan eligibility
- State Management - Subscription status enum with state machine logic and transition validation
- Query Builder - Advanced subscription filtering with fluent interface for complex queries
- Lifecycle Hooks - Optional interface for custom drivers to hook into subscription lifecycle events
See Changelog for complete release notes.
License
The MIT License (MIT). Please see LICENSE for more information.
Support
If PayZephyr helped your project:
- Star the repository on GitHub
- Share it with others
- Contribute code or documentation
Built for the Laravel community by Ken De Nigerian
All versions of payzephyr with dependencies
guzzlehttp/guzzle Version ^7.8
illuminate/database Version ^10.0|^11.0|^12.0
illuminate/http Version ^10.0|^11.0|^12.0
illuminate/support Version ^10.0|^11.0|^12.0
stripe/stripe-php Version ^13.0