Connect to a reader

Connect your application to a Stripe Terminal reader.

Note

If you haven’t chosen a reader yet, compare the available Terminal readers and choose one that best suits your needs.

Stripe provides a simulated server-driven reader so you can develop and test your app and simulate Terminal payments, without connecting to physical hardware.

Create a simulated reader

To create a simulated reader, use the designated registration code (simulated-wpe or simulated-s700) when registering the reader. This registration code creates a simulated WisePOS E or Stripe S700 reader object in a sandbox only. You can register the simulated reader using the Stripe API:

This returns a reader object representing your simulated reader:

{
  "id": "tmr_xxx",
  "object": "terminal.reader",
  "device_sw_version": "",
  "device_type": "simulated_wisepos_e",
  "ip_address": "0.0.0.0",
  "label": "simulated-wpe-xxx-xxx-xx-xxx",
  "livemode": false,
  "location": "tml_xxx",
  "serial_number": "simulated-wpe-xxx-xxx-xx-xxx",
  "status": "online"
}

Query your simulated reader

The simulated reader behaves like a real reader. You can retrieve its information from the reader endpoint:

{
  "id": "tmr_xxx",
  "object": "terminal.reader",
  "action": null,
  "device_sw_version": "",
  "device_type": "simulated_wisepos_e",
  "ip_address": "0.0.0.0",
  "label": "simulated-wpe-xxx-xxx-xx-xxx",
  "livemode": false,
  "location": "tml_xxx",
  "metadata": {
  },
  "serial_number": "simulated-wpe-xxx-xxx-xx-xxx",
  "status": "offline"
}

Next steps

You’ve connected your application to the reader. Next, collect your first Stripe Terminal payment.

The BBPOS and Chipper™ name and logo are trademarks or registered trademarks of BBPOS Limited in the United States or other countries. The Verifone® name and logo are either trademarks or registered trademarks of Verifone in the United States and/or other countries. Use of the trademarks doesn’t imply any endorsement by BBPOS or Verifone.