---
title: "Reader"
description: "A physical card reader device that can accept in-person payments."
image: "https://developer.sumup.com/og/index.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://developer.sumup.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: SumUp REST API

A physical card reader device that can accept in-person payments.

## Fields

- `id` (`Reader.id`; string, required) — Unique identifier of the reader that the payment is initiated on.
  - minLength 30; maxLength 30; example `"rdr_3MSAFM23CK82VSTT4BN6RWSQ65"`
- `name` (`Reader.name`; string, required) — Custom human-readable, user-defined name for easier identification of the reader.
  - maxLength 500; example `"Frontdesk"`
- `status` (`Reader.status`; string, required) — The status of the reader object gives information about the current state of the reader. Possible values: - `unknown` - The reader status is unknown. - `processing` - The reader is created and waits for the physical device to confirm the pairing. - `paired` - The reader is paired with a merchant account and can be used with SumUp APIs. - `expired` - The pairing is expired and no longer usable with the account. The resource needs to get recreated.
  - one of `"unknown"`, `"processing"`, `"paired"`, `"expired"`; example `"paired"`
- `device` (`Reader.device`; object, required) — Information about the underlying physical device.
  - `identifier` (`Reader.device.identifier`; string, required) — A unique identifier of the physical device (e.g. serial number).
    - example `"U1DT3NA00-CN"`
  - `model` (`Reader.device.model`; string, required) — Identifier of the model of the device.
    - one of `"solo"`, `"virtual-solo"`; example `"solo"`
- `created_at` (`Reader.created_at`; string, required) — The timestamp of when the reader was created.
  - format `date-time`; example `"2023-01-18T15:16:17Z"`
- `updated_at` (`Reader.updated_at`; string, required) — The timestamp of when the reader was last updated.
  - format `date-time`; example `"2023-01-20T15:16:17Z"`
- `metadata` (`Reader.metadata`; object, optional) — Set of user-defined key-value pairs attached to the object. Partial updates are not supported. When updating, always submit whole metadata. Maximum of 64 parameters are allowed in the object.
  - example `{}`
- `service_account_id` (`Reader.service_account_id`; string, optional) — Identifier of the system-managed service account associated with this reader. Present only for readers that are already paired. This field is currently in beta and may change.
  - format `uuid`


Source: https://developer.sumup.com/api/schemas/Reader/index.md