Stripe Integration

Qonversion supports Stripe web payments. This integration allows Qonversion to manage cross-platform subscribers' access and provide analytics for payments made via Stripe on your website.

📘

In case you are selling digital goods, you can not promote web payment options in your mobile app as it goes against the app stores' policies.

1. Connect your Stripe account to Qonversion

Click the Stripe button in the Stores tab of your project settings in Qonversion dashboard.

Sign in using your existing Stripe account or create a new one. These options will be offered during the integration process.

📘

Qonversion only retrieves information from Stripe and does not update anything in your Stripe account. You have complete control over your Stripe account and can revoke access whenever you want.

2. Create Stripe products

You can create products using Stripe dashboard:

A product can have multiple prices — more about setting up Stripe products in Stripe official documentation

🚧

Qonversion currently supports only Package and Standard pricing models.

You can use the Stripe dashboard to create a subscription manually, but the most common way is to use Stripe checkout on your website to get the customer payment information and send it to your server. You can check the details of working with Stripe subscriptions using REST API here

3. Add your Stripe products to Qonversion

📘

Skip this step if you are not using the Qonversion Subscription Management mode.

Add your Stripe products to the dashboard to manage cross-platform subscribers' access.

Make sure that the Stripe Product Identifier that you provide to Qonversion matches your Product ID in Stripe. You can find your Product ID in Stripe via the product page.

4. Send Stripe purchases to Qonversion

For instance, let's use the Prebuilt subscription page with Stripe Checkout

1. Add param product_id (in our case it's equal to prod_LnoFij9PJ9OvK2) to the Success URL.
   /success?session_id={CHECKOUT_SESSION_ID}&product_id=prod_LnoFij9PJ9OvK2

2. In the Success URL handler retrieve the Stripe Session data via Stripe API. Let's name it stripe_session.
   Additional information about success page customization is specified on the Stripe docs page Customise your success page

3. Send your Stripe purchase result to Qonversion via the API endpoint.

curl --request POST \
  --url https://api.qonversion.io/v3/users/{user_id}/purchases \
  --header 'Authorization: Bearer PROJECT_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  	"currency":"USD",
    "price":"11.99",
    "stripe_store_data": {
    	"subscription_id":"sub_XXXXXX",
    	"product_id":"prod_LnoFij9PJ9OvK2"
    }
  }'

Qonversion updates data on Stripe subscriptions automatically. Usually, it happens with a slight delay compared to its actual state in Stripe.

Limitations

Supported subscription billing models

Only the Package and Standard pricing subscription billing models are supported. We will be expanding to more pricing options soon!

You can read more about subscription billing models in Stripe official documentation.

Proration payments

Subscription changes such as upgrading or downgrading can result in prorated charges. Qonversion will not account for these charges in revenue calculations. It would be best to disable these options manually via the Stripe dashboard. You can also disable them by setting the proration_behavior attribute value to false via the Stripe API.

Cancellations

Stripe has two subscription cancellation options:

1. Immediate cancellation: subscription cancels immediately with or without any proration option
2. Cancellation at the end of the period: The subscription cancels at the end of the current billing period (similar to in-app subscriptions on the app stores).

Qonversion supports both options, but the revenue calculation for immediate cancellation will disregard the proration option.

Coupons, discounts, and price changes

Qonversion will take into account price changes, including manual updates or coupons, applied by customers in subscription revenue calculation.

Refunds

Qonversion tracks only full refunds. Proration or partial refunds are not supported currently.