Skip to main content

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.

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.

User-Level Integration (OAuth)​

In addition to the organization-level API key integration, individual users can connect their personal Stripe account to Suger via OAuth. This allows Suger's AI service to read your Stripe data (customers, invoices, payments, subscriptions) on your behalf.

Connect Your Stripe Account​

  1. Navigate to your Suger Console Settings.
  2. Under user-level integrations, find Stripe (User) and click Connect Stripe.
  3. You will be redirected to Stripe's authorization page. Review the permissions and click Connect.
  4. After authorization, you will be redirected back to Suger with a confirmation that your account is connected.

Note: This grants Suger read-only access to your Stripe account data. Suger cannot create charges, modify customers, or perform any write operations on your behalf.

Requirements​

  • An organization-level Stripe integration (API key) must be set up for full functionality. The user-level OAuth connection stores your Stripe account identifier, but API calls are made using the organization's platform key with the Stripe-Account header.

Disconnect Your Stripe Account​

To disconnect your personal Stripe account:

  1. Navigate to your Suger Console Settings.
  2. Find your Stripe user integration and click Delete.
  3. The OAuth credential will be removed from Suger, and the connection will be revoked on Stripe's side.