In order to initiate a payment on a Solo device using Cloud API, the device must be enrolled with the Merchant account. This enrollment process is what we call a Reader Pairing.

The pairing process starts on the device side by generating the pairing code.

Generating the Pairing Code

1. Turn on the Reader

3. Go to Connections

4. Select API

Solo device API pairing initiation screen.

5. Tap on Connect

With the pairing code, proceed with Pair the Reader to the Merchant Account.

Pair the Reader to the Merchant Account

cURL

1
curl -X POST \
2
  https://api.sumup.com/v0.1/merchants/{merchant_code}/readers \
3
  -H "Authorization: Bearer $SUMUP_API_KEY" \
4
  -H 'Content-Type: application/json' \
5
  -d '{
6
        "pairing_code": "918MPQHZ"
7
      }'

The response contains a JSON body with the details of the created reader resource. What you need to note in the response is the identifier of the resource - you will need it for all operations that you perform with the resource.

1
{
2
  "id": "rdr_3MSAFM23CK82VSTT4BN6RWSQ65",
3
  "name": "Frontdesk",
4
  "status": "processing",
5
  "device": {
6
    "identifier": "200100010001",
7
    "model": "solo"
8
  },
9
  "created_at": "2023-05-09T14:50:20.214Z",
10
  "updated_at": "2023-05-09T14:52:58.714Z"
11
}

Wait for Confirmation

If the client successfully performed the previous steps, the device will show a confirmation screen:

Solo device API pairing confirmation screen.

and transit to the Idle Screen:

Unpairing a Solo reader

In order to unpair a reader from the merchant account, two steps are required:

Unlink Reader from the Merchant account (via Readers API);
Disconnect Reader (manually via Solo)

Unlink Reader

cURL

1
curl -X DELETE \
2
  https://api.sumup.com/v0.1/merchants/{merchant_code}/readers/{id} \
3
  -H "Authorization: Bearer $SUMUP_API_KEY"

Diconnect Reader

2. Go to Connections

3. Select API

Solo device active API connection screen.

4. Tap on Disconnect

Your Solo device is now disconnected.

Pairing a Solo reader