Skip to main content

How to Set up an Online Payment Page

Use your payment page to accept payments online from your customers, even if you don’t have a website.

Updated over a week ago

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).

  1. Customise your Payment Page in the Yoco App (mobile or web).

  2. Copy your unique link and add it to your invoices, website, emails or newsletters, post it on social media, or share it directly from the Yoco App (mobile or web).

  3. 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).

✨ Payment page transactions are paid out according to our payout schedule, and you’ll be notified via email every time a payment is made. Please refer to the Fees tile/widget in the Yoco App (mobile or web) for a list of online transaction fees for your Yoco Plan.

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

  1. Log in to the Yoco App (mobile or web).

  2. Select the Sales tab.

  3. Select the Payment Page tile.

  4. 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.

  5. 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.

  6. To preview your payment page, select the Preview button.

  7. 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.

  1. Copy your standard payment link: https://pay.yoco.com/whimsydeli

  2. Add 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=John

  3. Test your link by pasting it into a browser to verify it works correctly.

  4. 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.

email

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

  1. Log in to the Yoco App (mobile or web).

  2. Select the Sales tab.

  3. 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

  1. Log in to the Yoco App (mobile or web).

  2. Select the Sales tab.

  3. Select the Sales history tile/widget.

  4. 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.

  5. 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.


Did this answer your question?