Skip to main content

Stripe

Accept payments through Stripe. Once installed, this integration becomes available as a payment gateway for the Billing app.

Prerequisites​

Prerequisites

Before setting up the Stripe integration, ensure you have:

Get your API keys​

  1. Sign in to the Stripe Dashboard
  2. Open Developers > API keys
  3. Copy the Publishable key and reveal and copy the Secret key

Stripe provides separate test and live keys. Use test keys for your development environments and live keys only for production.

warning

The secret key can move money. Store it securely and never expose it in client-side code — DashX keeps it server-side.

Create a webhook endpoint​

Stripe notifies DashX of payment events — successful charges, failed payments, subscription changes — through a webhook.

  1. In the Stripe Dashboard, open Developers > Webhooks
  2. Click Add endpoint
  3. Enter the webhook URL shown on the DashX integration page after you install it
  4. Select the events you want delivered
  5. Save the endpoint, then reveal and copy its Signing secret

Connect to DashX​

  1. Log in to your DashX workspace
  2. Navigate to Settings > Integrations
  3. Click [+] to add a new integration and select Stripe
  4. Choose the environments you want to enable it for
  5. Enter the configuration below and save

Configuration​

FieldDescription
Publishable KeyStripe publishable key, safe to expose in client code.
Secret KeyStripe secret key. Used server-side to create and manage charges.
Webhook SecretSigning secret of the webhook endpoint, used to verify that incoming events genuinely came from Stripe.
tip

Install Stripe with test keys in your development environment and live keys in production, so test transactions never touch real money.