Reader
A Reader represents a physical device for accepting payment details.
Related guide: Connecting to a reader
- POST/
The Reader object
Attributes
- idstring
Unique identifier for the object.
- device_
typeenum Type of reader, one of
bbpos_wisepad3
,stripe_m2
,bbpos_chipper2x
,bbpos_wisepos_e
,verifone_P400
,simulated_wisepos_e
, ormobile_phone_reader
.Possible enum valuesbbpos_chipper2x
bbpos_wisepad3
bbpos_wisepos_e
mobile_phone_reader
simulated_wisepos_e
stripe_m2
verifone_P400
- labelstring
Custom label given to the reader for easier identification.
- locationnullable stringExpandable
The location identifier of the reader.
- metadataobject
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- serial_
numberstring Serial number of the reader.
- statusnullable enum
The networking status of the reader.
Possible enum valuesoffline
online
More attributes
- objectstring
- actionnullable object
- device_
sw_ versionnullable string - ip_
addressnullable string - last_
seen_ atnullable integerPreview feature - livemodeboolean
{
"id": "tmr_FDOt2wlRZEdpd7",
"object": "terminal.reader",
"action": null,
"device_sw_version": "",
"device_type": "simulated_wisepos_e",
"ip_address": "0.0.0.0",
"label": "Blue Rabbit",
"last_seen_at": 1681320543815,
"livemode": false,
"location": "tml_FDOtHwxAAdIJOh",
"metadata": {},
"serial_number": "259cd19c-b902-4730-96a1-09183be6e7f7",
"status": "online"
}
Create a Reader
Creates a new Reader
object.
Parameters
- registration_
codestringRequired A code generated by the reader used for registering to an account.
- labelstring
Custom label given to the reader for easier identification. If no label is specified, the registration code will be used.
- locationstringRequired
The location to assign the reader to.
- metadataobject
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata
.
Returns
Returns a Reader
object if creation succeeds.
{
"id": "tmr_FDOt2wlRZEdpd7",
"object": "terminal.reader",
"action": null,
"device_sw_version": "",
"device_type": "simulated_wisepos_e",
"ip_address": "0.0.0.0",
"label": "Blue Rabbit",
"last_seen_at": 1681320543815,
"livemode": false,
"location": "tml_FDOtHwxAAdIJOh",
"metadata": {},
"serial_number": "259cd19c-b902-4730-96a1-09183be6e7f7",
"status": "online"
}
Update a Reader
Updates a Reader
object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
Parameters
- labelstring
The new label of the reader.
- metadataobject
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata
.
Returns
Returns an updated Reader
object if a valid identifier was provided.
{
"id": "tmr_FDOt2wlRZEdpd7",
"object": "terminal.reader",
"action": null,
"device_sw_version": "",
"device_type": "simulated_wisepos_e",
"ip_address": "0.0.0.0",
"label": "Blue Rabbit",
"last_seen_at": 1681320543815,
"livemode": false,
"location": "tml_FDOtHwxAAdIJOh",
"metadata": {
"order_id": "6735"
},
"serial_number": "259cd19c-b902-4730-96a1-09183be6e7f7",
"status": "online"
}
Retrieve a Reader
Retrieves a Reader
object.
Parameters
No parameters.
Returns
Returns a Reader
object if a valid identifier was provided.
{
"id": "tmr_FDOt2wlRZEdpd7",
"object": "terminal.reader",
"action": null,
"device_sw_version": "",
"device_type": "simulated_wisepos_e",
"ip_address": "0.0.0.0",
"label": "Blue Rabbit",
"last_seen_at": 1681320543815,
"livemode": false,
"location": "tml_FDOtHwxAAdIJOh",
"metadata": {},
"serial_number": "259cd19c-b902-4730-96a1-09183be6e7f7",
"status": "online"
}