Skip to navigation
Checkout API

Testing

Learn how to test the Checkout API using your test keys and test card details in the Yoco App.

Test keys

Sign in to the Yoco App and open the Checkout API integration. Tap How to connect and copy your Test public key and Test secret key from the Test keys tab.

Test keys are available immediately. Domain verification isn’t required to test your integration.

Test card details

After configuring your integration with test keys, open Test card details in the Yoco App to complete a test payment.

Go live

Before you accept real payments, verify your business website and switch to your live keys.

1Deploy your integration to your production website URL.
2

Open the Checkout API integration in the Yoco App, tap How to connect, and under Verified Domains tap Add domain. Enter your website URL and wait for approval.

3

Once your domain is verified, copy your Live public key and Live secret key from the Live keys tab.

4

Replace your test keys with your live keys in your server-side integration to start accepting real payments.

Live keys stay locked until at least one domain is verified under Verified Domains in How to connect.

Important notes

  • Test transactions don’t appear on your portal dashboard or sales report.
  • Payments less than R2.00, which is 200 cents, aren’t accepted.