CartModules: Peach Payments Gateway
Accept Card Payments via Peach Payments in Your CS-Cart Store
Integrate Peach Payments -- South Africa's leading payment gateway -- directly into your CS-Cart or Multi-Vendor store. Accept Visa, Mastercard, Amex, and more through a secure hosted payment widget. Peach Payments serves merchants across South Africa, Kenya, Mauritius, Tanzania, and Uganda.
Key Features
- COPYandPAY Integration -- Secure hosted payment widget handles all card data (PCI SAQ A compliant)
- Multi-Currency Support -- ZAR, USD, EUR, GBP, KES, MUR, TZS, UGX
- Major Card Brands -- Visa, Mastercard, American Express
- Sandbox/Production Toggle -- Switch between test and live environments from the admin panel
- Configurable Order Statuses -- Map payment results (Success, Pending, Failed) to any CS-Cart order status
- Bearer Token Authentication -- Secure API communication using industry-standard OAuth
- Idempotent Callbacks -- Duplicate callbacks are safely ignored
- Billing Details Forwarded -- Customer billing information sent to Peach for fraud screening
- Automatic Payment Verification -- Payment result queried and verified on customer return
Requirements
- CS-Cart or Multi-Vendor 4.x
- PHP 7.1 or higher
- Peach Payments merchant account with COPYandPAY API credentials
- Store currency set to a supported currency (ZAR, USD, EUR, GBP, KES, MUR, TZS, or UGX)
How It Works
- Customer selects Peach Payments at checkout and clicks "Place Order"
- The addon creates a secure checkout session via the Peach Payments API
- Customer is shown the COPYandPAY payment widget to enter their card details
- Card data is submitted directly to Peach Payments (never touches your server)
- Customer is redirected back to your store
- The addon verifies the payment result and updates the order status
Installation
- Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
- Activate the addon and enter the license key
- Go to Administration > Payment methods and create a new payment method
- Select "Peach Payments Gateway" as the processor
- Enter your Access Token and Entity ID from the Peach Payments dashboard
- Configure order status mappings as desired
- Save and test with sandbox mode before going live
Supported Countries & Currencies
This addon is designed for merchants in South Africa and across Sub-Saharan Africa. Peach Payments supports the following currencies:
- ZAR -- South African Rand
- USD -- US Dollar
- EUR -- Euro
- GBP -- British Pound
- KES -- Kenyan Shilling
- MUR -- Mauritian Rupee
- TZS -- Tanzanian Shilling
- UGX -- Ugandan Shilling
