VibeFox Peach Payments for Adobe Commerce

Overview

VibeFox Peach Payments Pay Gateway adds Peach Payments card payments to Magento Open Source and Adobe Commerce. It connects to the Peach Payments Card API (COPYandPAY). The customer chooses the card payment at the payment step and clicks Place Order. Magento places the order in Pending Payment, and the customer enters the card details in the Peach Payments form on a payment page of your store. Card data is entered in the Peach Payments form and never touches your server. Visa, Mastercard, American Express and Diners Club are supported. The order is invoiced only after Peach Payments confirms the payment, and the order e-mail is sent only then.

It suits stores in South Africa, Kenya and Mauritius that sell in ZAR, KES or MUR and have a Peach Payments account. The module has no online refunds from Magento (refund in the Peach Payments dashboard), no saved cards, no subscriptions, no pre-authorisation and capture, no EFT, BNPL, QR or other non-card methods, and no payments for orders created in the Admin.

Key features

Paid only when Peach Payments confirms: the browser return never marks an order paid by itself. When the customer returns, the module reads the result of this checkout from the Peach Payments API, server to server, in the mode the checkout was created in.

Encrypted webhooks: Peach Payments Card webhooks (AES-256-GCM) confirm payments even if the customer closes the browser before returning. If the order is busy, the webhook is answered with a temporary error and Peach Payments sends it again.

Amount and currency check: every payment is compared with the order. A mismatch puts the order On Hold with a note and without an invoice.

No double processing: repeated webhooks, page reloads, or a webhook arriving together with the customer return never invoice an order twice. A late or duplicate charge is flagged with a note instead of being invoiced.

Test and live modes: separate entity ID, access token and webhook key for the Peach Payments sandbox and the live account. A payment is always checked in the mode it was started in.

Dashboard operations as notes: refunds, reversals and chargebacks made in the Peach Payments dashboard are added to the order comments by the webhook. The order and its totals are not changed.

Card brands: choose which brands the payment form shows. The form script is loaded with a Subresource Integrity hash.

Standard Magento settings: all settings are on the standard Payment Methods configuration page, with encrypted secrets, the webhook URL shown on the page, countries and minimum and maximum order totals, and an optional log without keys or e-mail addresses. The admin order page shows a Peach Payments history of every payment attempt.

Requirements

Magento Open Source or Adobe Commerce 2.4.6 to 2.4.9 (your own server or Adobe Commerce on cloud infrastructure; not Adobe Commerce as a Cloud Service), PHP 8.1 to 8.4 with the OpenSSL extension. A Peach Payments account with the Card API entity ID and access token (test and/or live), and the webhook decryption key from Peach Payments for webhooks. Order currency: ZAR, KES or MUR. A VibeFox license key from vibefox.net (one key per domain).