Purchasely
4.4
4.4
  • Welcome page
  • General
    • Presentation
    • Release notes
  • Quick start
    • Console Configuration
    • SDK Implementation
    • Testing
    • Sample
  • Basic configuration
    • Console Configuration
      • Creating a new application
      • Creating your Products
        • App Store
        • Play Store
        • Huawei App Gallery
        • Amazon App Store
        • Products & Plans
      • Design your Paywalls
      • Design your Paywalls-Latest
        • Carousel
        • Carousel Flow
        • Features List
        • Features List & Plan Picker with 2 & 3 columns
        • Feature list overlay
        • Plan picker horizontal
        • Plan picker with 2 and 3 Column
    • SDK installation
      • iOS SDK
      • Android SDK
      • React Native SDK
      • Cordova SDK
      • Flutter SDK
      • Unity SDK
    • SDK configurations
      • Paywall observer mode
      • Full mode
      • StoreKit 2
      • Appendices
        • Start the SDK
        • Set User Id
        • Notify when the app is ready
        • Present paywalls
        • Unlock content / service
        • Close SDK (Android only)
    • Stripe
    • Purchasely with RevenueCat
  • S2S notifications
    • Server-to-server notifications ?
    • Apple App Store
    • Google Play Store
    • Huawei App Gallery
  • Analytics
    • Dashboards
      • Introduction
      • Live
      • Subscriptions
      • Cohorts
      • Trials
      • Events
    • Events
      • Webhook events
        • Subscription events
        • Subscription events attributes
      • SDK events
        • UI events
        • UI attributes
  • Integrations
    • Webhook
      • Receiving and understanding messages
      • Managing entitlements
      • Detailed sequence diagrams
    • Airship
    • Amplitude
    • AppsFlyer
    • Adjust
    • Piano analytics(ex AT Internet)
    • Batch
    • Branch
    • Braze
    • Clevertap
    • Customer.io
    • Firebase
    • Iterable
    • Mixpanel
    • MoEngage
    • OneSignal
    • Segment
    • Brevo(ex Sendinblue)
  • Advanced Features
    • Asynchronous paywalls
    • NEW: Promotional offers
    • Anonymous user
    • Associating content
    • Audiences
    • Customising UI
      • Errors & alerts
      • Controllers (iOS) / Fragments (Android)
    • Deeplinks automations
    • Disable placements
    • Displaying users subscriptions
    • Localization
    • Lottie animations
    • Non-subscription products
    • Paywall action interceptor
    • Promoting your products
      • Self-promotion
      • Promoting In-App Purchases
    • Purchase manually
    • Subscription status
    • Use your own paywall
  • Others
    • Frequently Asked Questions
    • Migration guides
      • Migrate to Purchasely
      • Webhook
        • Migrate to Webhook v3.0
      • SDK
        • Migrate to SDK v3.0
          • v2.2.0
          • v2.1.3
        • Migrate to SDK v3.1
        • Migrate to SDK v3.2
        • Migrate to SDK v4.0.0
  • TESTING
    • Testing Cycle Durations
Powered by GitBook

© Purchasely 2020-2023

On this page
  • Log in to the console
  • Creating a new App
  • Configuring the Apple App Store parameters
  • App bundle id
  • Apple ID
  • App Scheme
  • Shared App Secret
  • Store Kit 2
  • Server to Server notifications
  • Configuring the Google Play Store parameters
  • Android App Bundle ID
  • App Scheme
  • Access Key (JSON)
  • Server to Server notifications
  • Configuring Huawei AppGallery parameters
  • Huawei App Package ID
  • App ID
  • App secret
  • Public key
  • Configuring Amazon App Store parameters
  • App SKU
  • Shared Key

Was this helpful?

Edit on GitHub
  1. Basic configuration
  2. Console Configuration

Creating a new application

PreviousConsole ConfigurationNextCreating your Products

Last updated 1 year ago

Was this helpful?

Log in to the console

Go to with your credentials.

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

We advise you to start creating a staging application first (i.e. a mobile application plugged into a staging environment) to perform your first tests.

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.

This value will simulate a HTTP 200 response code allowing the Purchasely Cloud Platform to consider that the new subscription has been duly acknowledged by the Client Backend.

Every message send by Purchasely in the webhook is signed using a Client shared secret.

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

The Bundle ID is used by Purchasely Cloud Platform to validate that receipts are indeed coming from your app

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

Shared App Secret

The Shared App Secret is used by Purchasely Cloud Platform and required to validate receipts for this specific app

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

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.

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 Bundle ID is used by Purchasely Backend to validate that receipts are indeed coming from your app

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

Access Key (JSON)

This access key is mandatory to allow Purchasely Cloud Platform to decode Play Store receipts/token

This task involves three steps

Enable API on Google Cloud

You will need to enable 2 APIs on Google Cloud Console

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 later

  • Give 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 button

  • Choose 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

You will need to complete those 3 steps:

  1. Set the email of your service account

  2. Set "no expiration date"

  3. 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

The Package name is used by Purchasely Cloud Platform to validate the authenticity of the receipts.

  1. 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

The App ID is used by Purchasely Cloud Platform to validate the authenticity of the receipts.

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

The App secret is used by Purchasely Cloud Platform to validate the authenticity of the receipts.

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

The public key is used by Purchasely Cloud Platform to validate the authenticity of the receipts.

  1. In the "All services" menu on top, search for "In-App Purchases" and click on it

  2. Get the Public key property

  1. 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

The Package name is used by Purchasely Cloud Platform to validate the authenticity of the receipts.

  1. Select App List

  2. Select your app

  3. 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

These credentials are provided to you by the Purchasely Team. If you want to have your credentials created, just contact us at

Purchasely webhook illustration

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

Apple App Store Plug-in with Purchasely
Bundle ID and Apple ID

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.

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 to configure Store Kit 2 with Purchasely

You can use Store Kit 1 if you want, just skip this step and make sure that is configured with Store Kit 1

Refer to for more information.

Google Play Console Plug-in with Purchasely

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.

your existing project

Enable

Enable

Create a dedicated Service Account under Google Cloud Platform > IAM & admin > > Create a new Service Account

Grant access to the Service Account under the Google Play Console> Users & Permissions > Invite new users

Connect to Google from Purchasely

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 .

hello@purchasely.com
https://httpstat.us/200
Webhook documentation
manage user entitlements and access control.
iOS
this guide
Purchasely.start()
Server-to-server notifications documentation
Android
Create or select
Google Cloud Platform Console
Service Account
Google Play Console
AppGallery Console
AppGallery Connect
My Apps
AppGallery Console
AppGallery Connect
My Apps
Amazon App Store dashboard
here
Apple App Store
Google Play Store
Huawei AppGallery
Amazon App Store
App bundle ID
Apple ID
App Scheme
Shared App Secret
Android App Bundle ID
App Scheme
Access Key JSON
Enable API on Google Cloud
Creating Service Account
Granting required access
Purchasely console
Android Developer API
Developer Reporting API
Service Account permission in Google Play Console