How does it work?
Yoco Payment Page is a simple way for any customer to pay you online. Open your Yoco Mobile/Web App, activate and customise your Payment Page in a few clicks, and share it with the world to accept multiple payments online.
Your Payment Page can be used in a number of ways: You can copy the link and add it to your invoices, website, emails or newsletters; you can also share the link with your customers directly from your Yoco Mobile App, or copy the link and post it on social media.
Your customer clicks the link, enters the amount, reference and their personal details and pays using their card details on your secure Payment Page. Our online platform uses 3D Secure authentication – this means that they will receive a ‘One Time PIN’ from their bank as part of the payment process, guaranteeing the safety of the transaction.
You get an email notification every time a customer pays using your Payment Page, and you can see a record of all payments made on your Sales History.
How do I start using my Payment Page?
Log in to the Yoco Mobile/Web App here, select the Sales Tab from the options menu and click on the Payment Page tile.
💡 Configure your payments page by customising your link, choosing which details to display, and updating your business details if needed.
How do I preview my Payment Page?
From your Payment Page in the Yoco Mobile/Web App here, click on the Preview button.
You can make sure you’re happy with how it will appear to your customers, and make any adjustments you might like to your displayed contact details.
To change your logo or other business details, you'll need to navigate to your business profile, and then to your basic business settings to make the relevant changes.
How do I share my Payment Page?
From your Payment Page in the Yoco Mobile/Web App here, click on the Share your page button.
If you’re using the Yoco Mobile App, you can share your page link straight from your mobile device. If you’re using the Web App, you can copy the page link and share it wherever you like.
Where can I see my Payment Page sales?
To see all the transactions for your Payment page, go to the Sales tab in the Yoco Mobile/Web App here, select the Sales history tile and filter the Type for Payment page, by selecting from the list of filter options.
Selecting the payment will show you the details page.
Who would benefit from using Yoco Payment Page?
Payments Page is very versatile and can be used in many different ways:
If you're an NPO, your payments page can be used to accept donations.
If you're in the retail or services industry, and usually send invoices, you can add your Payments Page as a new payment method onto your invoices.
If you're selling products or services on social media, you can link to your Payments Page in your bio.
If you'd like to send one-off payment requests to individual customers, for the specific amount they need to pay, our Payment Link feature may be more suitable for you.
How can I customise my payment page link?
Your unique payment page link can be customised with additional parameters like amount and reference. This will pre-populate those fields on the payment page when your customer visits the link.
Creating a Customised Payment Page Link:
Find your standard payment link on the Payment Page widget, within the Yoco App. Look under "Your page link" to find your unique payment page URL. Example:
https://pay.yoco.com/acme-inc
Create your customised link manually
Copy your standard payment link and add the parameters for amount and reference:https://pay.yoco.com/acme-inc?amount=AMOUNT&reference=REFERENCE
Simply replace:AMOUNT
with the price (e.g., 100.00)REFERENCE
with your order identifier (e.g., invoice number)
For example, if your standard link is
https://pay.yoco.com/acme-inc
, your customised link might look like:https://pay.yoco.com/acme-inc?amount=100.00&reference=largesocks
Note: These customised links with parameters cannot be saved in the Yoco App. If you attempt to save a link containing parameters within the "Your page link" section, you'll receive an error because special characters like "?" and "&" are not allowed when saving links in the app.
Test your link by pasting it into a browser to verify it works correctly.
Share the customised link directly with your customers via email, messaging, or your website.
Important Notes:
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).
Can I redirect my customer after payment?
In addition to setting the amount and the reference, you can also add a link to a webpage where we’ll redirect the user after payment. You do this by adding a parameter called redirectOnPaymentSuccess.
Here's an example:
This is a simple way of taking the customer to a page on your website once they’ve successfully paid. For example, you might like to show them information about their order, or the next steps to follow to receive their goods.
Parameter References
Note: these parameters are case sensitive. They must be supplied exactly as shown in this table.
Parameter | Description |
amount | Amount in ZAR to charge the customer. The amount must be a Rand value and can optionally include cents. Only include numbers, and a decimal point if you’re adding cents. |
firstName | Customer’s first name. Will be shown on the payments page form but will be editable. |
lastName | Customer’s last name. Will be shown on the payment page form but will be editable. |
Customer’s email address. Will be shown on the payment page form but will be editable. The customer’s receipt will be emailed to this address. | |
reference | Your reference for the payment. This will be associated with the payment and be sent to you in your notification email. |
redirectOnPaymentSuccess | URL of one of your web pages to redirect the customer if the payment is successful. Should be URL encoded. |
What are the transaction fees?
Transaction fees for online payments range from 2.55% to 2.95% for local cards, and from 3.0% to 3.4% for international and AMEX cards, depending on your turnover and fees package. Instant EFT has a fixed 2% (ex. VAT) fee.
The more you transact, the less you pay.
Get more details about how Yoco fees work here.
How do I get paid?
All online payments are linked to your existing Yoco Profile, and you’ll receive your payouts as per our usual schedule - see more here.
What cards are accepted currently?
All Visa and MasterCard cards that are 3D Secure enabled are accepted, including international cards like American Express. Diners cards are not currently supported.