Stripe Connection

Connects your agent to Stripe for payments and billing data. Read customers, payment intents, invoices, subscriptions, charges, refunds, and disputes. Write operations (create customer, issue refund) require confirmation.

Authentication

API secret key.

• secret_key — Stripe API key (sk_live_... or sk_test_...)

Use a restricted key with only the permissions your agent needs.

Endpoints

Customers

• GET /v1/customers — List customers with email search
• GET /v1/customers/{id} — Get customer detail with payment methods
• POST /v1/customers — Create customer (requires confirmation)

Payment Intents

• GET /v1/payment_intents — List payment intents with status filter
• GET /v1/payment_intents/{id} — Get payment intent detail

Invoices

• GET /v1/invoices — List invoices by customer, status, date
• GET /v1/invoices/{id} — Get invoice detail with line items

Subscriptions

• GET /v1/subscriptions — List active subscriptions
• GET /v1/subscriptions/{id} — Get subscription detail with plan info

Charges

• GET /v1/charges — List charges with date range and status
• GET /v1/charges/{id} — Get charge detail with payment method

Refunds

• GET /v1/refunds — List refunds
• POST /v1/refunds — Issue refund (requires confirmation)

Disputes

• GET /v1/disputes — List open disputes
• GET /v1/disputes/{id} — Get dispute detail with evidence deadline

Rules

• Rate limit: 100 requests/second (Stripe standard)
• Refund issuance always requires confirmation with amount and reason
• The agent uses test-mode keys in development environments automatically
• All financial operations logged to audit trail with amounts