Installation

What it is

An installation is the link between an Application and a Merchant context. It stores the installed application's status, scopes, and creation time.

Optionally, if an event subscription is registered on the application, the installation in the 3rd party merchant account will include a webhook subscription for the event types provided in the event subscription.

Why it exists

It exists so an application can be enabled for 3rd party merchant accounts. It turns an application definition into an active integration instance with its own status and permissions.

How it relates to other concepts

An installation belongs to an application and is associated with a merchant context. Applications can have many installations. Updating an installation can change its scopes, status, and event subscription event codes.