> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.yoco.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.yoco.com/_mcp/server.

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](https://app.yoco.com/) and open the
[Checkout API integration](https://app.yoco.com/manage/yoco-connect/integration?name=checkout_api).
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](https://app.yoco.com/yoco-connect/how-to-connect?integration=checkout_api) 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.

Deploy your integration to your production website URL.

Open the [Checkout API integration](https://app.yoco.com/manage/yoco-connect/integration?name=checkout_api)
in the Yoco App, tap **How to connect**, and under **Verified Domains** tap **Add domain**. Enter
your website URL and wait for approval.

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

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

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

## Important notes

> **Note**
>
> * Test transactions **don't** appear on your portal dashboard or sales report.
> * Payments less than `R2.00`, which is 200 cents, aren't accepted.