Collector Devices

A CollectorDevice is an Android phone that runs the YnoPay collector app. It listens for mobile money SMS and forwards parsed transactions to the API.

Create a Collector Device

POST /v1/collector_devices
ParamTypeRequired
labelstringYes
fingerprintstringNo

Response

The response includes a one-time secret field (HMAC key). Store it securely — it cannot be retrieved again.

{
  "id": "dev_abc123",
  "object": "collector_device",
  "label": "Collector Phone 1",
  "secret": "hmac_secret_...",
  "display": "hma...ret",
  "active": true
}

List Collector Devices

GET /v1/collector_devices