Subscription Redirect Flow

Experimental ⚠️

In addition to purchasing the app through the app store, you as a software provider can place a link on your website so customers can install and subscribe to your software.

The flow covers registration, email confirmation, selection of an organisation, and selection of a plan, if applicable. When the subscription is successfully completed, customers will be taken back to your website. This works like Installing Organisations (opens new window).

The subscription flow works like a regular Redirect Flow (opens new window). You only need to change what scopes are passed to the URL. You can redirect the user to this URL:

https://hub.sandbox.zaikio.com/oauth/authorize?client_id={CLIENT_ID}&redirect_uri={REDIRECT_URI}&scope=Org.subscription_create

When you pass the scope Org.subscription_create a subscription checkout flow will be automatically initialized. The created access token will include all desired scopes for organisations.

It is also possible to pre-select a plan for the user by passing the name of the plan: Org.subscription_create.my_plan

You can also pre-select the organisation if it is known: Org/a4cd0243-2575-4d3f-b143-4c85f959808d.subscription_create

It is possible for reviewed apps to initialize a subscription flow with another app. In your application place a link where users can subscribe for a specific active app. Use the same link as mentioned above and add the name of the app you want to subscribe for to the scope Org.subscription_create_some_app

You can preselect a plan for the user by passing the name of the plan: Org.subscription_create_some_app.my_plan or preselect an organisation.

When the subscription is successfully completed, users will be redirected back to the app they were redirected from. The redirect_uri you have been passed to the link.