# In-App Purchases with Conscent

It covers creating subscriptions in the App Store, retrieving credentials, configuring the Conscent Gateway, and setting up subscription plans. Follow these steps to go live with IAP smoothly.

<details>

<summary>Prerequisites</summary>

* An Apple Developer account with administrative access to App Store Connect.
* Your app is registered in App Store Connect with a unique Bundle ID.
* The latest Paid Applications Agreement is signed in the "Agreements, Tax, and Banking" section of App Store Connect.
* All required tax and banking information is fully completed in App Store Connect.

</details>

### **Step 1: Retrieve App Information from App Store Connect**

#### **1.1 Access App Store Connect**

* Navigate to [App Store Connect](https://appstoreconnect.apple.com/).
* Sign in with your Apple Developer credentials.

#### **1.2 Retrieve the Bundle ID and App Name**

* From the dashboard, click on **“My Apps”**.
* Select the app for which you want to configure In-App Purchases.
* To locate the **Bundle ID**:
  * In the sidebar, click on **“App Information”**.
  * Under **“General Information”**, find the **Bundle ID**.
* Note down both the **App Name** and the **Bundle ID** for future reference.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcH7o1CBDoGq23DGkDkW_5NfK_xUV_J3alFa4MaxOhT3k4ZswEh_umPcC3E9wNOymojAMRLikZj9Q5dKFvT-c0i7omr5LMvjvtzlyYpJAL1BXnZU_AoMh-yKFLVwky5uJtCep86PLhsB1CunRmgkwGa_1iG?key=812N5_E40exWAb14JOeSng" alt=""><figcaption></figcaption></figure>

### **Step 2: Obtain App Store Connect API Key and AuthKey File**

#### **2.1 Access Users and Access Section**

* In App Store Connect, click on **“Users and Access”** from the dashboard.

#### **2.2 Create a User with API Access**

* Click on the **”+”** icon to add a new user or select an existing one.
* Assign the user the **“Admin”** or **“App Manager”** role.
* Ensure the user has **API Access** enabled.

#### **2.3 Generate API Key for the User**

* Navigate to the **“Keys”** tab within **“Users and Access”**.
* Click on **“Generate API Key”**.
* Enter a name for the key and select **“Admin”** for access level.
* Click **“Generate”**.
* Download the **AuthKey\_\<KeyID>.p8** file and store it securely.
* Note down the following:
  * **Key ID**: Available in the **“Keys”** section.
  * **Issuer ID**: Found at the top of the **“Keys”** page.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdvoajR4WewspVPog8qU8R5RrPtS7hm9dmh6RgHtp7z5gn266dohrb-HcEuu_vn563PaaW45D7nQ1FOw8YECkyxdCTip3DBIuwOu_F5MPMa4hMBWdEj8KswQw85piGQTNvBZS1Bwq7x6myTfjxNrSFWGnE?key=812N5_E40exWAb14JOeSng" alt=""><figcaption></figcaption></figure>

* Click on **“Shared Secret”** and note it down as well.

<figure><img src="https://380225236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcoDfVWiJBvgTq8DbifIH%2Fuploads%2Fxjq6il2khMzyWFD8fZuV%2FShareSecret1.jpg.png?alt=media&#x26;token=04d338f0-f70d-4d80-a423-4effa5838786" alt=""><figcaption></figcaption></figure>

### **Step 3: Configure the Conscent Gateway**

#### **3.1 Access Conscent Gateway Configuration**

* Log in to your **Conscent** dashboard.
* Navigate to the **“Monetize”** section.
* Click on **“Payment Gateway”** and select **“In-App Purchase Apple”**.

#### **3.2 Input App and Key Details**

* Enter the **App Name** and **Bundle ID** obtained earlier.
* Upload the **AuthKey.p8** file.
* Enter the **Key ID, Shared Secret Key,** and **Issuer ID** in their respective fields.

#### **3.3 Save Configuration**

* Review all the entered information for accuracy.
* Click on **“Save Changes”** to finalize the gateway configuration.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcf3mot0l63cVjr53_fbvX_PIet987gdiMJ-8QTru7h-avbxABRlXMyJtmNPPFl4WowZKnMhTe7bc46S-xsgR_bjRX6Ch7nA3TDhyQGxoONVuBFh6-_DtR_e8_f92qppz_57Ha-wtVIlus6y9HuFT_Mhsxy?key=812N5_E40exWAb14JOeSng" alt=""><figcaption></figcaption></figure>

### **Step 4: Create In-App Purchase Products in App Store Connect**

#### **4.1 Create a Subscription Group**

* In App Store Connect, select your app from **“My Apps”**.
* In the sidebar under **“Monetization”**, click on **“Subscriptions”**.
* If **“Subscriptions”** is not visible, ensure all agreements in **“Agreements, Tax, and Banking”** are accepted.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcAFlCL3DyJo1yubMwdS_TpveYot3aJ5qeh1wp-6obDLzI9Go281ZuFx1SuLBl44gZ8PxQIIDBPPOgBzwfojxOrUcctL5Q1Ov7RfzqF7YrxIfd0_yxyg4_dT1Jwqsma9NSngnIbdIjZBqG1rcvO0jOpYN_-?key=812N5_E40exWAb14JOeSng" alt=""><figcaption></figcaption></figure>

* Click on **“Create”** to add a new Subscription Group.
* Enter a **Reference Name** for internal use (e.g., “Premium Access Subscriptions”).
* Click **“Create”**.

#### **4.2 Add a Subscription Product**

* Within the Subscription Group, click on **“Create”** to add a new subscription.
* Enter the following:
  * **Reference Name**: Internal name for the subscription (e.g., “Premium Annual Subscription”).
  * **Product ID**: A unique identifier (e.g., “com.yourapp.premium.annual”).
  * **Recommendation**: Use a consistent naming convention.
  * Click **“Create”**.

<figure><img src="https://380225236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcoDfVWiJBvgTq8DbifIH%2Fuploads%2Fi2lgNzbcJu6P29d2UtNa%2Fimage%20(11).png?alt=media&#x26;token=220aa7bd-7e56-4b03-8501-15d383a2a579" alt=""><figcaption></figcaption></figure>

#### **4.3 Set Subscription Duration and Price**

* Under **“Subscription Duration”**, select the appropriate duration (e.g., “1 Year”).
* Click **“Save”**.

<figure><img src="https://380225236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcoDfVWiJBvgTq8DbifIH%2Fuploads%2F8GsaNWAoZII36ZZ8vUTS%2Fimage%20(12).png?alt=media&#x26;token=5794c00f-9712-4fe7-91ec-7b1a18d4282c" alt=""><figcaption></figcaption></figure>

* In the **“Subscription Prices”** section, click **“Add Subscription Price”**.
* Choose a price tier from the dropdown menu.
* Click **“Next”** and confirm the prices for all regions.
* Click **“Save”**.

<figure><img src="https://380225236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcoDfVWiJBvgTq8DbifIH%2Fuploads%2Fe2xBJwnQqsbwEt3ZpiKG%2Fimage%20(13).png?alt=media&#x26;token=3210727c-536f-404c-a37c-2c7b7915ff73" alt=""><figcaption></figcaption></figure>

#### **4.4 Add Localization Information**

* In the **“App Store Information”** section, click on the **”+”** icon next to **“Localization”**.
* Select the desired language (e.g., “English (U.S.)”).
* Enter the following:
  * **Subscription Display Name**: Visible to users (e.g., “Premium Annual Access”).
  * **Description**: Detail what the subscription offers.
  * Click **“Save”**.

<figure><img src="https://380225236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcoDfVWiJBvgTq8DbifIH%2Fuploads%2FPAX9uWhW0AfFP26E0ok0%2Fimage%20(14).png?alt=media&#x26;token=f4efb12a-8295-4ec5-8ea1-5a79e6c6d4dc" alt=""><figcaption></figcaption></figure>

#### **4.5 Add Reviewer Information**

* In the **“Review Information”** section, upload a screenshot of your subscription purchase screen.
* **Note**: The screenshot must meet Apple’s requirements.
* Optionally, add **Review Notes** to provide additional information to the reviewer.
* Click **“Save”**.

<figure><img src="https://380225236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcoDfVWiJBvgTq8DbifIH%2Fuploads%2FIsaBwznGofNhqxR7cjU4%2Fimage%20(16).png?alt=media&#x26;token=8cd585ea-8ed3-45ae-b5d9-33dd5c72e17a" alt=""><figcaption></figcaption></figure>

### **Step 5: Configure Subscription Plans in Conscent Dashboard**

#### **5.1 Access Subscription Plans**

* In the Conscent Dashboard, navigate to the **“Subscriptions”** section.
* Click on **“Create Subscription Plan”**.

#### **5.2 Choose Subscription Type**

* Select **“In-App”** as the subscription type.
* Choose between **“Recurring Subscription”** or **“One-Time Subscription”** based on your product.

<figure><img src="https://380225236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcoDfVWiJBvgTq8DbifIH%2Fuploads%2F3PPMejNfcRDdQAqb7kvH%2Fimage%20(18).png?alt=media&#x26;token=7fc2f67a-b555-47d7-ab76-e5219bee0184" alt=""><figcaption></figcaption></figure>

#### **5.3 Configure Recurring Subscriptions**

* **Subscription Group Name**: Enter the name of the Subscription Group created in App Store Connect.
* **Apple Product ID**: Enter the **Product ID** of the subscription.
* **Duration**: Specify the subscription duration (e.g., “1 Year”).

<figure><img src="https://380225236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcoDfVWiJBvgTq8DbifIH%2Fuploads%2FkFhlXvnHfZtqOApFBGBy%2Fimage%20(20).png?alt=media&#x26;token=579fea1e-03a5-43ba-a374-ca067b9a1ec8" alt=""><figcaption></figcaption></figure>

#### **5.4 Configure Non-Renewing Subscriptions**

* **Apple Product ID**: Enter the **Product ID** of the non-renewing subscription.
* **Duration**: Specify the access duration (e.g., “6 Months”).
* **Price**: Leave blank; pricing will be determined by the price tier set in App Store Connect.

#### **5.5 Save Subscription Plan**

* Provide the other parameters and review the entered details.
* Click **“Save”** to create the subscription plan.

### **Step 6: Provide Starting Price CSV to Conscent**

#### **6.1 Download Pricing CSV from App Store Connect**

* In App Store Connect, navigate to your subscription product.
* Under **“Subscription Prices”**, click on **“Download”**.
* A **.zip** file containing the **.csv** pricing information will be downloaded.

<figure><img src="https://380225236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcoDfVWiJBvgTq8DbifIH%2Fuploads%2FE6aQeK8c5PKQ1SEt7SXV%2Fimage%20(21).png?alt=media&#x26;token=d5586555-c6ac-4993-a023-e8674e1c156a" alt=""><figcaption></figcaption></figure>

#### **6.2 Provide Pricing CSV to Conscent**

* Extract the **.csv** file from the downloaded **.zip**.
* Upload the **.csv** file to the Conscent Dashboard or provide it to your Conscent representative.
* This allows Conscent to synchronize pricing across different regions.

<details>

<summary><mark style="color:orange;background-color:blue;"><strong>I</strong><strong>NFORMATION THAT NEED TO SHARED WITH CONSCENT</strong></mark></summary>

* App Name
* Bundle ID
* KeyId
* AuthKey.p8 file
* Issuer Id
* One-Time Subscription Plan- ProductId + Duration
* Renewal Subscription Plan - Group Name + productId + Duration&#x20;
* CSV file of both the plans(StartingPrice and CurrentPrice)

</details>

### **Conclusion**

Your app is now ready to offer In-App Purchases to users, providing them with seamless access to your premium content. Should you require further assistance, please refer to Apple’s official documentation or contact Conscent team.

#### **Additional Resources**

* [Apple’s App Store Connect Help](https://help.apple.com/app-store-connect/)
* [In-App Purchase Programming Guide](https://developer.apple.com/in-app-purchase/)

**Note**: Always ensure compliance with Apple’s guidelines and review policies when setting up In-App Purchases to avoid any delays during the app review process.