​

Stripe Actions Reference

Complete reference of actions your ChatCrafterAI agent can perform with Stripe integration.

​

Payment Actions

​

Create Payment Intent

Initiate a charge for a customer. Required parameters:

• Amount (in cents, e.g., 2500 for $25.00)
• Currency (e.g., “usd”)
• Description (what the payment is for)

Optional parameters:

• Customer ID
• Metadata (custom tracking fields)
• Idempotency key (prevents duplicate charges)

​

Process Payment

Complete a payment transaction. Required: Customer card on file Returns: Transaction ID, status, amount charged

​

Get Customer Balance

Retrieve current balance owed by customer. Required: Customer ID or email Returns: Current balance amount

​

Invoice Actions

​

Create Invoice

Generate a new invoice for a customer. Required parameters:

• Customer ID
• Line items (description, amount)

Optional: Due date, metadata

​

Send Invoice

Email invoice to customer and track in Stripe. Required: Invoice ID Returns: Delivery status

​

List Invoices

View customer’s invoice history. Required: Customer ID or email Returns: Array of invoices with status and amounts

​

Check Invoice Status

Get current status of specific invoice. Required: Invoice ID Returns: Status (paid, draft, overdue, void)

​

Customer Actions

​

Get Customer Info

Retrieve customer details. Required: Customer ID or email Returns: Name, email, balance, default payment method, metadata

​

Look Up by Email

Find customer using email address. Required: Email address Returns: Customer object with all details

​

Update Customer

Modify customer information. Required: Customer ID Can update: Email, metadata, default payment method, description

​

Subscription Actions

​

Create Subscription

Start a recurring subscription for customer. Required parameters:

• Customer ID
• Price ID (Stripe product price)

Optional: Trial period, billing cycle anchor, metadata

​

Cancel Subscription

End a recurring subscription. Required: Subscription ID Options: Cancel immediately or at period end

​

Update Subscription

Modify existing subscription. Can change: Price/plan, pause/resume, billing cycle, metadata

​

List Subscriptions

Show all active subscriptions for customer. Required: Customer ID Returns: Array of subscriptions with status and details

​

Refund Actions

​

Issue Full Refund

Refund entire charge amount. Required: Charge ID Returns: Refund ID, status, amount

​

Issue Partial Refund

Refund portion of original charge. Required: Charge ID, amount to refund Returns: Refund ID, status, remaining balance

​

Check Refund Status

Track refund progress. Required: Refund ID Returns: Status (succeeded, pending, failed)

​

Webhook Actions

Your agent automatically receives and processes these Stripe events:

• payment_intent.succeeded - Payment completed successfully
• customer.subscription.updated - Subscription changed
• invoice.payment_succeeded - Invoice paid
• charge.refunded - Refund processed

Webhooks can trigger agent actions when events occur, enabling automated responses.

​

Common Action Patterns

Payment Flow:

1. User asks to pay invoice
2. Agent creates payment intent
3. Agent returns secure payment link
4. Customer completes payment
5. Webhook confirms to agent
6. Agent sends confirmation message

Balance Check:

1. User asks about balance
2. Agent looks up customer by email
3. Agent retrieves balance
4. Agent displays: “Your balance is $250”

Subscription Management:

1. User requests upgrade
2. Agent shows available plans
3. User selects plan
4. Agent creates/updates subscription
5. Agent confirms: “Your subscription is active”

​

Action Response Data

All actions return structured data including:

• Transaction ID - Unique identifier
• Status - Current state (succeeded, processing, failed)
• Amount - Money involved (in cents)
• Customer details - Name, email, ID
• Timestamp - When action occurred
• Error messages - If action failed

​

Safety Features

• Test mode - Practice without real charges
• Amount verification - Confirms amounts before processing
• Idempotency keys - Prevents accidental duplicate charges
• Webhook signing - Ensures events are authentic from Stripe
• Automatic retries - Handles temporary network issues

​

Next Steps

See real-world implementations in the Examples Guide.