Skip to main content

Troubleshooting Domain Verification

Having trouble verifying your domain with Yoco? Find out how to fix common issues and get live payment processing working for your website.

Domain verification is a requirement under the Financial Intelligence Centre Act (FICA), and it confirms that your website meets the standards needed for online payments. If your domain's stuck in review or it’s been rejected, here's how to fix it and get back to taking live payments.
​


What your website needs to include


Your website must meet these requirements before the domain can be approved:

  • Business details
    Your business name and contact information must be visible on the site.
    ​

  • Product pages or catalogues
    There must be at least one publicly accessible page showing what you sell.
    ​

  • Policies
    There must be a privacy policy and returns/refund policy. Both need to be accessible without logging in.
    ​

  • Live site
    The website must be finished and live. It cannot not be under construction, or sitting behind a password. We can only verify your domain if we can see your content.

❗ Important: These requirements exist to comply with FICA regulations. We can't approve incomplete or inaccessible websites for live payment processing.

Shortened links or URLs that redirect to a login page will cause verification to fail or stall. Always use your full, direct website URL.


What to do if your domain is rejected


If your domain is rejected, you have two options:

  1. Fix the issues on your site and resubmit the same domain.

  2. Submit a different domain for review if your primary site isn't ready yet.


What should you fix?

One of the most common reasons for your domain being rejected is too little content on your website. So, if you decide to resubmit the same domain, make sure your site:

  • Shows your business name and contact information

  • Includes at least one page, open to the public, that shows what you sell

  • Has a privacy policy and returns/refund policy available without needing to log in.

  • Is live and fully working; not under construction or behind a password.

Once you’ve updated your site, you can resubmit your domain for review.
​

❗Important: Some domains are rejected based on Yoco’s risk assessment and can’t be resubmitted. If you’re not sure why yours was rejected, contact Yoco Support.


Resubmitting a rejected domain


If you've made changes to your site, like adding product pages, making content public, or updating your policies, follow these steps to trigger a new review:

  1. Yoco App (mobile or web).

  2. Go to the Manage tab.

  3. Select the Yoco Connect tile.
    ​

  4. Select the Checkout API tile.
    ​

  5. Select the How to connect button.
    ​

  6. Scroll down to Verified domains and find the rejected domain.

  7. Select the trash icon to remove it.

  8. Select the Add domain button.
    ​

  9. Enter your updated URL and select the Verify domain button.
    ​

Resubmitting on Shopify?

If you're using Shopify, the process is slightly different:

  1. In your Shopify admin, go to Sales channels → Yoco Connect → eCom.

  2. Select your platform and add your domain in the field provided.

  3. Submit for review.


FAQs


Why does Yoco verify my domain?

Domain verification is a compliance requirement under the Financial Intelligence Centre Act (FICA). It confirms your website is legitimate and that your business meets the requirements for processing live payments online.

Where do I find the Domain Verification section in the app?

Go to Manage → Connect → Checkout API → How to connect, then scroll down to Domain Verification.

Can Yoco manually bypass the verification process?

No, domain verification is fully automated and can't be manually overridden. Live payment keys are only enabled once the automated review approves your domain.

Why was my domain rejected?

A domain is automatically rejected for one of a few reasons:

  1. The domain is invalid or contains a typo.

  2. The site is password-protected, or still showing a “coming soon” page.

  3. The domain is already verified on another Yoco profile.

If your site is live and public and none of these apply, delete the rejected domain and resubmit it – this resolves most cases. If it’s rejected again and you believe that’s a mistake, contact Yoco Support so we can check it manually.

Why does it say my domain 'could not be reviewed'?

'Could not be reviewed' is not the same as your domain being rejected. It means that we weren’t able to load or scan your site during the check because, for examples, it was temporarily offline, still being built, or briefly unreachable. It does not mean that something on the site failed the review. Make sure your site is live and publicly reachable, then request a new review or resubmit the domain.

How do I fix or change the domain I submitted?

Once a domain is submitted, it can’t be edited. This is intentional, so a domain can’t be changed after it’s been reviewed. If you’ve made a typo, submitted the wrong address, or just need to switch domains, you can’t correct the existing entry. Instead:

  1. Let the review finish (an invalid or mistyped domain is usually rejected quickly).

  2. Delete the rejected domain.

  3. Add the correct domain as a new submission.

You can hold up to three domains on your profile at a time. Rejected domains stay on your profile for your records but don’t count toward that limit, so removing and re-adding doesn’t cost you a slot.
​

My domain is verified but I still can’t take online payments. Why?

If your domain shows as approved but online payments still aren’t working, the most common cause is outdated plugin or integration settings – this can happen after changing your domain, re-platforming, or updating your store setup. Try removing and reinstalling the Yoco plugin (on Shopify or WooCommerce) and reconnecting it.
​

If payments still don’t work after that, contact support with your business name and domain so we can check your account directly – this isn’t something you need to resolve through domain verification again.
​

Where do I find my API keys, and when do my live keys unlock?

You’ll find your test and live API keys in the Yoco App (mobile or web). Go to the Sales tab, select the e-Commerce integrations tile (look for it under the Yoco Connect heading), choose the correct plugin or API option, then select the How to connect button.
​

You can view your test keys immediately, so you can build and test your checkout before your domain is approved.

Live keys only become available once your domain is verified. They allow real transactions, so we only issue them once we know where you’re taking payments from. If you don’t see live keys yet, it’s because domain verification isn’t done. Finish that first.

Does domain verification apply to Shopify, Wix, WooCommerce, and custom sites?

Yes, domain verification is required no matter which platform you use. There’s no way to accept online payments without it.

  • Shopify, Wix or WooCommerce: installing the Yoco plugin for your platform adds your store’s domain and submits it for review automatically.

  • Custom-built site: add your website domain directly in your Yoco dashboard to start the review.

In every case, the same automated check applies, and you’ll need an approved domain before you can accept live online payments.

My domain entry is stuck or failed. How do I remove or replace it?

Once a domain has been rejected, use the trash icon next to it to remove it, then use Add domain to submit the correct one.
​

A domain still showing as pending or in review can’t be deleted while the check is running. If it stays pending well beyond the usual couple of minutes, don’t try to resubmit or work around it; contact Yoco Support instead via our in-app chat.

Can I submit a domain for a password-protected or 'under construction' site?

We can’t verify a site that’s password-protected or still showing a ‘coming soon’ page. The review needs to see what you’re selling, which isn’t possible if the site is hidden.
​

You can use your test keys to build and test your checkout while your site is still private. Once it’s publicly live, submit the domain (or resubmit it if it was rejected) to start the review. The check only takes a few minutes once your site is reachable.

Do I need to upload any documents for domain verification?

No, domain verification is based on a review of your live site, not paperwork.

Can I request a manual domain review or a callback?

Not directly. Domain reviews are fully automated, so there’s no option to request a human review instead. A small number of domains get flagged automatically for extra checks, but that happens on our side, with no action needed from you.

Once a domain is approved or rejected, that decision is final; a manual review or callback afterwards won’t change it. If you think your rejection was a mistake, contact Yoco Support via our in-app chat with your business name and domain, and we’ll check it for you.

Which exact URL should I submit?

Submit the full, direct web address customers use to reach your live store, including the https:// (or http://) prefix. For example https://yourstore.co.za rather than just yourstore.co.za.

Use the exact domain or subdomain your customers actually check out on. If that’s a subdomain (for example shop.yourstore.co.za), submit that exact subdomain rather than your root domain.

If you’re on a platform like Shopify and haven’t connected your own custom domain yet, submitting your myshopify.com address is fine as a starting point. Once your custom domain is connected and live, switch to it and resubmit, since that’s the domain your review should reflect going forward.


Need more help?

If you've followed the steps above and your domain still isn't verifying, please start a conversation with a Yoco Support consultant via our in-app chat.

Did this answer your question?