Skip to main content
SubscriptionFlow Docs
Africa

Peach Payments

Updated

SubscriptionFlow lets you integrate with Peach Payments, one of the most popular gateways in South Africa. This guide shows you how to connect, configure and use Peach Payments to collect payments.

  1. Click the ⚙️ icon at the top right to open Settings. Under Billing, click Payment Settings.

Payment Settings in Settings

  1. Your configured gateways are listed under Configured Gateways. Click + Payment Gateway, find Peach Payments under Available Gateways, and click Configure gateway.

Peach Payments in Configured Gateways

  1. On the Connection tab, you need 6 credentials from your Peach Payments account. Log in to Peach Payments and click Checkout.

Peach Payments dashboard

  1. Here you can find your hosted checkout Entity ID and Secret Token, your embedded checkout Client ID and Client Secret, and your Merchant ID. Copy each into the matching field in SubscriptionFlow.

Checkout credentials in Peach Payments

  1. In Peach Payments, click Recurring Payments to get your Recurring Access Token, and paste it into SubscriptionFlow.

Recurring access token in Peach Payments

  1. Check Sandbox if you are using a test account. Check Always save payment method for future use if needed. Click Test Connection, then Save. The gateway is now active. You can remove it with Uninstall at the top.

Peach Payments connection settings

  1. On the Advanced Options tab:
    • Under Accept Payment Via, check Default Options to enable the payment methods you have selected in your Peach Payments account.
    • Use Allow Access To to choose which users can use and change this gateway.
    • Check Make Default to set Peach Payments as your default gateway.
    • Check Show Payment Method Validation Popup to let customers add a payment method and validate it with a 1 ZAR reversible transaction. Then tick Show on Public Payment Method Pages (the Validation On option). The 1 ZAR validation runs only when both are on; if either is off, the card is saved without it.

Peach Payments advanced options

  1. To let a customer add a card, open the customer and go to Payment Methods, where you can find the Public Payment Method Page. This page lets your customer add a payment method to their account. Click Proceed.

Public payment method page

  1. With the validation turned on (step 7), the pop-up asks for the Visa or Mastercard details for a 1 ZAR validation transaction. This one-time validation lets you charge the card in future without asking for authorization again.

Card details for validation

  1. In your Peach Payments account, you can see the 1 ZAR transaction and its reversal.

Validation transaction in Peach Payments

  1. Checkout creates a subscription and an invoice in SubscriptionFlow before the customer pays. If the customer abandons checkout, these records clutter the system. Check Enable Payment Link Expiration and set Expires After and the Interval Type. Check Delete Abandoned Payment Links to remove them when the time is up, and Tag Customer on Abandonment to tag the customer.

  2. Copy the Webhook URL from Advanced Options. For orders followed by invoice payment, and for recurring payments, the webhook updates the status of your payments in SubscriptionFlow when it changes in Peach Payments.

Peach Payments webhook URL

  1. In your Peach Payments account, click Payment Links.

Payment Links in Peach Payments

  1. Go to Settings to find the webhook URL field.

Webhook settings in Peach Payments

  1. Paste the SubscriptionFlow webhook URL into the webhooks field. Click Verify.

Verify the webhook

  1. Back in SubscriptionFlow, refresh the page if needed. The verification code appears under Webhook Secret on Advanced Options. Enter the code in Peach Payments to change the webhook status to verified.

Verified webhook

  1. Save your changes.

Save changes in Peach Payments

Allowlist the SubscriptionFlow domain for checkout

  1. In Peach Payments, click the Checkout tab. Scroll down to Allowlisted domains and click + Add domain.

Allowlisted domains

  1. Enter your SubscriptionFlow domain, for example abc.subscriptionflow.com. If you use domain mapping, enter abc.com. Click Add.

Add domain

  1. Your domain is now pending approval. Once approved, your checkout works seamlessly.

Domain pending approval

Was this article helpful?0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.