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 test mode only. You can register the simulated reader using the Stripe API:

Command Line

curl https://api.stripe.com/v1/terminal/readers \
  -u "sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d location={{LOCATION_ID}} \
  -d registration_code=simulated-wpe

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:

Command Line

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx \
  -u "sk_test_VePHdqKTYQjKNInc7u56JBrQ
:"

{
  "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.

Collect payments

The BBPOS and Chipper™ name and logo are trademarks or registered trademarks of BBPOS Limited in the United States and/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 does not imply any endorsement by BBPOS or Verifone.

Welcome to the Stripe Shell! Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Log in to your Stripe account and press Control + Backtick (`) on your keyboard to start managing your Stripe resources in test mode. - View supported Stripe commands: - Find webhook events: - Listen for webhook events: - Call Stripe APIs: stripe [api resource] [operation] (e.g., )