# Stripe Installation of Stripe in Purchase is performed in 4 steps ## I. Installing the Stripe App Go to the Purchasely's app listing on [Stripe apps marketplace](https://marketplace.stripe.com/apps/purchasely)

If you have more than one Stripe account (for each application) then connect the account you want to associate with the application. {% hint style="danger" %} A Stripe application combines a Stripe account with only one Purchasely Application. If your Stripe account works with more than one Purchasely Application, please contact our support team via Intercom. Read below on how to handle both Stripe "test" and "production" environments. {% endhint %} Click on install app.\ The list of authorizations required for the proper functioning of our application is then displayed.

{% hint style="info" %} If you have a question about the use of an authorization, contact our support team via Intercom. {% endhint %} Validate the authorizations requested

The installation is complete, you can proceed with the configuration.

## II. Configuration of the Stripe app Once the Stripe Purchasely app is installed you need to configure it.\ Go to the Stripe console in **Settings > installed apps > Purchasely**.

### II.1. Associate with Purchasely Once on the app configuration you need to associate it with your Purchasely account and app. To do this, start by clicking on "SIGN IN".

Select the Purchasely app you wish to link your Stripe account to. Click on "NEXT". {% hint style="info" %} Once the app is installed, it needs to be configured both in the "test" and "production" Stripe environments for purchases to be tracked in those environments accordingly. The following configurations are supported : * 2 Purchasely applications * My Purchasely App (staging) <-> Stripe Account (test mode) * My Purchasely App (production) <-> Stripe Account (production mode) * 1 Purchasely application * My Purchasely App <-> Stripe Account (test + production mode) {% endhint %}

### II.2 Confirm Stripe app link with your mobile application Once you have selected the application, you will be redirected to Stripe to finalise the configuration by clicking on "CONFIRM".

The app will appear as below when properly configured in Purchasely and Stripe.

## III. Configuration of plans In order for Purchasely to associate Stripe products, they must be defined in the plans. Also you must associate each **Pricing** Stripe to a Purchasely Plan otherwise the purchase will not be taken into account by Purchasely. From the Stripe console, copy the API ID (price) ...

Then paste this ID into the corresponding plan:

{% hint style="info" %} Purchasely allows you to associate more than one Stripe Price to one given Purchasely plan, to handle cases where there exists several Stripe Prices tied to the same "plan" but with a different currency. {% endhint %} {% hint style="warning" %} Do not associate more than one Stripe Price to one given Purchasely plan if the Stripe Prices have different periodicicy, or different level of entitlement. For such use cases, create another plan. {% endhint %} ## IV. Associating Stripe subscriptions to Purchasely This last step allows Purchasely to retrieve and associate a purchase with a user. [The principle is the same as for the migration of an existing subscriber](https://docs.purchasely.com/faq/migration-guides/migrate-from-an-existing-setup#2.-send-us-every-new-subscription-created-on-you-side-with-a-call-on-our-api) To send us this information, simply call our API and provide it with * `stripe_object_id`: the Stripe subscription ID * `stripe_price_id`: the Stripe Price Id for this subscription (ON STRIPE) * `user_id`: the user\_id associated with the purchase, the same as you enter in [the SDK during configuration.](https://docs.purchasely.com/quick-start-1/sdk-configuration/config-appendices/set-user-id) * `stripe_object_type`: the type of Stripe object sent, currently we only accept `subscription` ```bash curl \ --request POST \ -i \ -H "Content-Type: application/json" \ -H "X-API-KEY:{{YOUR_API_KEY}}" \ -H "X-PLATFORM-TYPE:STRIPE" \ --data '{"stripe_object_id":"{{STRIPE_SUBSCRIPTION_ID}}","stripe_price_id":"{{STRIPE_PRICE_ID_FOR_THIS_SUBSCRIPTION}}", "user_id":"{{SAME_ID_AS_IN_SDK_CONFIGURATION}}", "stripe_object_type":"subscription"}' \ https://s2s.purchasely.io/receipts ``` Example request: ```bash curl \ --request POST \ -i \ -H "Content-Type: application/json" \ -H "X-API-KEY:AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE" \ -H "X-PLATFORM-TYPE:STRIPE" \ --data '{"stripe_object_id":"sub_1MluxqJaEiB9UwXB34gmtzCB","stripe_price_id":"price_1MbKJHJaEiB9UwXBPt0fFq4O", "user_id":"jdo-cus_Msq9YfCiFkFzVx", "stripe_object_type":"subscription"}' \ https://s2s.purchasely.io/receipts ``` {% hint style="info" %} You can export a list of your Stripe's subscriptions with their associated prices from your Stripe Stripe dashboard.\ On Stripe go under:\ Billing > Subscription > Export\ Select: Custom and keep only "ID" and "Plan" {% endhint %}

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://purchasely.gitbook.io/purchasely/quick-start-1/stripe-beta.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.