Skip to main content

Stripe Integration - Setup Guide

Connect your Stripe account to Goodweek to manage payments, customers, subscriptions, invoices, and billing data directly from your AI workspace.

A
Written by Antoine Stempien

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

  1. In Goodweek, go to Integrations.

  2. Find Stripe and click Connect.

  3. You will be redirected to Stripe, where you will be asked to sign in and authorize access.

  4. 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.

References

Did this answer your question?