Understanding Qonversion Integration

It is best to understand how FunnelFox communicates with Qonversion, so that you can avoid any misunderstanding before release.

All communications can be divided into 3 actions:

1. Creating Qonversion users & identities
2. Granting entitlement to existing profile
3. Revoking entitlement from existing profile

1. Creating Qonversion users & identities

FunnelFox creates a new Qonversion user & identity, when user buys a subscription on your onboarding. Buying a consumable product will not create a new account.

So, as soon as user completes a checkout, new Qonversion profile is created.

🚧

Sandbox purchases create sandbox users

Note that sandbox purchases (done in preview onboardings) create Sandbox Qonversion users

By default, this Qonversion identities will be given a identityID equal to their email. This will later allow you to identify this user in your application.

If you'd like to, you can change identityID to any value. FunnelFox uses Qonversion User ID to notify about changes to profile.

2. Granting entitlement to existing profile

FunnelFox grants entitlement to an existing user, when user has completed a transaction associated with this subscription (initial subscription payment, successful recurrent payment, etc.)

Access level expiration date is defined by subscription period end.

By default, FunnelFox tries to grant premium entitlement. You can provide custom access level in your checkout element.

3. Revoking entitlement from existing profile

FunnelFox revokes entitlement from an existing user, when user has cancelled or paused their subscription.

If payment is overdue, Qonversion will expire access itself without any FunnelFox updates.