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.
- Click the ⚙️ icon at the top right to open Settings. Under Billing, click Payment Settings.
- Your configured gateways are listed under Configured Gateways. Click + Payment Gateway, find Peach Payments under Available Gateways, and click Configure gateway.
- On the Connection tab, you need 6 credentials from your Peach Payments account. Log in to Peach Payments and click Checkout.
- 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.
- In Peach Payments, click Recurring Payments to get your Recurring Access Token, and paste it into SubscriptionFlow.
- 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.
- 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.
- 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.
- 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.
- In your Peach Payments account, you can see the 1 ZAR transaction and its reversal.
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.
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.
- In your Peach Payments account, click Payment Links.
- Go to Settings to find the webhook URL field.
- Paste the SubscriptionFlow webhook URL into the webhooks field. Click Verify.
- 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.
- Save your changes.
Allowlist the SubscriptionFlow domain for checkout
- In Peach Payments, click the Checkout tab. Scroll down to Allowlisted domains and click + Add domain.
- Enter your SubscriptionFlow domain, for example abc.subscriptionflow.com. If you use domain mapping, enter abc.com. Click Add.
- Your domain is now pending approval. Once approved, your checkout works seamlessly.
Comments
0 comments
Please sign in to leave a comment.