Shopify

Connect Peach Payments to your Shopify store.

Peach Payments offers a payment extension for Shopify which allows you to accept online payments using all the payment methods offered by Checkout.

Overview

ItemDescription
CountriesSouth Africa, Kenya, and Mauritius.
Recurring paymentsDoes not support recurring payments, only once-off payments.
RefundsSupports full or partial refunds from the Shopify dashboard. You must refund certain payment methods manually.
CurrenciesAll currencies configured for your account.
PricingSee the Peach Payments website.
Account activationRequires review by Peach Payments South Africa. Contact support for assistance.

🚧

Apple Pay and PayPal

Shopify does not allow payment providers to accept Apple Pay or PayPal via Shopify plugins. You must contact Shopify directly to enable these payment methods.

Register account

To connect Peach Payments to your Shopify store, you must have a Peach Payments account.

As part of the registration process, Peach Payments gives you access to the Peach Payments Dashboard where you can retrieve your sandbox and live credentials and view transactions.

Get started with Shopify

Link your Peach Payments account to Shopify in one of the following ways:

  • Using the Peach Payments Dashboard. Peach Payments recommends this method.
  • Using the Shopify user interface.

📘

You can link your sandbox or live Peach Payments Dashboard to your Shopify store.

Link your Peach Payments account using the Peach Payments Dashboard

📘

You can link your sandbox or live Peach Payments Dashboard to your Shopify store. To link your sandbox Dashboard, follow the instructions below from the sandbox Dashboard.

  1. Log in to the Peach Payments Dashboard.

  2. In the Connect section, click Shopify.

  3. In the Connect Shopify store section, click Link store.

  4. In the Link your Peach account browser window that opens, enter your store name and click Link account. Your Shopify store name resembles <store-name>.myshopify.com (for example, peach-payments-demo.myshopify.com) and you can retrieve it from the Settings section, or, if you're using a custom domain, from the Settings > Domains section of your Shopify store.

    Shopify store name in **Settings**.

    Shopify store name in Settings.

  5. In Shopify, click Install app.

  6. If you are connecting your sandbox Dashboard to your Shopify store to test payments, select Enable test mode. Sandbox Dashboard cannot accept live payments so do not clear the checkbox; clearing it causes transactions to fail. If you are connecting your live Dashboard to test payments, select Enable test mode. Clear the checkbox to accept live payments.

  7. Click Activate Peach Payments to activate the app.

  8. To configure a webhook, follow the instructions in the webhook documentation.

After you have started accepting live payments, selecting Enable test mode on your Shopify store causes your store to stop processing live transactions and start processing test transactions. Peach Payments advises that you rather use a standalone sandbox Shopify store to test.

A message stating Peach Payments activated appears. To confirm that the Peach Payments app is active, select Payments from the left panel and confirm that Peach Payments appears in the Supported payment methods section.

Link your Peach Payments account using your API credentials

📘

Peach Payments recommends following the simpler steps in the section above to link your Peach Payments account to your Shopify store.

Link your Peach Payments account to your Shopify store as follows:

  1. Go to https://dashboard.peachpayments.com/shopify/install.

  2. Enter your Shopify store name, live entity ID, and secret token, and click Link account. Your Shopify store name resembles <store-name>.myshopify.com (for example, peach-payments-demo.myshopify.com) and you can retrieve it from the Settings section, or, if you're using a custom domain, from the Settings > Domains section of your Shopify store.

    Shopify store name in **Settings**.

    Shopify store name in Settings.

  3. Click Install app.

  4. If you are connecting your sandbox Dashboard to your Shopify store to test payments, select Enable test mode. Sandbox Dashboard cannot accept live payments so do not clear the checkbox; clearing it causes transactions to fail. If you are connecting your live Dashboard to test payments, select Enable test mode. Clear the checkbox to accept live payments.

  5. Click Activate Peach Payments to activate the app.

  6. To configure a webhook, follow the instructions in the webhook documentation.

    Activate Peach Payments.

    Activate Peach Payments.

After you have started accepting live payments, selecting Enable test mode on your Shopify store causes your store to stop processing live transactions and start processing test transactions. Peach Payments advises that you rather use a standalone sandbox Shopify store to test.

A message stating Peach Payments activated appears. To confirm that the Peach Payments app is active, select Payments from the left panel and confirm that Peach Payments appears in the Supported payment methods section.

Supported payment methods.

Supported payment methods.

Confirm that you are accepting live payments

To confirm that you are accepting live payments:

  1. Log in to the live Peach Payments Dashboard.
  2. In the Connect section, click Shopify.
  3. In the Connect Shopify store section, check that the status of your Shopify store is Successful.
  4. Log in to your Shopify store, go to Settings, and select Payments.
  5. In the Supported payment methods section, check that Peach Payments appears in the list and that test mode is not enabled.

If you have any issues, check the frequently asked questions.

Process refunds

To process refunds, follow Shopify's guide.

🚧

Do not process refunds from the Peach Payments Dashboard. The Dashboard cannot inform Shopify of the refund, so although you've refunded the customer, Shopify does not know that the customer has received a refund.

When the refund is complete, you can view the refunded transaction in the Peach Payments Dashboard.

Refund in Peach Payments Dashboard.

Refund in Peach Payments Dashboard.

Deactivate and uninstall Peach Payments from your Shopify store

To stop accepting payments using Peach Payments, you can deactivate and, optionally, uninstall the Peach Payments app:

  1. Log in to your Shopify store, go to Settings, and select Payments.
  2. In the Peach Payments section of the Supported payment methods section, click Manage.
  3. Scroll to the bottom of the page and click Deactivate Peach Payments.
  4. In the pop-up that appears, click Deactivate Peach Payments. This deactivates Peach Payments and removes the payment method from your store. If you think you might reactivate the payment method later, you can stop at this point.
  5. To uninstall the Peach Payments app, click Uninstall Peach Payments.
  6. In the pop-up that appears, click Uninstall Peach Payments.

This uninstalls the Peach Payments app and you can no longer accept payments through Peach Payments.

FAQ

If you run into any issues with Shopify, check the support knowledge base for the issue and solution.

If you can't find the issue, contact support for assistance.

How do I show a Payflex, ZeroPay, or Mobicred instalment calculator on my store

Follow the relevant payment method's documentation:

I'm trying to link my Shopify store, but when I enter the store name, I get a Not a valid store name error

If you're getting the following error, you might be entering your store's custom domain instead of the store name.

Store name error.

Store name error.

Your Shopify store name resembles <store-name>.myshopify.com (for example, peach-payments-demo.myshopify.com) and you can retrieve it from the Settings section, or, if you're using a custom domain, from the Settings > Domains section of your Shopify store.

Shopify store name in **Settings**.

Shopify store name in Settings.

I linked my Shopify store to Peach Payments, but the Peach Payments payment method does not appear on Checkout

When linking your store, you might have forgotten to complete the final step in the process, that is, clicking Activate Peach Payments. Uninstall the app, then link your store again, ensuring that you click Activate Peach Payments as the final step.