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

1. Customer selects Peach Payments at checkout and clicks "Place Order"
2. The addon creates a secure checkout session via the Peach Payments API
3. Customer is shown the COPYandPAY payment widget to enter their card details
4. Card data is submitted directly to Peach Payments (never touches your server)
5. Customer is redirected back to your store
6. The addon verifies the payment result and updates the order status

Installation

1. Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
2. Activate the addon and enter the license key
3. Go to Administration > Payment methods and create a new payment method
4. Select "Peach Payments Gateway" as the processor
5. Enter your Access Token and Entity ID from the Peach Payments dashboard
6. Configure order status mappings as desired
7. 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