Suger

Stripe

Allow Suger to manage your Stripe seamlessly, including customers, payments.

Overview

Stripe is a popular online payment processing platform that allows businesses and individuals to accept payments over the internet. It provides a range of tools and services that simplify the process of setting up and managing online payments, including online payment gateway integration, merchant account services, and developer-friendly APIs.

By connecting Suger to your stripe, we can build customized automation workflow in manage of customer, coupon and payment.

Create Integration

In your Suger Console Integration, you will see the Stripe integration connection. Click the Connect button to create an integration with your stripe instance. This will open an dialog for you to input.

The Public Key and Secret Key can be found in the stripe dashboard apikeys.

Stripe Test Mode

If you want to use stripe in your test environment with stripe test mode, use keys in stripe test mode dashboard test apikeys.
You may need a test suger organization to build a complete test environment. Or you can create the integration with test mode keys and then switch to live mode keys after the test is finished.

Use Restricted Keys

You can use stripe restricted keys with specific access limits and permissions for greater security. The Restricted key provided to the suger must have the following permissions.

  • Core resources
    • Balance - Read
    • Charges - Write
    • Customers - Write
    • Customer session - Write
    • Disputes - Write
    • Events - Read
    • PaymentIntents - Write
    • PaymentMethods - Write
    • Products - Write
    • SetupIntents - Write
    • Sources - Write
  • All Checkout resources - Write
  • All Billing resources - Write
  • All Order resources - Write
  • Webhook resources
    • Webhook Endpoints-Write

See more about stripe keys stripe docs.

Once the integration process is finished, you can proceed by clicking the VERIFY button. This action triggers the Suger service to test the connection to the APIs of your stripe instance. If everything is configured correctly, the integration status will be updated as VERIFIED.

Create User Integration (MCP)

This integration acts on behalf of the individual user (a member of the Stripe account), not the organization. Each team member connects their own Stripe account so that Suger AI operates with their personal permissions. See Stripe MCP documentation for details.

The Stripe MCP integration uses a dedicated OAuth 2.1 app registered with Stripe. The token it issues is scoped exclusively to mcp.stripe.com and is the credential used by Suger AI.

Prerequisites

Enable MCP access for your Stripe account before connecting:

  1. Go to your Stripe Dashboard → Settings → Team and security.
  2. Under the MCP access section, enable MCP access for your account.

Connect

  1. In the User Integrations section, find Stripe MCP (User) and click Connect Stripe Account.
  2. You will be redirected to Stripe to authorize the MCP-scoped application.
  3. After authorization, you will be redirected back to Suger. The integration status is set to Verified automatically.

Create User Integration (OAuth)

Connect your personal Stripe account to Suger via Stripe Connect OAuth.

  1. In the User Integrations section, find Stripe (User) and click Connect Stripe.
  2. You will be redirected to Stripe’s authorization page. Review the permissions and click Connect.
  3. After authorization, you will be redirected back to Suger with the integration connected.

Note: If your Stripe account is already controlled by another platform, this connection will fail. Since June 2021, Stripe does not allow a second platform using read_write OAuth scope to connect to a controlled account. You must disconnect from the controlling platform first. See Stripe’s OAuth reference for details.

Suger AI Tools

Suger AI connects to Stripe’s MCP server using the integration’s credentials.

MCP server URL: https://mcp.stripe.com

Two integration levels are supported. The user-level MCP token takes precedence when both are connected.

IntegrationLevelAuth
StripeOrgAPI key
Stripe MCP (User)UserOAuth (PKCE)

See Stripe MCP documentation for the full list of available tools.

Edit Integration

You can edit the integration to update the following fields:

  • Enable Entitlement End Soon Notification: When enabled, specify the number of days (10-60) before an entitlement ends to trigger notifications. Suger will send an initial notification when Stripe Marketplace entitlements approach ending, followed by reminders every 5 days. To configure recipients, follow the email notification configuration guide and add the scope END_SOON.ENTITLEMENT.

Delete Integration

The stripe integration can be deleted like all other integrations. Once the deletion is triggered, no time window or methods to recover.