What is Ownership?

Ownership records track the relationship between a user and an app. An ownership record can be created by calling the OpenChannel Install App API and has three different types: full, subscription or trial. First, full ownership records indicate that the user fully owns the app and is not required to make any additional payments in order to retain ownership of the app. Subscription ownership records indicate that the user must pay a recurring fee in order to maintain ownership of the app. Last, trial ownership records indicate that the user is able to use the app for a specified amount of time before the ownership license expires.

Things to know

The ownership relation can be considered a final goal for a marketplace. Basically it is a license given to a user which indicates that ‘a user is now an owner of this app’. Although the concept is simple, it is important to understand the different types of ownership and the flows and processes in place to get to them, as this will directly impact the user experience.

Ownership Status

Ownership record has four statuses but only three of which are used when building a custom billing integration: active, cancelled and uninstalled. 

  • An active ownership status signifies that the license is valid and the app is installed. 
  • A cancelled ownership status signifies that the license is no longer valid and the user must re-purchase a license to reinstall the app. 
  • An uninstalled ownership status signifies that the license is no longer valid and the user has uninstalled the app. Apps with a Free or Single model may be re-installed without additional cost.

Locating Ownership Records

The ownership records can be easily located in your dashboard in a few different ways:

From the Ownership menu, from an app and from a user. To see the general ownership information, just click on the “Ownership” tab on the left menu.

Once at the ownership page, you will be able to view the full list of ownerships. You can navigate between the different ownership statuses: Active, Pending, Uninstalled and Cancelled. You can also create a new ownership record directly from your dashboard, by clicking on “Create Ownership”.

To find the ownership records of a specific app, open the app page and then select the ownership tab. This will show you a list of all the ownership records associated with this app.

Finally, if you want to see the ownership records of a particular user organization, select “Users” and them “Organizations” on the left side menu.

Open the organization page and select the Ownership tab to see a list of apps owned by this organization.

Managing Ownership Records

Once your marketplace is created, the ownership management can be automated using the API and be under the responsibility of users and developers, according to the logic that is used on your website. However, from the dashboard, you can also manage those records. Creating new ownerships, cancelling ownerships and uninstalling apps.

To create a new ownership, just click on the “Create Ownership” button, on the Ownership page.

You will need to select a user from your user list to apply that ownership to, select the app and the model of ownership. The model will vary depending on the app you choose. Click on “Create” and the record will appear on your ownership list.

To cancel an ownership record or uninstall an app, select the ownership record you would like to manage and click on the settings button. You will see the two different options.

Cancelling the ownership record will immediately remove the user license. If it is a paid app, for example, that user would need to repurchase the app. Uninstalling however, would just make that user lose access to the app, however, it would be possible to reinstall it at no extra cost.