Skip to main content

Stripe

ProsperStack integrates with Stripe to import customer and subscription data, personalize retention experiences and apply supported subscription changes. This page describes how to connect Stripe, embed you cancellation flow and optionally sync Stripe metadata. It also provides a reference of features and properties supported by the platform integration.

Connecting Stripe​

To connect Stripe, you'll need the publishable and secret API keys. You must be an Administrator of your Stripe account to create a secret key.

Connect Stripe step 1

Copy the Publishable key and Secret key from the API keys page in your Stripe dashboard, enter both values in ProsperStack and click Connect. For more information on Stripe API keys, see the Stripe documentation.

Once your API key is accepted, you'll be redirected to Stripe to continue the connection process.

Connect Stripe step 2

After you authorize access to your Stripe account, you'll be redirected back to ProsperStack where the import process will begin automatically.

Integrating Stripe​

There are two ways to direct your customers to your ProsperStack cancellation flow:

  • JavaScript embed - Embed the ProsperStack cancellation flow in your application or website for a seamless, in-app experience. This option uses the ProsperStack JavaScript library to start a flow for the customer's subscription.

  • Customer portal - Use the hosted customer portal to integrate without writing code. Customers follow a link to the portal, verify their email address and select a subscription to manage.

Syncing Stripe metadata​

Prosper planEnterprise plan

To use customer or subscription data stored in Stripe metadata within ProsperStack, you can link metadata fields to custom properties.

Click the gear icon in the main header to open Settings, then select Integrations. Click Configure in the Stripe section.

Stripe metadata mappings

Configure new metadata mappings in the Property mappings section. Choose from either "Customer" or "Subscription" metadata, enter a Stripe metadata field property in the text box, and choose a ProsperStack custom property (or create a new one) to link the metadata field to.

When creating a custom property in ProsperStack, make sure to choose an appropriate data type (text, number, etc.). Since Stripe metadata values are always text, ProsperStack will attempt to convert the data to the type of custom property that the field is mapped to.

When you've configured your property mappings, click Save changes. ProsperStack will begin syncing your Stripe metadata with your subscriber and subscription custom fields.

Feature support reference​

Solutions

Overall support for ProsperStack solutions.

Full Partial None
Cancellation flows
Winback campaigns
Revenue recovery
Conversion incentives
Customer portal
Autopilot offers

Features

Subscription platform dependent capabilities. Features supported on every platform are not listed.

Coupons

  • Coupon offer
  • Create new coupon
  • Percentage-based coupon
  • Fixed amount coupon
  • One-time coupon
  • Indefinite coupon
  • Monthly duration coupon
  • Billing cycle coupon
  • Custom duration coupon
  • Use existing coupon
  • Apply coupon to customer
  • Replace existing coupon
  • End trial (conversion)

Plan changes

  • Plan change offer
  • Change billing frequency
  • Disable proration on immediate changes
  • Change plan at end of billing period
  • Apply coupon with plan change
  • Remove add-ons with plan change
  • Reset billing date with plan change

Upgrade

  • Upgrade offer

Downgrade

  • Downgrade offer

Modify subscription

  • Modify subscription offer
  • Modify add-on quantity
  • Modify subscription at end of billing period
  • Apply coupon with subscription modification
  • Disable proration on immediate modifications

Pause subscription

  • Pause subscription offer
  • Specify pause length
  • Pause for a period of time
  • Pause for a number of billing cycles
  • Pause indefinitely
  • Pause at end of billing period
  • Reset billing date after pause
  • Specify pause end date

Trial extension

  • Trial extension offer
  • Extend subscriptions without an active trial
  • Prorate trial extensions

Product swap

  • Product swap offer

Other offers

  • Payment recovery offer
  • Free gift offer
  • One-time purchase offer
  • Reactivation offer
  • Reschedule order offer

Subscription cancellation

  • Subscription cancellation
  • Cancel at end of billing period
  • Cancel unpaid invoices

Customer portal

  • Customer portal
  • Update billing information
  • Email login
  • View invoices

Properties

Properties available for customer segmentation.

Subscriber23

  • Active coupon ID
  • Active offer ID
  • Active subscription count
  • ARR
  • Billing location
  • Cancel reason
  • Cancel reason code
  • Days since saved
  • Email address
  • First name
  • Last name
  • LTV
  • MRR
  • Paid invoices
  • Past due amount
  • Saved date
  • Session date
  • Session domain
  • Session start date
  • Session URL
  • Shipping location
  • Status
  • Subscription plan IDs

Subscription30

  • Active coupon ID
  • ARR
  • Cancel reason
  • Cancel reason code
  • Discount fixed amount
  • Discount percentage
  • Duration (days)
  • Is free trial
  • Is past due
  • Last failure reason
  • Last payment date
  • LTV
  • MRR
  • Next billing date
  • Next retry date
  • Paid invoices
  • Past due amount
  • Past due date
  • Payment failure count
  • Payment method type
  • Session date
  • Session domain
  • Session start date
  • Session URL
  • Shipping location
  • Status
  • Trial days
  • Trial end date
  • Trial start date
  • Will renew

Products2

  • Product IDs
  • Product names

Plans5

  • Plan IDs
  • Plan interval counts
  • Plan intervals
  • Plan names
  • Plan quantities