> ## Documentation Index
> Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe

> Set up and use the Stripe integration with Hyper AI

Auth type: API

<Info>
  For general setup steps, permissions, and troubleshooting, start with: [App Integrations](/integrations/overview).
</Info>

## Connect Stripe

1. Go to Settings → Apps in Hyper
2. Select Stripe → Connect New
3. Provide your Stripe API key (use a restricted key with only needed permissions)

## Common capabilities

* Automate payment processing and subscription billing
* Monitor revenue and generate financial reports
* Manage customers, invoices, and payment methods

## Use in Chat

Enable Stripe in the tool selector. Ask your agent to check payment status, generate reports, or manage subscriptions.

## Use in Agents

Add Stripe to an agent's toolkits and select the connection. Mark sensitive actions (create charges, refunds) as "requires approval."

## Use in Flows

Automate billing, revenue reporting, and payment workflows using Stripe action nodes.

## Troubleshooting

* API errors: verify your API key and account configuration
* Permission denied: ensure the API key has the required scopes

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                    | Description                                                              |
| ------------------------- | ------------------------------------------------------------------------ |
| Calculate Mrr             |                                                                          |
| Cancel Subscription       |                                                                          |
| Create Coupon             |                                                                          |
| Create Customer           | Create a new Stripe customer with email, name, phone, and description    |
| Create Invoice            |                                                                          |
| Create Payment Intent     |                                                                          |
| Create Payment Link       | Create a Stripe payment link for a price ID                              |
| Create Price              |                                                                          |
| Create Product            | Create a new Stripe product with a name and optional description         |
| Create Refund             |                                                                          |
| Create Subscription       |                                                                          |
| Finalize Invoice          |                                                                          |
| Get Balance               | Get your Stripe account balance (available and pending amounts)          |
| Get Charge                | Get a Stripe charge by ID, including refund and dispute status           |
| Get Customer              | Get a Stripe customer by ID, including balance and metadata              |
| Get Invoice               | Get a Stripe invoice by ID, including line items and payment URLs        |
| Get Payment Intent        | Get a Stripe payment intent by ID                                        |
| Get Price                 | Get a Stripe price by ID                                                 |
| Get Product               | Get a Stripe product by ID                                               |
| Get Subscription          | Get a Stripe subscription by ID, including items, plan, and trial info   |
| List Balance Transactions |                                                                          |
| List Charges              |                                                                          |
| List Coupons              | List Stripe coupons                                                      |
| List Customers            | List or search Stripe customers. Optionally filter by email              |
| List Invoices             |                                                                          |
| List Payment Intents      | List Stripe payment intents. Optionally filter by customer               |
| List Payment Links        | List Stripe payment links. Optionally filter by active status            |
| List Prices               |                                                                          |
| List Products             | List Stripe products. Optionally filter by active status                 |
| List Refunds              |                                                                          |
| List Subscriptions        |                                                                          |
| Update Customer           | Update an existing Stripe customer. Only provided fields are changed     |
| Update Product            | Update a Stripe product. Only provided fields are changed                |
| Update Subscription       |                                                                          |
| Void Invoice              | Void a Stripe invoice. Only open or uncollectible invoices can be voided |