Skip to main content

Recurly

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

Connecting Recurly​

To connect Recurly, you'll need your Recurly private API key.

Connect Recurly

Region - Choose your region, US or EU.

Private API key — You can find your Recurly private API key by navigating to Integrations → API Credentials in your Recurly account.

For more information on Recurly private API keys, see the Recurly documentation.

After clicking Connect, the import process will begin automatically.

Integrating Recurly​

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 Recurly custom fields​

Prosper planEnterprise plan

To use customer or subscription data stored in Recurly custom fields 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 Recurly section.

Recurly custom field mappings

Configure new custom field mappings in the Property mappings section. Select a custom field from your Recurly account from the dropdown on the left, then choose a corresponding custom property in ProsperStack (or create a new one) to store the data.

ProsperStack supports mapping custom fields from your Recurly account for the account and subscription data types.

When creating a custom property in ProsperStack, make sure to choose an appropriate data type (text, number, etc.). Since Recurly custom field values can be of any type, 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 Recurly custom fields with your subscriber and subscription custom properties.

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.

Subscriber22

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

Subscription28

  • 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
  • Session date
  • Session domain
  • Session start date
  • Session URL
  • Status
  • Trial days
  • Trial end date
  • Trial start date
  • Will renew

Plans6

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

Add-ons2

  • Add-on IDs
  • Add-on names