Magento
Connect Peach Payments to your Magento store.
Peach Payments offers two Magento plugins, a traditional plugin and a progressive web application (PWA) plugin, which allow you to accept online payments using all the payment methods offered by Checkout.
The Magento payment extensions redirect to a payments page hosted by Peach Payments. Recurring and one-click card payments occur through a JavaScript widget that loads in your Magento store.
Merchants that have a custom front-end and a Magento back-end must use the PWA plugin.
Overview
Item | Description |
---|---|
Countries | South Africa, Kenya, and Mauritius. |
Recurring payments | Supports recurring payments through the paid-for ParadoxLabs Adaptive Subscriptions plugin; for plugin version support, see the compatibility matrix. For more information on how to configure your platform to accept recurring payments, see the support knowledge base. |
One-click payments | Supports one-click payments. |
Refunds | Supports full or partial refunds. You must refund certain payment methods manually. |
Currencies | All currencies configured for your account. |
Pricing | See the Peach Payments website. |
Account activation | Requires review by Peach Payments South Africa. Contact support for assistance. |
Register account
To connect Peach Payments to your Magento store, you must have a Peach Payments account.
Install and configure the plugin
-
Log in to the Peach Payments Dashboard and retrieve your Magento sandbox and live credentials.
-
To configure a webhook, follow the instructions in the webhook documentation using the
https://{MAGENTO_BASE_URL}/pp-hosted/secure/webhook
URL format. -
To add your domain to the Peach Payments allowlist, follow the instructions in the allowlist documentation.
-
Install the Magento plugin by following the instructions in one of the public GitLab repositories:
-
Log in to your Magento administration dashboard and go to Stores > Configuration > Sales > Payment Methods.
-
If the Peach Payments module is not visible in the list of available payment methods, go to System > Cache Management and click Flush Magento Cache.
-
Go to Stores > Configuration > Sales > Payment Methods > Other payment methods > Peach Payments - Hosted All-in-One payment solution for emerging Africa markets. to expand the available settings.
-
Configure the plugin:
-
Set the Mode to Production to accept live payments or Sandbox for testing.
-
Depending on the mode you've selected, enter the live or sandbox API credentials (including the recurring entity ID if you'll be offering subscriptions or one-click payments) you retrieved in step 1.
-
Select Yes for Enable Consolidated Payments.
-
You can redirect to the Peach Payments checkout page, embed the checkout experience on your website, or offer both options.
- To redirect to the Peach Payments checkout page, select Yes for Enable Redirect Payment Methods.
- To embed the checkout experience on your website, select Yes for Enable Embedded Checkout.
Embedded Checkout does not support certain payment methods.
-
If you enabled the redirect payment methods, select the payment methods that you want to enable.
-
Click Save Config.
-
To learn more about PHP compatibility, available events, and GraphQL, see the plugin documentation in the public GitLab repository.
You should see Peach Payments as a payment option on checkout. Execute purchases to check the integration.
️
If you receive a
Merchant domain not whitelisted
error when trying to make a payment, contact support to add your domain to the allowlist.
Tokenisation
Tokenisation enables subscriptions and one-click payments using stored cards. Tokenisation requires that you have recurring payments configured with Peach Payments. Contact support to add recurring payments to your Peach Payments account.
One-click payments
To enable your customers to store cards when making purchases so that they can perform one-click payments using the stored cards, ensure that you added the recurring entity ID when completing step 8.2 of the Install and configure the plugin section.
️
If you are not offering subscriptions, go to Stores > Configuration > Sales > Payment Methods > Other payment methods > Peach Payments - Hosted All-in-One payment solution for emerging Africa markets. > Server to Server and select No for Enable Server to Server Integration only for ParadoxLabs subscription products.
When checking out using card, your customers now have the option to store cards for one-click payments on subsequent purchases.
Subscriptions
To offer subscriptions, you must meet the following prerequisites:
- Ensure that you added the recurring entity ID when completing step 8.2 of the Install and configure the plugin section.
- Have the ParadoxLabs Adaptive Subscriptions plugin.
To configure subscriptions:
- Go to Stores > Configuration > Sales > Payment Methods > Other payment methods > Peach Payments - Hosted All-in-One payment solution for emerging Africa markets. > Server to Server and select Yes for Enable Server to Server Integration only for ParadoxLabs subscription products.
- Go to Catalog > Products and click the product that you want to be a subscription product.
- Scroll to the bottom of the screen and expand the Subscription section.
- For Enable, select Yes.
- Set the frequency, length, instalment price, and adjustment price.
- Click Save.
The product is now a subscription product.
FAQ
If you run into any issues with the Magento payment extension, check the support knowledge base for the issue and solution:
- For recurring payments with the ParadoxLabs Adaptive Subscriptions plugin, can I send confirmation emails and regular invoices?
- For recurring payments with the ParadoxLabs Adaptive Subscriptions plugin, how can I tell customers that a billing attempt has failed and how can I tell them that their card is about to expire?
- How do I show a ZeroPay or Mobicred instalment calculator on my store? For ZeroPay, use this file. For Mobicred, follow their documentation.
If you can't find the issue, contact support for assistance.
Updated 10 days ago