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.