Connect iKhokha to your shop

Take payments through your own iKhokha account on your ShopEazy shop and at your till. Where to find your keys, what to paste, and what the errors mean.

Connect your iKhokha account and shoppers can pay on your shop, and by Scan to pay at your till. Already using iKhokha at your counter? Use the same account.

ShopEazy never holds your money. Shoppers pay iKhokha, and iKhokha pays you out on the terms you have with them. You pay iKhokha's fees on your own account, and ShopEazy's platform fee per online sale depends on your plan.

Before you start

An iKhokha account. An API key from your iKhokha dashboard: an Application ID and its secret.
Owner or admin access to your ShopEazy business. Other team members can't connect or remove a payment provider.
Your email inbox. Connecting a provider asks you to confirm it's you with a 6-digit code we email you.

What your shoppers can pay with: Cards and EFT, as set up in your iKhokha account.

Connect iKhokha

In ShopEazy, click Settings in the sidebar, then Payments. You can also press Ctrl+K (Cmd+K on a Mac) and search for "Payments".
Under Ways to pay, find Card via iKhokha and click Connect. Already have a provider connected? Click Add next to Add a way to pay and pick iKhokha.
Follow the steps in the drawer, below.
Click Connect iKhokha and enter the code we email you.

Step 1: Create an API key in iKhokha

Sign in to your iKhokha dashboard and create an API key. The connect drawer's Open iKhokha button takes you to the right page.
Copy the Application ID, and the secret straight away: iKhokha only shows the secret once, when you create the key.

Step 2: Paste them here

Application key: the Application ID on your API key.
Application secret: the secret iKhokha showed you when you created the key.

When it works, iKhokha shows under Ways to pay with an On badge, and your shop starts taking payments through it.

Check that it worked

iKhokha has no test keys, so a test order is a real card payment. Refund it in your iKhokha dashboard afterwards.

Click Manage next to iKhokha on the Payments page to see Live at checkout, your Payments · 30 days and Recent payments.

If something goes wrong

"Those keys were rejected by iKhokha. Check the App ID and App key." Check the Application ID is in Application key and the secret is in Application secret, not the other way round. Lost the secret? Create a new API key in iKhokha.

iKhokha shows "Not in use" Your shop charges through one card provider at a time. If another provider was connected first, checkout keeps using it. Disconnect that one to switch to iKhokha.

For problems shoppers see at checkout, see Fix payment provider and checkout problems.

Good to know

No iKhokha account yet? The Sign up link next to iKhokha on the Payments page opens iKhokha's sign-up.

Your secret keys are encrypted when you save them, and ShopEazy never shows them again.

To disconnect, open iKhokha from Settings → Payments and click Disconnect. We ask you to confirm, then forget your keys. If iKhokha was the one at checkout and another provider is connected, checkout switches to it. Otherwise shoppers can't pay by card until you connect one again, so connect the new one first if you're switching.