Skip to content

Simulate a successful input collection ​

Use this endpoint to trigger a successful input collection on a simulated reader.

Returns ​

Returns an updated Reader resource.

Parameters ​

  • skip_non_required_inputs (enum, optional) This parameter defines the skip behavior for input collection.
curl
curl https://api.stripe.com/v1/test_helpers/terminal/readers/{{READER_ID}}/succeed_input_collection \
  -u "<<YOUR_SECRET_KEY>>" \
  -d skip_non_required_inputs=none

Response ​

json
{
  "id": "tmr_FDOt2wlRZEdpd7",
  "object": "terminal.reader",
  "action": {
    "failure_code": null,
    "failure_message": null,
    "collect_inputs": {
      "inputs": [
        {
          "type": "signature",
          "custom_text": {
            "title": "Signature",
            "description": "Please sign below",
            "submit_button": "Submit",
            "skip_button": "Skip"
          },
          "required": false,
          "signature": {
            "value": "file_abcd"
          }
        },
        {
          "type": "selection",
          "custom_text": {
            "title": "Selection",
            "description": "Please select one"
          },
          "required": true,
          "selection": {
            "choices": [
              {
                "style": "primary",
                "value": "choice_1"
              },
              {
                "style": "secondary",
                "value": "choice_2"
              }
            ],
            "value": "choice_1"
          }
        },
        {
          "type": "email",
          "custom_text": {
            "title": "Enter your email",
            "description": "We'll send updates on your order and occasional deals",
            "submit_button": "Submit",
            "skip_button": "Skip"
          },
          "required": false,
          "email": {
            "value": "someone@example.com"
          }
        }
      ]
    },
    "status": "succeeded",
    "type": "collect_inputs"
  },
  "device_deploy_group": null,
  "device_sw_version": null,
  "device_type": "bbpos_wisepos_e",
  "ip_address": "192.168.2.2",
  "label": "Blue Rabbit",
  "livemode": false,
  "location": null,
  "metadata": {},
  "serial_number": "123-456-789",
  "status": "online"
}

Stripe API Reference - Self-contained docs reference, refreshed 2026-05-18