An online payment page lets your customers pay you safely and securely – and you can set it up in minutes from the Yoco App (mobile or web).
Customers enter their details, then pay using their card details on a secure, 3D Secure–enabled page (with a One Time PIN from their bank).
Smart ways to use a payment page
Non-profits (NPOs): Collect donations quickly and securely.
Retail and services: Add your payment page link to your invoices as an easy way for customers to pay.
Social media sellers: Share your link in your bio or posts, so customers can pay you directly.
✨ Need to send a once-off request for a specific amount? Use our Payment Link feature instead.
Customising your payment page
Select the Sales tab.
Select the Payment Page tile.
To customise the link for your Payment Page, select the pencil icon next to the link, then click here to find out how you can customise the link to pre-populate certain fields on your payment page.
To display your contact details on your Payment Page, select the pencil icon next to Display email address and/or Display phone number, enter your email address and contact number, and select the blue Save button.
💡 Good to know: Your email address and contact number need to be added to your Payment Page – they do not automatically pull through from your Yoco profile. Adding these details to your Payment Page is optional.
To preview your payment page, select the Preview button.
You’ll see a preview of the payment page your customer will receive.
✨ Want to change your logo or business details? Select your business name or logo (bottom left of the screen) in the Yoco App (web or mobile). When the Business settings page opens up, select the Business details tile/widget.
Customising your payment page link
It’s possible to customise your unique payment page link with certain parameters so that when your customer opens it, one or all of the following fields are pre-populated:
Amount
Reference
First name
Last name
Email address
✨ It’s also possible to add a parameter called redirectOnPaymentSuccess. This lets you add a URL that redirects customers to your website (or a specific page on your website) after a successful payment. This can be helpful if you want to share information about their order, or share next steps relating to their purchase.
Copy your standard payment link:
https://pay.yoco.com/whimsydeliAdd a ‘?’ at the end of your original link, then include your chosen parameters, e.g. amount, reference, first name, each separated by an ‘&’. So, if your standard link is
https://pay.yoco.com/whimsydeli, your customised link could be:https://pay.yoco.com/whimsydeli?amount=200.00&reference=Breakfast&firstName=JohnTest your link by pasting it into a browser to verify it works correctly.
Share the customised link directly with your customers via email, WhatsApp, or your website.
✨ Please note:
The amount must be in Rand (ZAR) and can include cents.
Use only numbers and a decimal point for the amount (e.g. 100.00).
Customised links with parameters cannot be saved in the Yoco App because special characters like ‘?’ and ‘&’ are not permitted.
Parameter | Description |
amount | The amount must be in Rands (ZAR). Cents are optional. Only use numbers, and a decimal point if you’re adding cents. |
firstName | Customer’s first name. Will be shown on the payments page, but can be edited. |
lastName | Customer’s last name. Will be shown on the payments page, but can be edited. |
Customer’s email address. Will be shown on the payments page, but can be edited. The customer’s receipt will be emailed to this address. | |
reference | Your reference for the payment. This will be associated with the payment and sent to you in your notification email. |
redirectOnPaymentSuccess | URL of one of your web pages to redirect the customer to if the payment is successful. Should be URL encoded, e.g. https://pay.yoco.com/whimsydeli?amount=200.00 &reference=Breakfast&redirectOnPaymentSuccess=https://example.com/payment-success/ |
❗Important: Parameters are case sensitive and must be included in your link exactly as they appear in the table above.
Sharing your payment page
Select the Sales tab.
Select the Payment Page tile.
✨ If you’re using the Yoco Mobile App, you can share your payment page link directly from your mobile device. If you’re using the Web App, you can copy the payment page link and share it anywhere you like.
Viewing payment page sales
Select the Sales tab.
Select the Sales history tile/widget.
Select the Type button, then tick the box next to the Payment page option and select the Apply button to filter out all other sales types.
Click on or tap a specific payment to view the sales details for it.
Payment page fees
Your online payment fees are based on your Yoco Plan. If you’re not sure which plan you’re on, click here to find out.









