Hand-off a PaymentIntent to a Reader

POST / v1 / terminal / readers /:id / process_payment_intent

Initiates a payment flow on a Reader. See process the payment for more details.

Parameters

• payment _ intent string Required The ID of the PaymentIntent to process on the reader.

More parameters

• process _ config object

Returns

Returns an updated Reader resource.

Response

{ "id": "tmr_FDOt2wlRZEdpd7", "object": "terminal.reader", "action": { "failure_code": null, "failure_message": null, "process_payment_intent": { "payment_intent": "pi_3NtEKRLkdIwHu7ix3crEirSx" }, "status": "in_progress", "type": "process_payment_intent" }, "device_sw_version": "2.37.2.0", "device_type": "simulated_wisepos_e", "ip_address": "0.0.0.0", "label": "Blue Rabbit", "last_seen_at": 1695408232226, "livemode": false, "location": "tml_FDOtHwxAAdIJOh", "metadata": {}, "serial_number": "259cd19c-b902-4730-96a1-09183be6e7f7", "status": "online"}

Hand-off a SetupIntent to a Reader

POST / v1 / terminal / readers /:id / process_setup_intent

Initiates a SetupIntent flow on a Reader. See Save directly without charging for more details.

Parameters

• allow _ redisplay enum Required This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. Possible enum values always Use always to indicate that this payment method can always be shown to a customer in a checkout flow. limited Use limited to indicate that this payment method can’t always be shown to a customer in a checkout flow. For example, it can only be shown in the context of a specific subscription. unspecified This is the default value for payment methods where allow_redisplay wasn’t set.
• setup _ intent string Required The ID of the SetupIntent to process on the reader.

More parameters

• process _ config object

Returns

Returns an updated Reader resource.

Response

{ "id": "tmr_FDOt2wlRZEdpd7", "object": "terminal.reader", "action": { "failure_code": null, "failure_message": null, "process_setup_intent": { "setup_intent": "seti_1NtEXHLkdIwHu7ixcBcUmqfe" }, "status": "in_progress", "type": "process_setup_intent" }, "device_sw_version": "2.37.2.0", "device_type": "simulated_wisepos_e", "ip_address": "0.0.0.0", "label": "Blue Rabbit", "last_seen_at": 1681320543815, "livemode": false, "location": "tml_FDOtHwxAAdIJOh", "metadata": {}, "serial_number": "259cd19c-b902-4730-96a1-09183be6e7f7", "status": "online"}

Print content on a reader

POST / v1 / terminal / readers /:id / print_content

To print content on a reader’s embedded printer, send a multipart/form-data request with the PNG or the related setting image file to print. Use black and white images for best results.

See the integration guide for more details.

NOTE: This endpoint lives on the files.stripe.com subdomain instead of api.stripe.com.

Parameters

• image map Required The image file to print. Must be a PNG or the related setting not exceeding 100 kB in size. Use black and white images for best results. Specifications must follow RFC 2388, which defines file transfers for the multipart/form-data protocol.
• type enum Required The type of content to print. Currently supports image. Possible enum values image Print an image on the reader’s embedded printer.

Returns

Returns an updated Reader resource.

cURL

Response

{ "id": "tmr_FDOt2wlRZEdpd7", "object": "terminal.reader", "action": { "failure_code": null, "failure_message": null, "print_content": { "image": { "created_at": 1748971913, "filename": "image.png", "size": 15864, "type": "png" }, "type": "image" }, "status": "in_progress", "type": "print_content" }, "device_sw_version": "2.37.2.0", "device_type": "simulated_wisepos_e", "ip_address": "0.0.0.0", "label": "Blue Rabbit", "last_seen_at": 1695166525506, "livemode": false, "location": "tml_FDOtHwxAAdIJOh", "metadata": {}, "serial_number": "259cd19c-b902-4730-96a1-09183be6e7f7", "status": "online"}