> For the complete documentation index, see [llms.txt](https://docs.dos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dos.ai/dosclaw/plugins-and-connectors/finance/stripe.md).

# Stripe Payments

Connect Stripe to DOSClaw AI agents. Generate dynamic checkout links directly in conversation threads, check customer subscription statuses, verify payment receipts, and automate customer billing inquiries.

## Capabilities & MCP Tools

| MCP Tool                    | Operation | Description                                                                                        |
| --------------------------- | --------- | -------------------------------------------------------------------------------------------------- |
| `create_payment_link`       | Write     | Generate an instant Stripe Checkout URL with customized line items, currency, and tax calculation. |
| `check_subscription_status` | Read      | Look up customer subscription state (`active`, `past_due`, `canceled`) by email or customer ID.    |
| `get_invoice_detail`        | Read      | Retrieve payment invoices, line items, and PDF download links.                                     |
| `verify_payment_intent`     | Read      | Verify successful payment webhook execution before granting digital access.                        |

***

## Prerequisites

1. An active **Stripe account** (`https://stripe.com`).
2. Administrator access to retrieve your Stripe Restricted API Key or connect via Stripe Connect.

***

## Setup Guide

### Step 1: Connect via Stripe API Key

1. In the **Stripe Dashboard**, go to **Developers** $\rightarrow$ **API keys**.
2. Click **Create restricted key**:
   * `Checkout Sessions`: Write
   * `Payment Intents`: Read
   * `Customers`: Read
   * `Subscriptions`: Read
   * `Invoices`: Read
3. Copy the restricted key (`rk_live_...` or `rk_test_...` for testing).
4. In **DOS.AI Dashboard**, open **Integrations** $\rightarrow$ **Stripe Payments**.
5. Paste your restricted key and click **Save & Connect**.
6. DOS-Me validates the key by retrieving account information and stores the credential in encrypted Vault storage.

### Step 2: Configure Webhook (Optional but Recommended)

To enable automatic fulfillment when a customer pays:

1. In Stripe Dashboard, add a webhook destination:

   ```
   https://api.dos.ai/v1/webhooks/stripe
   ```
2. Select events: `checkout.session.completed`, `customer.subscription.updated`.
3. Copy the **Signing secret** (`whsec_...`) and paste it into DOS.AI.

***

## Example Sales Concierge Flow

> **Customer**: "I'd like to sign up for your quarterly consulting package for $450."\
> **Agent**: Calls `create_payment_link({ "amount": 45000, "currency": "usd", "description": "Quarterly Consulting Package" })`\
> **Reply**: "Great! You can complete your secure checkout here: [Pay $450 with Stripe Checkout](https://buy.stripe.com/demo123). Once finished, I will automatically send you the calendar invite for our kickoff call!"

***

## Troubleshooting

| Issue                                    | Cause                                         | Solution                                                                            |
| ---------------------------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------- |
| "Key does not have required permissions" | Restricted key missing write scope            | In Stripe Dashboard, ensure `Checkout Sessions` has **Write** permission.           |
| Currency not supported                   | Currency code not enabled on merchant account | Check Stripe Dashboard $\rightarrow$ Settings $\rightarrow$ Currencies.             |
| Test mode transactions in production     | Using `rk_test_...` key                       | Replace test key with live restricted key (`rk_live_...`) when going to production. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dos.ai/dosclaw/plugins-and-connectors/finance/stripe.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.