v1

latestOpenAPI 3.1.02026-07-2665153355.3 KB

Get Price Points for a Country

Retrieves price points localized for a specific country.

Pass price points in USD cents and a country code. The API returns each requested price point with its localized price in the currency for that country.

post/v1/price-points/localized/lookup

Request body

pricesInUsdCentsnumber[] required

List of base prices in USD.

countryCode2string required

Two-letter country code in ISO-3166 alpha-2 format. Required if playerIp is not provided. Example: US.

playerIpstring

Player IP address in IPv4 format. Required if countryCode2 is not provided. Example: 192.0.2.1.

Example request

{
  "pricesInUsdCents": [
    699,
    4550,
    9999
  ],
  "countryCode2": "DE"
}

Response

Localized price points retrieved successfully.

currencyCodestring

ISO 4217 currency code of the resolved local currency. Pass this value as priceDetails.currency when creating a checkout session. Empty string when no local price is configured for any of the requested price points.

pricePointsobject

Map of requested USD price points, as JSON string keys, to localized price objects. The value is null when no local price is configured for that price point.

Example response

{
  "currencyCode": "EUR"
}