Integration Keys

Integration keys are used by all of your SDKs and APIs to secure and link your payments to your business.

1. Getting a hold of your keys

Before you can get started, you will need to create a Yoco account.

Once you have a Yoco account, you can fetch your integration keys in the Yoco Business Portal under Sell Online → Payment Gateway.

You will receive 4 keys in total; a pair of test public and secret keys for testing, and a pair of live mode public and secret keys for real transactions.

If you want to test the SDK without signing up, you can use the anonymous test keys found here.

2. Testing

We give you the pair of test keys to use while you are integrating Yoco. When making a test payment you must also use our test card details and no real money will change hands.

Your test transactions will not appear in your Sales History. In addition, test transactions cannot be refunded using our API.

3. Further info

Your secret key should be stored securely on your server and is used to authenticate API calls made by your server to Yoco.

Your public key is included in your front-end website and is used to initialise the Yoco Web SDK.

You should never include your secret key in your front-end code or on your website.