How to Accept Credit Cards with Loyverse POS and Yoco


1. Connecting the Card Reader
2. Processing Payments
3. Reports


This feature only works on iOS devices.

Loyverse POS merchants can accept credit card payments via Yoco, and it is available to customers in South Africa.

Before connecting a card reader, you need to create an account in Yoco and receive the device. Integration with Loyverse POS works on the card readers YOCO PRO, YOCO-GO, and YOCO-Neo.

1. Connecting the Card Reader

Log in to the Back Office, click the ‘Settings’ menu and then ‘Payment types.' Click the ‘Add payment type’ button to add a new type of payment.

‘Add payment type’ button

In the ‘Create payment type’ window, select the ‘Yoco’ payment type from the drop-down list.  Save your changes when done.

select the ‘Yoco’ payment type

Turn on your Yoco card reader. On your mobile device, go to the Settings and turn on the Bluetooth. You will see the Yoco card reader in the devices list.
Tap on the Yoco device to connect.

Yoco card reader in the Bluetooth devices list

Tap the ‘Pair’ button on the mobile device and ‘OK’ on the card reader.

the ‘Pair’ button on the mobile device

The device will change its status to ‘Connected’.

The device will change its status to ‘Connected’.

Then launch the Loyverse POS and go to Settings > Payment Types.

Settings at Loyverse POS

Tap the ‘Yoco’ button for account settings.

‘Yoco’ button for account settings.

Login in to your Yoco account by entering the Email and Password, then tap ‘Login’.

Login in Yoco account

You will see the logged-in status of your Yoco account.

logged-in status

Now you are ready to accept card payments.

2. Processing Payments


Add items to the ticket and press ‘Charge’.

Tap ‘Yoco’ as the payment type.

‘Yoco’ as the payment type

Loyverse POS will wait for a response from the card reader, and you will see an invitation to insert/swipe card on the card reader.

invitation to insert/swipe card on the card reader

Insert the card with a chip into the bottom slot or swipe at the top slot of the card reader and give it to the customer to enter the PIN.

Yoco card reader with bank card

enter the PIN message


If the transaction is successful, you will see the ‘payment approved’ window. Tap ‘Done’ to continue.

‘payment approved’ window

Loyverse POS will display the screen with 'Total paid amount'.

'Total paid amount'

In case of an error in the transaction, you will see an error message.

an error message an error message

You can retry the payment or tap the ‘Cancel payment’ button. In this case, you will return to the ‘select payment type’ screen. You can ask the customer to choose a different type of payment (for example ‘Cash’) or try another card.


You can only refund the whole amount of the transaction. The card reader is not used in the refund process.

In the Loyverse POS, go to the ‘Receipts’ menu, and tap on the desired receipt.

Then tap ‘Refund’.

‘Refund’ button in the receipts list

Select all items on the receipt that were paid via card (on the left side) to move them to the ‘Refund receipt’ list (on the right side), and tap the ‘Refund’ button.

‘Refund’ button

At the ‘Authorise refund’ screen, type in the Yoco Email and password and tap ‘Authorise’.

Yoco autorise refund screen

3. Reports

You can view the total number of transactions performed with Yoco. In the Back Office, select the ‘Sales by payment type’ report.

total number of transactions