Are there plans to support Storekit 2 receipt verification?

noah

StoreKit2 needs immediate support.

peter

This is also a major blocker for us. We recently upgraded our laptops, which only support XCode 26. This meant we had to upgrade all of our dependencies, which forced us to migrate to Unity IAP v5 - so it's currently not possible for us to roll back to Unity IAP 4 (and therefore storekit 1).

JasonL

Confirmed, StoreKit2 support is included in the upcoming v5.9 release, scheduled for next week.

peter

Thanks for the update!

Paul Winterhalder

Hi folks,

brainCloud 5.9 is now live - with StoreKit2 support. Go to it!

Paul.

LEE JONG GUN

@Paul-Winterhalder Hello, is there guide for this menu?
스크린샷 2026-01-13 오전 9.02.21.png

and what is "Use App Store Server API for legacy receipts (optional)"?

Michael Costa

Hello @LEE-JONG-GUN!

In order to fill out these values, you will first need to go your app on App Store Connect, then go to App Information. Under General Information you will see the app's Apple ID (this number should also appear in the URL for your app, FYI).

Next you will need to go to the Users and Access > Integrations > In-App Purchases page in App Store Connect.

From there you can find the Issuer ID. Next you'll want to click on the + button to Generate In-App Purchase Key. Give it whatever name you think suitable and it should add it to the page. You will then need to download this IAP subscription key; this should reveal the Key ID for that subscription.

The downloaded IAP subscription key file should be in a .p8 file format. You can open it with a text editor in order to view the Encoded Key. Ctrl + A then Ctrl + C to copy the entire file to the Encoded Key field. Also keep this file somewhere safe, you can only download it once!

That should be all that's required in order to make use of brainCloud's StoreKit 2 integration .

Finally the option for Use App Store Server API for legacy receipts (optional) is there to have apps with older integrations of the brainCloud client to make use of the new implementation with the old StoreKit 1 receipt system.

peter

I have tried following the instruction (triple checked I have found and copied the correct fields) but I keep getting a "Itunes Inapp Integration fields incomplete" error when I try to save the page.

I am supplying:
App id > id shown in general information
Issuer id > Copied from in-app purchasing integrations page
Key ID > Copied form in-app purchasing integrations page (for the specific key)
Encoded key: Contents of the p8 file

The copied error message

---- CONTEXT ----

{
  "email": "redacted@redacted.com",
  "teamId": "redacted",
  "accountNumber": "redacted",
  "appId": "xxxx",
  "appName": "Redacted",
  "profileId": null,
  "page_path": "/",
  "page_search": "",
  "page_hash": "#/app/design/core-app-info/application-ids",
  "page_location": "https://portalx.braincloudservers.com/#/app/design/core-app-info/application-ids"
}

---- DETAILS ----

{
  "errorCode": 2020000,
  "errorMessage": "Itunes Inapp Integration fields incomplete",
  "reasonCode": 40660
}

Michael Costa

Hello @peter. Thank you for letting us know, we are currently looking into it.

As a work around, if you ENABLE "Use App Store Server API for legacy receipts (optional)", and the other fields are filled, you should be able to save. Afterwards you can DISABLE the optional value and it will still be able to save.

peter

Thank you for the advice, we have now managed update our Application IDs.

However:

We always get a 101 Transaction id not found failure from Brain Cloud when attempting to verify an in-app purchase.
When Use App Store Server API for legacy receipts is checked, we also get a 101 failure when testing with older builds that use Brain Cloud 5.8 client and StoreKit1.
- However, if we uncheck this, older builds transactions succeed as expected.

Given the fact we see the same behaviour on legacy transactions, I suspect this may be a fault on your side? If not, is there anything further I can do to investigate?

Notes on retrieving a transaction id with Unity.

We are using Unity IAP 5.1.2, it can be a bit confusing to find out where to retrieve the TransactionID, and not the OriginalTransactionID - as requested by the BrainCloud docs. (Though in my initial testing shows these ids are often the the same).

Initially I parsed transactionID from the jws returned from the app store (a convoluted process), I then realised PendingOrder.Info.Receipt returns a json string which has TransactionID as one of it's fields.

The data we submit to VerifyPurchase() looks something like this:

{"excludeOldTransactions":false,"transactionId":"2000001103879447"}

Michael Costa

Hello @peter.

That's correct, you get the TransactionID from deserializing PendingOrder.Info.Receipt (at least that is the method I'm using ). The reason why you want the TransactionID and NOT the OriginalTransactionID is because renewed subscription purchases will have two different values for this.

Just a couple questions so we have more context:

Do you have the Bundle Id field filled on the Apple Platforms page on brainCloud? This is still a requirement for validating purchases. You'll need to make sure to have one set up for your app on Certificates, Identifiers & Profiles and that it matches the Bundle Identifier in your Unity Player Settings.
Are you running CachePurchasePayloadContext() (docs) before VerifyPurchase()? This is also a requirement for purchases of itunes type.

Please let me know so we can look deeper into this! Thanks