Apple In-App Purchases
Process purchases made inside your iOS app through the App Store. Once installed, this integration becomes available as a payment gateway for the Billing app.
Prerequisites
Before setting up the Apple In-App Purchases integration, ensure you have:
- An active DashX account
- An Apple Developer Program membership
- An app record in App Store Connect with in-app purchase products configured
- Paid Applications agreement accepted in App Store Connect
Create an App Store Connect API key
DashX uses the App Store Server API to verify and track purchases, which authenticates with an API key.
- Sign in to App Store Connect
- Go to Users and Access > Integrations > App Store Connect API
- Create a new key with the In-App Purchase role
- Note the Issuer ID shown above the key list
- Note the Key ID of the key you created
- Download the
.p8private key file
The .p8 private key can be downloaded only once. Store it securely — if you lose it, revoke the key and create a new one.
Find your Bundle ID
Your Bundle ID identifies the app the purchases belong to. It is shown in App Store Connect under your app's General > App Information, and in Xcode under the target's Signing & Capabilities tab. It usually looks like com.yourcompany.yourapp.
Connect to DashX
- Log in to your DashX workspace
- Navigate to Settings > Integrations
- Click [+] to add a new integration and select Apple In-App Purchases
- Choose the environments you want to enable it for
- Enter the configuration below and save
Configuration
| Field | Description |
|---|---|
| Bundle ID | The bundle identifier of your iOS app. |
| Issuer ID | The issuer ID from the App Store Connect API page. |
| Key ID | The ID of the App Store Connect API key. |
| Key Secret | The contents of the downloaded .p8 private key file. |
Sandbox purchases made with a sandbox Apple ID are reported separately from production purchases. Test against a development environment before enabling this in production.