Creating a new application
Log in to the console
Go to Purchasely console with your credentials.
These credentials are provided to you by the Purchasely Team. If you want to have your credentials created, just contact us at hello@purchasely.com
Creating a new App
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.
1. Create a new application

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
2. Plug it with the stores

You can add up to 4 different stores. Step by step configuration of each store is explained below, in dedicated sections.
3. Plug it with your backend

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.
Refer to Webhook documentation to know more.
Receiving the transaction events allows to manage user entitlements and access control.
Configuring the Apple App Store parameters
In order to connect your Apple App Store account with Purchasely, you have to provide the following parameters from the Apple App Store

App bundle id
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

Apple ID
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 Scheme
You can define the app scheme of your mobile application refer to these documents for instructions to do the same for iOS apps. It is a required value in order to use the paywall preview feature in Purchasely Console.
Shared App Secret

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
Store Kit 2
By default Purchasely SDK uses Store Kit 2, you need to grant us a specific access to your In-App Purchases for our service to work Please follow this guide to configure Store Kit 2 with Purchasely
Server to Server notifications
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.
Refer to Server-to-server notifications documentation for more information.
Configuring the Google Play Store parameters
In order to connect your Google Play Console account with Purchasely, you have to provide the following parameters from the Google Play Console

Android App Bundle ID

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
App Scheme
You can define the app scheme of your mobile application refer to these documents for instructions to do the same for Android apps. It is a required value in order to use the paywall preview feature in Purchasely Console.
Access Key (JSON)
This task involves three steps
Enable API on Google Cloud
You will need to enable 2 APIs on Google Cloud Console
Create or select your existing project
Enable Android Developer API
Enable Developer Reporting API
Create a new Service Account
Create a dedicated Service Account under Google Cloud Platform Console Google Cloud Platform > IAM & admin > Service Account > Create a new Service Account
Before creating the service account, make sure that the relevant Project is selected. The drop-down menu in the upper left corner of the screen shall match the Organisation you have set in the previous step
Name your account
Purchasely
to be able to easily identify it laterGive it the ID
purchasely
On the following screen, set the role to "Owner"
You can also set "Pub/Sub Admin" and "Monitoring Viewer" as roles instead of "Owner"
On the following screen, note the email generated by Google for your Service Account
It should look like
purchasely-@pc-api-123456789-123.iam.gserviceaccount.com
Create a key by clicking on the
+ Create a key
buttonChoose JSON format to download the file
Fill the content of the field "Access key" with this JSON file
Grant access to the new Service Account
Grant access to the Service Account under the Google Play Console Google Play Console> Users & Permissions > Invite new users

You will need to complete those 3 steps:
Set the email of your service account
Set "no expiration date"
Add your application
Tab: App permissions - Select the application corresponding to the app bundle id

Once you have clicked on Apply - Ensure the following permissions are selected :

Finally, click on Invite user to grant access to your service account

Server to Server notifications
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

Configuring Huawei AppGallery parameters

Huawei App Package ID
Open your AppGallery Console
Go to: AppGallery Connect > My Apps > [YOUR APPLICATION]
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
App ID
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)

App secret
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)

Public key
Open your AppGallery Console
Go to: AppGallery Connect > My Apps > [YOUR APPLICATION]
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)
Configuring Amazon App Store parameters

App SKU
Open the Amazon App Store dashboard
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.
Shared Key
You need to give us your Amazon App Store shared Key. You can find it here.
Last updated
Was this helpful?