Connect your Stripe account to Goodweek to manage payments, customers, subscriptions, invoices, and billing data directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within Stripe, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Stripe integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
The Stripe integration uses OAuth 2.0 and does not require any admin-level approval within Stripe before users can connect.
⚠️ Important: Live vs. Test mode
Stripe operates in two modes: live and test. When connecting, make sure you are authorizing from the correct mode for your intended use. Actions performed through Goodweek will affect the live Stripe environment unless you are connecting a test account.
User Connection
In Goodweek, go to Integrations.
Find Stripe and click Connect.
You will be redirected to Stripe, where you will be asked to sign in and authorize access.
Click Connect to grant access and return to Goodweek.
Important Notes
Each user must connect their own Stripe account individually.
Goodweek will operate in the mode (live or test) of the account you authorize.
You can revoke Goodweek's access at any time from Stripe Dashboard → Settings → Connected applications → Composio → Disconnect.
Available Tools
Tool | Description | Type |
Create Customer | Creates a new customer in Stripe, required for creating charges or subscriptions. | Write |
Retrieve Account | Retrieves detailed information for the authenticated Stripe account. | Read |
Create Payment Intent | Creates a Stripe PaymentIntent to initiate and process a customer's payment. | Write |
Confirm Payment Intent | Confirms a PaymentIntent to finalize the payment with the provided payment method. | Read |
Capture Payment Intent | Captures funds from an authorized PaymentIntent when it is in requires_capture status. | Read |
Retrieve Invoice | Retrieves a specific invoice by its ID. | Read |
Create Invoice | Creates a new draft Stripe invoice for a customer. | Write |
Create Invoice Item | Adds a line item to a draft invoice before finalization. | Write |
Add Lines to Invoice | Adds multiple line items to an existing draft Stripe invoice in one call. | Write |
Finalize Invoice | Finalizes a draft invoice making it open and ready for collection. | Read |
Get Invoice Line Items | Retrieves a paginated list of line items for a specific invoice. | Read |
Create Credit Note | Issues a credit note to adjust a finalized invoice's amount. | Write |
Preview Credit Note | Previews a credit note without creating it in Stripe. | Read |
Create Customer Subscription | Creates a new subscription for an existing Stripe customer with items and pricing. | Write |
Create Subscription | Creates a highly configurable subscription supporting multiple items, trials, and discounts. | Write |
Retrieve Customer Subscription | Retrieves a specific subscription for a customer. | Read |
Create Subscription Item | Adds a new item to an existing subscription without changing existing items. | Write |
Create Refund | Creates a full or partial refund in Stripe targeting a charge or payment intent. | Write |
Create Charge Refund | Creates a refund for a previously created charge. | Write |
Create Coupon | Creates a new discount coupon with percentage or fixed amount discount. | Write |
Create Promotion Code | Creates a customer-redeemable promotion code linked to an underlying coupon. | Write |
Create Product | Creates a new product in Stripe to represent a good or service. | Write |
Create a Price | Creates a new Stripe Price for a product defining its charges (one-time or recurring). | Write |
Create Checkout Session | Creates a Stripe Checkout Session for a hosted payment or subscription page. | Write |
Create Payment Link | Creates a shareable hosted checkout URL that can be sent directly to customers. | Write |
Create Setup Intent | Creates a SetupIntent to collect payment method permissions for future use. | Write |
List Events | Retrieves a list of Stripe events from the past 30 days with filtering and pagination. | Read |
Retrieve Event | Retrieves event details for a specific Stripe webhook event by ID. | Read |
Create a Report Run | Creates and begins executing a Stripe financial report asynchronously. | Write |
List Billing Meters | Retrieves a list of billing meters configured for usage-based billing. | Read |
Create Billing Meter | Creates a billing meter for tracking usage events for metered pricing. | Write |
Create Billing Portal Session | Creates a billing portal session URL for customers to manage their subscriptions and invoices. | Write |
Create Tax Calculation | Computes taxes for a customer purchase before creating an order. | Write |
Create Transfer | Creates a transfer to move funds between Stripe accounts as part of Connect. | Write |
Cancel Payment Intent | Cancels a PaymentIntent that is no longer needed. | ⚠️ Destructive |
Cancel Subscription | Cancels a customer's active Stripe subscription. | ⚠️ Destructive |
Delete Customer | Permanently deletes a customer and cancels their active subscriptions. | ⚠️ Destructive |
Delete Draft Invoice | Permanently deletes a draft invoice. This action cannot be undone. | ⚠️ Destructive |
Void Invoice | Permanently marks a finalized invoice as void, preventing collection. | ⚠️ Destructive |
Delete Product | Deletes a product from Stripe. Only possible if no prices are associated. | ⚠️ Destructive |
Use Cases
Create invoices and collect payments from conversations. Draft Stripe invoices, add line items, finalize them, and create payment links directly from Goodweek — useful when billing clients on demand without navigating the Stripe dashboard.
Manage subscriptions and customers. Create new subscriptions, add products to existing ones, and retrieve subscription details for specific customers from Goodweek to handle billing changes quickly.
Issue refunds and credit notes. Create refunds for charges or payment intents and issue credit notes against finalized invoices from Goodweek when handling customer disputes or billing corrections.
Monitor events and billing activity. Retrieve recent Stripe events and filter them by type from Goodweek to investigate payment issues, subscription changes, or webhook activity without using the Stripe dashboard.
Troubleshooting
Actions are affecting the wrong Stripe environment
Verify that you authorized Goodweek against the correct Stripe account (live or test). Disconnect and reconnect if needed, making sure to select the right account during the Stripe authorization flow.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Stripe integration from the Goodweek Admin Panel under the Integrations tab.
