# Readers

## Endpoints

### Create a Reader

- [POST /v1/terminal/readers](https://docs.stripe.com/api/terminal/readers/create.md)

### Update a Reader

- [POST /v1/terminal/readers/:id](https://docs.stripe.com/api/terminal/readers/update.md)

### Retrieve a Reader

- [GET /v1/terminal/readers/:id](https://docs.stripe.com/api/terminal/readers/retrieve.md)

### List all Readers

- [GET /v1/terminal/readers](https://docs.stripe.com/api/terminal/readers/list.md)

### Delete a Reader

- [DELETE /v1/terminal/readers/:id](https://docs.stripe.com/api/terminal/readers/delete.md)

### Activate a Gift Card on a Reader

- [POST /v1/terminal/readers/:id/activate_gift_card](https://docs.stripe.com/api/terminal/readers/activate_gift_card.md)

### Cancel the current reader action

- [POST /v1/terminal/readers/:id/cancel_action](https://docs.stripe.com/api/terminal/readers/cancel_action.md)

### Cashout a Gift Card on a Reader

- [POST /v1/terminal/readers/:id/cashout_gift_card](https://docs.stripe.com/api/terminal/readers/cashout_gift_card.md)

### Check a Gift Card Balance on a Reader

- [POST /v1/terminal/readers/:id/check_gift_card_balance](https://docs.stripe.com/api/terminal/readers/check_gift_card_balance.md)

### Collect inputs using a Reader

- [POST /v1/terminal/readers/:id/collect_inputs](https://docs.stripe.com/api/terminal/readers/collect_inputs.md)

### Confirm a PaymentIntent on the Reader

- [POST /v1/terminal/readers/:id/confirm_payment_intent](https://docs.stripe.com/api/terminal/readers/confirm_payment_intent.md)

### Hand off a PaymentIntent to a Reader and collect card details

- [POST /v1/terminal/readers/:id/collect_payment_method](https://docs.stripe.com/api/terminal/readers/collect_payment_method.md)

### Hand-off a PaymentIntent to a Reader

- [POST /v1/terminal/readers/:id/process_payment_intent](https://docs.stripe.com/api/terminal/readers/process_payment_intent.md)

### Hand-off a SetupIntent to a Reader

- [POST /v1/terminal/readers/:id/process_setup_intent](https://docs.stripe.com/api/terminal/readers/process_setup_intent.md)

### Print content on a reader

- [POST /v1/terminal/readers/:id/print_content](https://docs.stripe.com/api/terminal/readers/print_content.md)

### Refund a Charge or a PaymentIntent in-person

- [POST /v1/terminal/readers/:id/refund_payment](https://docs.stripe.com/api/terminal/readers/refund_payment.md)

### Reload a Gift Card on a Reader

- [POST /v1/terminal/readers/:id/reload_gift_card](https://docs.stripe.com/api/terminal/readers/reload_gift_card.md)

### Set reader display

- [POST /v1/terminal/readers/:id/set_reader_display](https://docs.stripe.com/api/terminal/readers/set_reader_display.md)

### Simulate a successful input collection

- [POST /v1/test_helpers/terminal/readers/:id/succeed_input_collection](https://docs.stripe.com/api/terminal/readers/succeed_input_collection.md)

### Simulate an input collection timeout

- [POST /v1/test_helpers/terminal/readers/:id/timeout_input_collection](https://docs.stripe.com/api/terminal/readers/timeout_input_collection.md)

### Simulate presenting a payment method

- [POST /v1/test_helpers/terminal/readers/:id/present_payment_method](https://docs.stripe.com/api/terminal/readers/present_payment_method.md)

## Events

- `terminal.reader.action_failed`
Occurs whenever an action sent to a Terminal reader failed.

- `terminal.reader.action_succeeded`
Occurs whenever an action sent to a Terminal reader was successful.

- `terminal.reader.action_updated`
Occurs whenever an action sent to a Terminal reader is updated.

A Reader represents a physical device for accepting payment details.

Related guide: [Connecting to a reader](https://docs.stripe.com/terminal/payments/connect-reader.md)