Use this page with AI

Copy this into your coding assistant and add your request.

Read https://openiap.dev/docs/types/storefront and https://openiap.dev/llms.txt. Follow the reading instructions, detailed reference, and linked guides relevant to my task before making changes.
Inspect my existing project and reuse its framework and conventions. Ask me for missing product decisions. Implement the requested behavior and run the applicable checks.
Show the working result, the commands and actual test results, and any remaining limitations. Keep your explanation brief.

My request: [describe what customers should be able to do]

Storefront

Storefront#

Note: Storefront is not a struct in the OpenIAP GraphQL schema. The schema defines getStorefront: String!, so the value returned is a plain country-code string. Its ISO format is platform-specific. This page exists as a conceptual reference for the value returned by getStorefront().

Country-code shape returned by getStorefront. iOS: Storefront.current (Apple docs). Android: BillingConfig.countryCode (Google docs).

Native references: Apple · StoreKit Storefront · Google · BillingConfig.getCountryCode()

Return shape

Type	Summary
`String!`	StoreKit returns ISO 3166-1 alpha-3 (for example `"USA"`, `"KOR"`); Google Play Billing and Horizon return alpha-2 country codes, and Amazon returns its alpha-2-like `UserData.marketplace` value (for example `"US"`, `"DE"`). If the store lookup fails, the API rejects or throws a platform-mapped purchase error instead of returning an empty or locale-derived value.

iOS sources the value from the active StoreKit storefront. Google Play and Horizon query billing configuration; Amazon uses the signed-in user's marketplace. All paths are store-authoritative and fail closed when no storefront value is available.