Creating a new application
Last updated
Was this helpful?
Last updated
Was this helpful?
Go to with your credentials.
To create a new app, click on the Add new application in the drop-down menu in the top-left corner
If you have 2 different environments (e.g.: staging & production), you should create 2 different Applications in the Purchasely Console and use 2 different API keys
This new application must be configured with a set of parameters among 3 different stages. All these parameters can be modified after the application has been created.
The mandatory parameters are :
Name: the name of the application as it will be displayed in the Purchasely Console.
The default language: this will define which language shall be used when the language on a user device is not supported by the application; ⚠️ This value can't be changed later.
Default Dashboard Currency: this is the currency unit displayed in your Purchasely Dashboards.
Default Integration Currency: this currency unit is used to send price information to the Webhook and 3rd party integrations
You can add up to 4 different stores. Step by step configuration of each store is explained below, in dedicated sections.
In this section, you can plug the Purchasely Cloud Platform with your own backend through server-to-server integration. This will allow having your backend notified through a webhook when a transaction event is received from the stores.
Fill in the Client webhook URL with the endpoint URL on your own backend where you want to receive the subscription events.
Every message send by Purchasely in the webhook is signed using a Client shared secret.
In order to connect your Apple App Store account with Purchasely, you have to provide the following parameters from the Apple App Store
App Store:
Get the value of the Bundle ID field in App Store Connect
App Store Connect > My Apps > [YOUR APP] > General > App Information
Purchasely Console:
The value of the Bundle ID should be reported in the field App Package in the Purchasely Console
Purchasely > [YOUR APPLICATION] > Settings > App Settings > Store Configuration > Apple App Store
It is required for promo code deeplinks in the paywalls.
App Store:
Get the value of the Apple ID field in App Store Connect
App Store Connect > My Apps > [YOUR APP] > General > App Information
Purchasely Console:
The value of the Apple ID should be reported in the field App Package in the Purchasely Console
Purchasely > [YOUR APPLICATION] > Settings > App Settings > Store Configuration > Apple App Store
App Store:
Get the value of the Apple ID field in App Store Connect
App Store Connect > My Apps > [YOUR APP] > Subscriptions > App-Specific Shared Secret > Manage
Purchasely Console:
The value of the App-Specific Shared Secret should be reported in the field App Package in the Purchasely Console
Purchasely > [YOUR APPLICATION] > Settings > App Settings > Store Configuration > Apple App Store
The last field Server-to-server endpoint is not mandatory. It is used to activate the real-time server-to-server notifications coming from the App Store.
In order to connect your Google Play Console account with Purchasely, you have to provide the following parameters from the Google Play Console
The value of the Package ID should be reported in the field App bundle id in your Purchasely console
Google Play Console :
Get the value of the Package ID of your App in Googe Play Console Google Play Console > All Apps > [YOUR APP]
Purchasely Console:
The value of the Apple ID should be reported in the field App Package in the Purchasely Console
Purchasely > [YOUR APPLICATION] > Settings > App Settings > Store Configuration > Play Store
This task involves two steps
Before creating the service account, make sure that the relevant Organisation is selected. The drop-down menu in the upper left corner of the screen shall match the Organisation in your Google Play Console
Name your account Purchasely to be able to easily identify it later
Give it the ID purchasely
On the following screen, set the role to "Owner"
On the following screen, create a key by clicking on the + Create a key button
Choose JSON format
Fill the content of the field "Access key" with this JSON file
The Organisation should match the one you chose under the Google Cloud Platform console
Complete those 3 steps
Set "no expiration date"
Tab: App permissions - Select the application corresponding to the app bundle id
Tab: Account permissions - Ensure the following permissions are selected :
We connect to Google Cloud Pub/Sub automatically for you by using your service account access. All you need to do is click on "Connect to Google" and follow the steps
Get the value of the Package name
The value of the Package name should be reported in the field Huawei App package id in your Purchasely console
Same procedure as "App Package Id", with the App ID property which must be put under App id in the Purchasely Console (Purchasely > Mobile Applications > [YOUR APPLICATION] > Huawei configuration)
Same procedure as "App Package Id", with the App secret property which must be put under App secret in the Purchasely Console (Purchasely > Mobile Applications > [YOUR APPLICATION] > Huawei configuration)
In the "All services" menu on top, search for "In-App Purchases" and click on it
Get the Public key property
Fill in this value under "In-App Purchases" public key in the Purchasely Console (Purchasely > Mobile Applications > [YOUR APPLICATION] > Huawei configuration)
Select App List
Select your app
Get the value of the App SKU
The value of the App SKU should be reported in the field Amazon App SKU in your Purchasely console.
These credentials are provided to you by the Purchasely Team. If you want to have your credentials created, just contact us at
If your Client Webhook is not ready when you make your configuration, we advise you to use the following value:
Refer to to know more.
Receiving the transaction events allows to
You can define the app scheme of your mobile application refer to these documents for instructions to do the same for apps. It is a required value in order to use the paywall preview feature in Purchasely Console.
Refer to for more information.
You can define the app scheme of your mobile application refer to these documents for instructions to do the same for apps. It is a required value in order to use the paywall preview feature in Purchasely Console.
Create a dedicated Service Account under Google Cloud Platform > IAM & admin > Service Account > Create a new Service Account
Grant access to the Service Account under the Google Play Console> API Access > [PURCHASELY SERVICE ACCOUNT] > Grant authorization
Open your
Go to: > > [YOUR APPLICATION]
Open your
Go to: > > [YOUR APPLICATION]
Open the
You need to give us your Amazon App Store shared Key. You can find it .
