Reload a Gift Card on a Reader
POST / v1 / terminal / readers /:id / reload_gift_card
Initiates a gift card reload flow on a Reader by adding the specified amount to its balance.
Parameters
- amount integer Required The amount to add to the gift card balance, in the smallest currency unit.
- brand enum Required The brand of the gift card. Possible enum values
svsSVS gift card. - currency enum Required Three-letter ISO currency code, in lowercase. Must be a supported currency.
More parameters
- on _ behalf _ of string
Returns
Returns an updated Reader resource.
cURL
Response
{ "id": "tmr_GkoLBwI8ngxx08", "object": "terminal.reader", "action": { "api_error": null, "failure_code": null, "failure_message": null, "reload_gift_card": {}, "status": "in_progress", "type": "reload_gift_card" }, "device_sw_version": "", "device_type": "simulated_wisepos_e", "ip_address": "0.0.0.0", "label": "simulated-wpe-e448e0d1-388f-40cd-b30f-ca82de03ced6", "last_seen_at": 1783521710620, "livemode": false, "location": "tml_GczOlAw6Yx2UMe", "metadata": {}, "serial_number": "e448e0d1-388f-40cd-b30f-ca82de03ced6", "status": "online"}
Set reader display
POST / v1 / terminal / readers /:id / set_reader_display
Sets the reader display to show cart details.
Parameters
- type enum Required Type of information to display. Only
cartis currently supported. - cart object Cart details to display on the reader screen, including line items, amounts, and currency.
Returns
Returns an updated Reader resource.
Response
{ "id": "tmr_FDOt2wlRZEdpd7", "object": "terminal.reader", "action": { "failure_code": null, "failure_message": null, "set_reader_display": { "cart": { "currency": "usd", "line_items": [ { "amount": 5100, "description": "Red t-shirt", "quantity": 1 } ], "tax": 100, "total": 5200 }, "type": "cart" }, "status": "in_progress", "type": "set_reader_display" }, "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"}
Simulate a successful input collection Test helper
POST / v1 / test_helpers / terminal / readers /:id / succeed_input_collection
Use this endpoint to trigger a successful input collection on a simulated reader.
Parameters
- skip _ non _ required _ inputs enum This parameter defines the skip behavior for input collection.
Returns
Returns an updated Reader resource.
Response
{ "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"}