Connect the App Store
Connect App Store Connect to Voidhash so it can validate purchases and receive subscription updates.
Connecting the App Store lets Voidhash validate StoreKit transactions on the server and receive subscription lifecycle updates from Apple. Do this once your app and its subscription products exist in App Store Connect.
Creating keys requires an Account Holder or Admin in App Store Connect. An App Manager can complete the other steps.
Before you connect
Confirm the following in App Store Connect:
- The Paid Apps Agreement is active, and banking and tax details are complete.
- The app's bundle identifier matches the one in Xcode.
- At least one auto-renewable subscription exists.
- You can create and download an In-App Purchase key.
Apple's In-App Purchase setup overview describes the account prerequisites in more detail.
Configure Voidhash
In Studio, open Settings → Payment providers → App Store. Work through the sections in order.
Add app details
Enter the bundle identifier from Xcode and the app's numeric Apple ID. The Apple ID is listed in App Store Connect under Apps → App Information.
Add an In-App Purchase key
In App Store Connect, open Users and Access → Integrations → In-App Purchase and generate a
key. Copy its Issuer ID and Key ID into Studio, then upload the .p8 file.
Apple lets you download the private key only once. Store it securely, and revoke it if it is ever exposed.
Add App Store Connect identifiers
Open Users and Access → Integrations → App Store Connect API and copy the Team Key Issuer ID and Key ID that Studio asks for. The Vendor Number is in Payments and Financial Reports.
Configure server notifications
Copy the notification URL shown in Studio. In App Store Connect, set it as both the Production and the Sandbox App Store Server Notifications URL, and choose Version 2 for each.
Save and enable
Save each section and resolve any validation errors, then enable the provider. Voidhash can now validate StoreKit transactions and receive subscription lifecycle updates.
Connect products
Open each Voidhash product and add the matching App Store subscription product ID. Product IDs cannot be changed in App Store Connect, so copy them exactly.
Product metadata can take time to reach Apple's sandbox. If useProducts() returns null right
after a change, wait and retry before you change your app code.
Optional settings
- Small Business Program. Add the effective dates only if your account participates.
- Notification forwarding URL. Receive a copy of the raw Apple notification in your backend.
- StoreKit development assets. Upload the subscription-offer key and the local testing certificate only when your Xcode test setup needs them.
Verify
- Build the app with the same bundle identifier.
- Sign in with a Sandbox Apple Account.
- Load the product and confirm the localized
displayPriceappears. - Complete a purchase and check for an active grant in
useCurrentPerson(). - Restore purchases after reinstalling or resetting the test app.
See Make and restore purchases for the client flow on your platform.