Stripe integration

Developer assistance needed

Stripe is a payment platform that lets you accept payments and manage subscriptions. Integrating Stripe with Pushwoosh lets you track payments and subscriptions in campaigns, analyze revenue by journey and product, segment users by payment events, and use ManyMoney AI for revenue insights.

Source: Payment and subscription events are sent from Stripe to Pushwoosh.

To set up the Stripe integration with Pushwoosh, ensure the following:

• You have an active Pushwoosh account.
• You have a Stripe account.

The table below shows how Stripe entities map to Pushwoosh. This mapping is achieved by passing the corresponding fields as metadata when you create a Checkout Session (see Metadata configuration).

• Payment events (one-time payments, subscription invoices)
• Subscription events (subscription created, subscription invoice paid)

After you connect your Stripe account to Pushwoosh via Stripe Connect, Pushwoosh receives payment and subscription data from Stripe. You can link each transaction to a campaign and user or device by passing metadata when creating a Checkout Session (see Metadata configuration).

Pushwoosh creates events you can use for segmentation and analytics.

1. You connect your Stripe account to Pushwoosh once via Stripe Connect in Settings 3rd-party integrations.
2. When creating a Checkout Session, you pass metadata so the payment can be attributed later (see Metadata configuration).
3. When a payment or subscription event occurs in Stripe (e.g. charge.succeeded for one-time, invoice.paid for subscription), Stripe sends the data to Pushwoosh.
4. Pushwoosh creates the corresponding events and uses the metadata for attribution. This data appears in Finance Overview, Audience Events, and ManyMoney.

Automatically receive information about all successful payments and subscriptions.

Associate transactions with specific customer journeys by passing metadata (see Metadata configuration).

View income by campaigns, products, users, and devices.

Create segments based on payment events.

ManyMoney AI assistant automatically receives payment and subscription statistics and can make decisions based on this data.

1. Open any Pushwoosh application (Stripe account is linked to your entire account, not a specific application) and navigate to Settings 3rd-party integrations.
2. Find the Stripe card and click the LOGIN PAGE button.

[Settings page with 3rd-party integrations section and Stripe card with LOGIN PAGE button]

3. You will be redirected to the Stripe authorization page.

[Stripe authorization page with account selection and Connect button]

4. On the Stripe page, enter your email and click Continue.
5. Log in to your Stripe account (or create a new one). If you have multiple accounts, select the account you want to connect.
6. Click Connect to confirm.
7. After successful authorization, you will be redirected back to Pushwoosh. The integration status will change to Connected.

[3rd-party integrations page showing Stripe card with Connected status]

1. Go to Settings 3rd-party integrations.
2. Find the Stripe card and click the SETTINGS button.
3. In the popup window, click the Disconnect button.

[Stripe card SETTINGS popup with Disconnect button in 3rd-party integrations]

1. Log in to Stripe Dashboard.
2. Go to Settings Team and security Installed apps.
3. Find the application in the Connect Extensions section.

[Stripe Dashboard Settings, Team and security, Installed apps, Connect Extensions section]

When you disconnect through Stripe, Pushwoosh automatically receives a notification and removes the integration.

Stripe sends payment events to Pushwoosh, but without extra data Pushwoosh cannot tell which campaign or which user the payment belongs to. When you pass metadata at Checkout Session creation (campaign IDs, user or device ID, product), each payment is attributed to the right journey and user.

You then see revenue by campaign in Finance Overview, build segments by payer, and use ManyMoney with correct attribution.

Important

Metadata is passed when creating a Checkout Session depending on the payment type:

For subscriptions (invoice.paid event):

Invoice metadata  if empty  Subscription metadata

For one-time payments (charge.succeeded event):

Charge metadata (from payment_intent_data)

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_live_YOUR_SECRET_KEY: \
  -d "mode=payment" \
  -d "success_url=https://example.com/success" \
  -d "cancel_url=https://example.com/cancel" \
  -d "line_items[0][price]=price_1234567890" \
  -d "line_items[0][quantity]=1" \
  -d "payment_intent_data[metadata][journey_uuids]=bfab4bc0-b0a5-414b-befc-4aaddc429b0e" \
  -d "payment_intent_data[metadata][user_id]=user_12345" \
  -d "payment_intent_data[metadata][device_id]=hwid_abc123" \
  -d "payment_intent_data[metadata][product_id]=prod_premium" \
  -d "payment_intent_data[metadata][product_name]=Premium Plan"

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_live_YOUR_SECRET_KEY: \
  -d "mode=subscription" \
  -d "success_url=https://example.com/success" \
  -d "cancel_url=https://example.com/cancel" \
  -d "line_items[0][price]=price_monthly_premium" \
  -d "line_items[0][quantity]=1" \
  -d "subscription_data[metadata][journey_uuids]=bfab4bc0-b0a5-414b-befc-4aaddc429b0e" \
  -d "subscription_data[metadata][user_id]=user_12345" \
  -d "subscription_data[metadata][device_id]=hwid_abc123" \
  -d "subscription_data[metadata][product_name]=Monthly Premium"

After successful integration, a new Finance Overview dashboard appears in the Dashboards section. There you can view Gross Revenue and New Subscriptions statistics broken down by campaigns (journey).

[Finance Overview dashboard in Statistics with Gross Revenue and New Subscriptions by campaign]

For more detailed information, visit your Stripe Dashboard.

Use Stripe events to create user segments:

1. Open Audience Segments.
2. Click Create Segment Build Segment.
3. In Add filter by, click Event.
4. Select a Stripe event from the dropdown (see the table below for available events).

Note

5. Set the condition: how many times the event occurred and the time frame (e.g. during the last 30 days, between dates).
6. Optionally narrow the segment by event attributes. The table below lists the attributes available for each event.

[Audience Segments page with Create Segment and Build Segment options]

7. To add more events, add another Event filter and choose an operator (AND or OR) between conditions.

Learn more about creating segments.

Tip

After successful Stripe integration, the ManyMoney AI assistant automatically gains access to payment and subscription statistics.

ManyMoney is available in the Dashboard interface. After you connect Stripe, payment data is available for analysis automatically. No additional configuration is required.

• Analyze revenue: answers questions about income, conversions, and campaign effectiveness.
• Compare periods: shows payment and subscription dynamics across different time intervals.
• Identify trends: detects growing and declining products and audience segments.
• Provide recommendations: suggests optimizations based on payment data.

Prompt examples