Specifying prices for Advanced Commerce SKUs

Discussion

Apps that use the Advanced Commerce API manage their own catalog of in-app purchases and their respective SKUs, including their prices. When supplying a price, be sure to use the supported number of decimal places, as shown in the section below. In the API, provide the price value in milliunit format.

When setting a price for your SKU, it’s strongly recommended that you choose from the 900 price points that the App Store supports across 175 storefronts and 44 currencies. To view or download a .csv file that includes all the storefronts, currencies, and price points:

• In App Store Connect, log in with an App Manager role.

• Select Apps, and choose your app.

• In the left menu, select Pricing and Availability.

• Select Available Prices by Country or Region.

• Select Download All Prices and Currencies.

For price point information by currency, see App Store Pricing Update.

Determine the currency at runtime

To determine the currency to use at runtime, check the device’s App Store storefront. For a list of currencies that the App Store supports for each storefront, see Financial reports regions and currencies. For information about getting the current storefront in the app, see the current property of Storefront. For more information on currency, see currency.

Provide prices in milliunit format in API calls

The Advanced Commerce API accepts prices in milliunit format, as noted in the documentation, such as for the price type.

To determine a price in milliunits, multiply the price by 1000. One unit of a currency equals 1000 milliunits. The following table shows examples of valid prices in milliunit format:

Use the supported number of decimal places for prices

The App Store supports either zero or two decimal places for prices, depending on the currency.

The following table shows examples of valid and invalid prices, based on the number of decimal places they use:

Look up the supported number of decimal places by currency code

The following currencies don’t support any decimal places:

The following currencies support two decimal places:

See Also

Tax codes and pricing

• Choosing tax codes for your SKUs
• Handling subscription price changes