KommandHub/KommandhubPaystackSW

The Paystack Payment Plugin integrates the Paystack payment gateway into Shopware 6, allowing merchants in Africa (Nigeria, Ghana, Kenya, South Africa, and Cote d'Ivoire) to accept payments via credit/debit cards, bank transfers, USSD, and more. # Paystack Payment for Shopware 6 A production-grade **Shopware 6 payment plugin** that integrates the **Paystack** payment gateway, enabling merchants across Africa to accept secure online payments through cards, bank transfers, USSD, and mobile money. Developed by Kommandhub Limited. > **Independent integration.** This is an independent, third-party plugin. It is **not** affiliated with, endorsed by, sponsored by, certified by, or officially supported by Paystack. "Paystack" and the Paystack logo are trademarks of their respective owner and are used here only to identify the payment gateway this plugin connects to. See Trademarks & Disclaimer. This document is the technical reference for developers **contributing to** the plugin. If you only want to install and configure it on a live shop, the Installation and Configuration sections are enough. --- ## Table of Contents - Project Overview - Key Features - Supported Payment Channels - Architecture Overview - Technology Stack - Directory Structure - System Requirements - Installation - Local Development Setup - Docker & Docker Compose - Makefile Commands - Configuration Options - Build & Asset Compilation - Testing - Code Quality - Data Handling - Logging & Debugging - Security Considerations - Performance Considerations - Deployment - CI/CD - Version Compatibility - Troubleshooting - Contributing - Coding Standards - Roadmap - License - Trademarks & Disclaimer - Support --- ## Project Overview The plugin adds Paystack as a native Shopware 6 payment method. It handles the full payment lifecycle: 1. **Initialize** a Paystack transaction and redirect the customer to Paystack's hosted checkout. 2. **Finalize** the payment on return by verifying the transaction against the Paystack API — matching **status, amount, and currency** before the order is marked paid. 3. **Reconcile** payments asynchronously via signed webhooks (for cases where the customer never returns from the redirect). 4. **Refund** o …