Reader
A Reader represents a physical device for accepting payment details.
Related guide: Connecting to a reader
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
. - 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.
More attributes
- objectstring
- actionnullable object
- device_
sw_ versionnullable string - ip_
addressnullable string - last_
seen_ atnullable integerPreview feature - livemodeboolean
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.
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.
Retrieve a Reader
Retrieves a Reader
object.
Parameters
No parameters.
Returns
Returns a Reader
object if a valid identifier was provided.