README

Accept payments from customers across Africa using Paystack - one of Africa's leading payment processors.

🌍 Supported Countries & Payment Methods

Countries

• 🇳🇬 Nigeria
• 🇬🇭 Ghana
• 🇿🇦 South Africa
• 🇰🇪 Kenya
• And more across Africa

Payment Methods

• 💳 Cards (Visa, Mastercard, Verve)
• 🏦 Bank Transfer
• 📱 Mobile Money
• 📞 USSD
• 💰 Bank Account
• 🔄 QR Code

Supported Currencies

• NGN (Nigerian Naira)
• GHS (Ghanaian Cedi)
• ZAR (South African Rand)
• KES (Kenyan Shilling)
• USD (US Dollar)

📋 Requirements

• Bagisto 2.x
• PHP 8.2 or higher
• Laravel 11.x
• Paystack Account (Sign up here)
• SSL Certificate (Required for production)

Installation

Step 1: Install via Composer

composer require wontonee/paystack

Step 2: Publish Assets

php artisan vendor:publish --tag=paystack-assets

Step 3: Clear Cache

php artisan config:cache
php artisan route:cache
php artisan optimize:clear

⚙️ Configuration

1. Get Paystack Credentials

1. Login to Paystack Dashboard
2. Navigate to Settings → API Keys & Webhooks
3. Copy your Public Key and Secret Key

2. Configure in Bagisto Admin

1. Go to Admin Panel → Configuration → Sales → Payment Methods
2. Find Paystack in the payment methods list
3. Configure the following fields:

1. Click Save Configuration

🔧 How It Works

Payment Flow

1. Customer Checkout: Customer selects Paystack and places order
2. Transaction Initialization: System initializes transaction via Paystack API
3. Redirect to Paystack: Customer redirected to Paystack payment page
4. Payment Processing: Customer completes payment on Paystack
5. Callback: Paystack redirects back with reference
6. Verification: System verifies transaction with Paystack API
7. Order Creation: Order created if payment successful

API Endpoints

All Transactions:

• Initialize: https://api.paystack.co/transaction/initialize
• Verify: https://api.paystack.co/transaction/verify/:reference

🧪 Testing

Test Mode

1. Use API keys starting with pk_test_ and sk_test_
2. Test with Paystack test cards
3. No real money charged

Test Cards

Success:

Card Number: 4084 0840 8408 4081
CVV: 408
Expiry: Any future date (e.g., 12/25)
PIN: 0000
OTP: 123456

Insufficient Funds:

Card Number: 5061 0200 0000 0000 094

Declined:

Card Number: 5061 0203 4000 0000 07

More test cards: https://paystack.com/docs/payments/test-payments

📝 Important Notes

Amount Handling

• Paystack requires amounts in kobo/cents (₦10 = 1,000 kobo)
• System automatically converts amounts to kobo
• Supports NGN, GHS, ZAR, KES, USD

Payment Status

• success: Payment completed successfully
• failed: Payment failed
• abandoned: Payment not completed

Security

• Always verify transactions on server-side
• Never expose secret key on frontend
• Use HTTPS for production

� Troubleshooting

Common Issues

1. "Payment initialization failed"

• Solution: Check Public Key and Secret Key in admin configuration

2. "Payment verification failed"

• Solution: Verify API keys are correct and match environment (test/live)

3. "Callback not working"

• Solution: Ensure SSL certificate is valid (production) and callback URL is accessible

4. Route not found errors

• Solution: Run php artisan route:cache and php artisan config:cache

5. Image not showing

• Solution: Run php artisan vendor:publish --tag=paystack-assets --force

Debug Logs

Check logs in storage/logs/laravel.log for detailed error information.

🆘 Support

For support, contact:

• Email: dev@wontonee.com
• Website: https://www.wontonee.com
• Whatsapp: +91-9711381236, +91-9811381218

📄 License

This package is proprietary software. All rights reserved by Wontonee.

PROPRIETARY LICENSE - Unauthorized copying, distribution, modification, or use of this software is strictly prohibited.

🔮 Upcoming Features

• ✅ Webhook integration for real-time updates
• ✅ Refund functionality from admin panel
• ✅ Recurring payments support
• ✅ Split payments

📚 Additional Resources

• Paystack Developer Documentation
• Paystack Dashboard
• Bagisto Documentation

Developed with ❤️ by Wontonee