Skip to main content

Yoco & Bookem Integration

Find out how to integrate your Yoco Neo Touch or Khumo Print card machine with your Bookem account.

Updated over a week ago

Bookem is an online appointment booking platform designed for health practices and trusted by more than 1,500 practitioners across South Africa. Through the Yoco/Bookem integration, Bookem connects directly to your Yoco card machine or online payment gateway and once your client has paid, the booking system updates instantly — no manual work required.

The Yoco/Bookem integration is free to the first 100 merchants. After this, the integration will be available as part of our Accelerate Plan.

👉 New to Bookem? Sign up here.

👉 Already a Bookem user? Create your Yoco account here.

✨ The Yoco/Bookem integration is currently only available with the Neo Touch and Khumo Print card machines. If you’d like to set your practice up with one of these devices, please start a conversation with our Support Team via our in-app chat.

💡 Good to know: If you’re using a Khumo Print card machine, you must be using firmware version v1.6.0_Yoco000015 or higher. To check which version your device has installed:

  1. Tap Settings (the cog icon) on your Khumo Print.

  2. Tap About device, then check what is listed under the Firmware version heading.

✨ The Yoco/Bookem integration is available on Bookem’s Plus, Premium, and Medical pricing structures.


How to integrate Yoco and Bookem

Bookem can integrate with your Yoco card machine and/or your online payment gateway. Select the relevant option below for a step-by-step guide.

Integrating your Yoco card machine

  1. Sign in to the Bookem app on web or mobile.

  2. Once you’ve logged in, select Settings from the menu, then Payments and Invoicing.

  3. Select the Payment methods tab near the top of the screen.

  4. Select the + New payment method button.

  5. Select Yoco card machine from the list of payment methods.

  6. Give your card machine a name that’s connected to its location or the area of the business it’s used for, e.g. Front Desk, Physio, etc. so that you know which device you’re sending the payment instruction to.

  7. Toggle the Available at all locations switch to the ‘on’ position to make the card machine available for all locations – this allows you to send a payment to the device from any location.

  8. To assign the card machine to a single location, select the correct location from the dropdown list of locations you’ve created on Bookem.


    💡 Good to know: It’s best practice to link a card machine to a specific location.

  9. Select the Create button to start the integration.

  10. You’ll be redirected to the Yoco App login page. Enter the email address and password linked to your Yoco profile.

  11. Tick the box confirming that you agree to grant access to Bookem, then select the Allow button.

  12. Your Yoco and Bookem integration is now complete and your Yoco Neo Touch or Khumo Print will appear in your list of payment methods.

  13. An Edit payment method pop-up will appear, giving you the opportunity to make any changes to the card machine you have just integrated with Bookem. You can also add an additional card machine by selecting the + Add device button and following the instructions. When you've checked everything, select the Save button.


    💡 Good to know: You can edit your Yoco payment method any time you like by selecting it from your list of payment methods, making the changes, and then selecting the Save button.

✨ Once you’ve completed the integration, the home screen on your Neo Touch or Khumo Print will look slightly different – your business name will be visible, and you won’t see the keypad as the card machine is waiting for the amount to be sent from Bookem, instead of being entered manually.


Integrating your online payment gateway

  1. Sign in to the Bookem app on web or mobile.

  2. Once you’ve logged in, select Settings from the menu, then Payments and Invoicing.

  3. Select the Payment methods tab near the top of the screen.

  4. Select the + New payment method button.

  5. Select Yoco card machine from the list of payment methods.

  6. Select the link to the left of the Create button to access your public and secret keys.

  7. The link will open up the Payment Gateway page in the Yoco App (mobile or web). Copy the public and secret keys.

  8. Return to the Bookem app and paste the public and secret keys in the API Client ID and API Client Secret fields, respectively. Then select the Create button.

  9. Your Yoco and Bookem integration is now complete and your online payment gateway will appear in your list of payment methods.

  10. An Edit payment method pop-up will appear, giving you the opportunity to make any changes to the online payment gateway you have just integrated with Bookem. When you've checked everything, select the Save button.

💡 Good to know: You can edit your Yoco payment method any time you like by selecting it from your list of payment methods, making the changes, and then selecting the Save button.


Integrated payments

Whether you’re completing a card payment or an online payment, it’s quick and easy with the Yoco/Bookem integration.

Card payments

  1. Select the appointment that you would like to create an invoice and initiate payment for (or open an existing invoice).

  2. Select the New invoice button next to the client’s name.

  3. When the invoice opens up, select the Finalise button in the bottom right corner, and then the Finalise & pay option.

  4. Select the Payment method dropdown and choose the card machine you want to send the payment to.


    💡 Good to know: If you have the Available at all locations switch enabled, you’ll have the option to send the invoice to a card machine at any of your practices. However, best practice is to have each card machine linked to single location or section of your business.

  5. Once you’ve chosen the card machine, select the Capture payment button.

  6. When the Yoco pop-up appears, select the blue Pay button (the amount due for payment will also appear on the button).

  7. The screen on your Neo Touch or Khumo Print will now become active and you can ask your client to tap their card to pay.

  8. Once your client has paid (and if you are using a Khumo Print card machine), you have the option of printing a receipt for them.


Online payments

  1. Select the appointment that you would like to create an invoice and initiate payment for (or open an existing invoice).

  2. Select the New invoice button next to the client’s name.

  3. When the invoice opens up, select the Finalise button in the bottom right corner, and then the Finalise & send option.

  4. A pop-up will appear showing the message and invoice your client will receive. Select the Send button to send the email to their inbox.

  5. When your client receives the email, they’ll follow the link to open their invoice. They’ll then scan the QR code, which will take them to the Yoco payment page.

  6. When the payment page opens, your client needs to select the Yoco logo. They will then be given the option of paying with Apple or Google Pay, entering their credit or debit card details, or paying via Instant EFT.


Manual payments

The home screen on your Neo Touch or Khumo Print will look slightly different after you’ve completed the integration – your business name will be visible on the screen instead of the usual tabs.

To enable manual capture of a payment (post integration), follow these steps on the card machine:

  1. Select the Disconnect button in the top right corner of the screen.

  2. Select the Yes, disconnect button on the pop-up.

  3. When the success message appears, select the Continue button.

  4. Your card machine will display the pre-integration screen, and is now ready to capture a manual transaction.

Please note:

Selecting the Disconnect button doesn't disconnect the Yoco/Bookem integration, it just lets you capture a manual transaction outside of it.

• Manual transactions must be manually reconciled to Bookem.

💡 Good to know: When you’re ready to complete a payment using the integration, simply create a new invoice on Bookem, select your Yoco card machine as the payment method, and the device will automatically return to the post-integration screen.


How to remove the Yoco/Bookem Integration

  1. Sign in to the Bookem app on web or mobile.

  2. Once you’ve logged in, select Settings from the menu, then Payments and Invoicing.

  3. Select the Payment methods tab near the top of the screen.

  4. Select the Yoco payment method you’d like to disconnect.

  5. When the pop-up appears, select the Delete button.

  6. Confirm that you want to delete the payment method – please note that you can’t undo this action.



📅 Yoco/Bookem integration FAQs

Can I still take manual payments after I’ve integrated my card machine with Bookem? Yes, you can, but you’ll need to disconnect your device temporarily to do so. It’s also important to note that manual transactions won’t sync with your Bookem invoice – you’ll have to manually match this payment to the invoice once it’s been processed.

I have more than one device at my practice, can I integrate all of them? Yes, you can. Once you’ve added your first card machine, you can select it from your list of payment methods and choose the + Add device button to add another card machine.

I’m seeing a device at one of my practices that is located at another practice. What should I do? This is probably happening because you enabled the Available at all locations switch when you were setting up the card machine. To fix this, you’ll need to delete the card machine from your list of payment methods and then repeat the integration, but select a specific location this time round.

I’ve activated the integration, but my card machine screen looks exactly the same and I can still take manual payments. Did the integration work? The integrated screen is only activated once you’ve created an invoice, and select the integrated device as the payment method.

If I disconnect my card machine to take a manual payment, will I need to complete the integration again? No, the integration stays active and as soon as you select the card machine as the payment method on your next invoice, the payment will automatically be sent to your device for payment.

I’m experiencing a Bookem issue. Who can I speak to? Please contact the Bookem Support Team on their existing channels, or visit https://bookem.com/help.

I’m experiencing a Yoco issue. Who can I speak to? Please start a conversation with our Support Team via our in-app chat.

I’m experiencing an issue, but I’m not sure who to speak to? You are welcome to contact either Bookem or Yoco – we’ve synced our support channels to make sure that your query is handled by the correct team.

Did this answer your question?