1. Should be registered as a Yoco merchant via the Yoco website
  2. Received a Yoco card terminal [Go]
  3. Integrators: Requested a SDK Integration Key via SDK Integration Application form to obtain a secret key
  4. minSDKVersion: API
  5. targetSdkVersion: API

Project Configuration

You will need to add the following permissions, which are required by the Yoco SDK and should be aded to your Manifest.xml

android.permission.BLUETOOTH_ADMINRequired for Terminal state changes
android.permission.BLUETOOTHRequired for connecting to Terminals
android.permission.ACCESS_FINE_LOCATIONRequired for security of transactions
android.permission.ACCESS_COARSE_LOCATIONRequired for security of transactions
android.permission.ACCESS_WIFI_STATERequired for sending/receiving data from Yoco servers
android.permission.ACCESS_NETWORK_STATERequired for sending/receiving data from Yoco servers
android.permission.INTERNETRequired for sending/receiving data from Yoco servers
android.permission.ACCESS_WAKE_LOCKRequired for processing of Transactions

Initialising the YocoSDK

You will first need to Initialise the YocoSDK in your app. This allows the SDK to setup everything it needs to perform its tasks.

import com.yoco.payment_ui_sdk.YocoSDK
class SampleApplication : Application() {
override fun onCreate() {
// Initialises Yoco Payment UI SDK
context = applicationContext

The YocoSDK should ONLY be initialised once per application lifecycle.