stripe-openapi-agent/skills/terminal/SKILL.md

name, description

name	description
terminal-routes	Handle 26 OpenAPI operation(s) under /v1/terminal for the terminal route group.

terminal API Routes

Handle 26 OpenAPI operation(s) under /v1/terminal for the terminal route group.

Use the generated operation tools to make real API calls. Do not invent API responses. If a tool reports missing setup, return the exact setup field name to the caller. For write, update, or delete operations, state the intended action before calling the tool.

Operations

get_terminal_configurations

• Operation ID: get_terminal_configurations
• Route: GET /v1/terminal/configurations
• Mode: READ
• Summary: List all Configurations
• Parameters:
  • ending_before in query
  • expand in query
  • is_account_default in query
  • limit in query
  • starting_after in query
• Body: JSON request body accepted.

post_terminal_configurations

• Operation ID: post_terminal_configurations
• Route: POST /v1/terminal/configurations
• Mode: WRITE
• Summary: Create a Configuration
• Body: JSON request body accepted.

delete_terminal_configurations_configuration

• Operation ID: delete_terminal_configurations_configuration
• Route: DELETE /v1/terminal/configurations/{configuration}
• Mode: WRITE
• Summary: Delete a Configuration
• Parameters:
  • configuration in path required
• Body: JSON request body accepted.

get_terminal_configurations_configuration

• Operation ID: get_terminal_configurations_configuration
• Route: GET /v1/terminal/configurations/{configuration}
• Mode: READ
• Summary: Retrieve a Configuration
• Parameters:
  • configuration in path required
  • expand in query
• Body: JSON request body accepted.

post_terminal_configurations_configuration

• Operation ID: post_terminal_configurations_configuration
• Route: POST /v1/terminal/configurations/{configuration}
• Mode: WRITE
• Summary: Update a Configuration
• Parameters:
  • configuration in path required
• Body: JSON request body accepted.

post_terminal_connection_tokens

• Operation ID: post_terminal_connection_tokens
• Route: POST /v1/terminal/connection_tokens
• Mode: WRITE
• Summary: Create a Connection Token
• Body: JSON request body accepted.

get_terminal_locations

• Operation ID: get_terminal_locations
• Route: GET /v1/terminal/locations
• Mode: READ
• Summary: List all Locations
• Parameters:
  • ending_before in query
  • expand in query
  • limit in query
  • starting_after in query
• Body: JSON request body accepted.

post_terminal_locations

• Operation ID: post_terminal_locations
• Route: POST /v1/terminal/locations
• Mode: WRITE
• Summary: Create a Location
• Body: JSON request body accepted.

delete_terminal_locations_location

• Operation ID: delete_terminal_locations_location
• Route: DELETE /v1/terminal/locations/{location}
• Mode: WRITE
• Summary: Delete a Location
• Parameters:
  • location in path required
• Body: JSON request body accepted.

get_terminal_locations_location

• Operation ID: get_terminal_locations_location
• Route: GET /v1/terminal/locations/{location}
• Mode: READ
• Summary: Retrieve a Location
• Parameters:
  • expand in query
  • location in path required
• Body: JSON request body accepted.

post_terminal_locations_location

• Operation ID: post_terminal_locations_location
• Route: POST /v1/terminal/locations/{location}
• Mode: WRITE
• Summary: Update a Location
• Parameters:
  • location in path required
• Body: JSON request body accepted.

post_terminal_onboarding_links

• Operation ID: post_terminal_onboarding_links
• Route: POST /v1/terminal/onboarding_links
• Mode: WRITE
• Summary: Create an Onboarding Link
• Body: JSON request body accepted.

get_terminal_readers

• Operation ID: get_terminal_readers
• Route: GET /v1/terminal/readers
• Mode: READ
• Summary: List all Readers
• Parameters:
  • device_type in query
  • ending_before in query
  • expand in query
  • limit in query
  • location in query
  • serial_number in query
  • starting_after in query
  • status in query
• Body: JSON request body accepted.

post_terminal_readers

• Operation ID: post_terminal_readers
• Route: POST /v1/terminal/readers
• Mode: WRITE
• Summary: Create a Reader
• Body: JSON request body accepted.

delete_terminal_readers_reader

• Operation ID: delete_terminal_readers_reader
• Route: DELETE /v1/terminal/readers/{reader}
• Mode: WRITE
• Summary: Delete a Reader
• Parameters:
  • reader in path required
• Body: JSON request body accepted.

get_terminal_readers_reader

• Operation ID: get_terminal_readers_reader
• Route: GET /v1/terminal/readers/{reader}
• Mode: READ
• Summary: Retrieve a Reader
• Parameters:
  • expand in query
  • reader in path required
• Body: JSON request body accepted.

post_terminal_readers_reader

• Operation ID: post_terminal_readers_reader
• Route: POST /v1/terminal/readers/{reader}
• Mode: WRITE
• Summary: Update a Reader
• Parameters:
  • reader in path required
• Body: JSON request body accepted.

post_terminal_readers_reader_cancel_action

• Operation ID: post_terminal_readers_reader_cancel_action
• Route: POST /v1/terminal/readers/{reader}/cancel_action
• Mode: WRITE
• Summary: Cancel the current reader action
• Parameters:
  • reader in path required
• Body: JSON request body accepted.

post_terminal_readers_reader_collect_inputs

• Operation ID: post_terminal_readers_reader_collect_inputs
• Route: POST /v1/terminal/readers/{reader}/collect_inputs
• Mode: WRITE
• Summary: Collect inputs using a Reader
• Parameters:
  • reader in path required
• Body: JSON request body accepted.

post_terminal_readers_reader_collect_payment_method

• Operation ID: post_terminal_readers_reader_collect_payment_method
• Route: POST /v1/terminal/readers/{reader}/collect_payment_method
• Mode: WRITE
• Summary: Hand off a PaymentIntent to a Reader and collect card details
• Parameters:
  • reader in path required
• Body: JSON request body accepted.

post_terminal_readers_reader_confirm_payment_intent

• Operation ID: post_terminal_readers_reader_confirm_payment_intent
• Route: POST /v1/terminal/readers/{reader}/confirm_payment_intent
• Mode: WRITE
• Summary: Confirm a PaymentIntent on the Reader
• Parameters:
  • reader in path required
• Body: JSON request body accepted.

post_terminal_readers_reader_process_payment_intent

• Operation ID: post_terminal_readers_reader_process_payment_intent
• Route: POST /v1/terminal/readers/{reader}/process_payment_intent
• Mode: WRITE
• Summary: Hand-off a PaymentIntent to a Reader
• Parameters:
  • reader in path required
• Body: JSON request body accepted.

post_terminal_readers_reader_process_setup_intent

• Operation ID: post_terminal_readers_reader_process_setup_intent
• Route: POST /v1/terminal/readers/{reader}/process_setup_intent
• Mode: WRITE
• Summary: Hand-off a SetupIntent to a Reader
• Parameters:
  • reader in path required
• Body: JSON request body accepted.

post_terminal_readers_reader_refund_payment

• Operation ID: post_terminal_readers_reader_refund_payment
• Route: POST /v1/terminal/readers/{reader}/refund_payment
• Mode: WRITE
• Summary: Refund a Charge or a PaymentIntent in-person
• Parameters:
  • reader in path required
• Body: JSON request body accepted.

post_terminal_readers_reader_set_reader_display

• Operation ID: post_terminal_readers_reader_set_reader_display
• Route: POST /v1/terminal/readers/{reader}/set_reader_display
• Mode: WRITE
• Summary: Set reader display
• Parameters:
  • reader in path required
• Body: JSON request body accepted.

post_terminal_refunds

• Operation ID: post_terminal_refunds
• Route: POST /v1/terminal/refunds
• Mode: WRITE
• Summary: Create a refund using a Terminal-supported device.
• Body: JSON request body accepted.