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

Get Price Points by Country

  curl -X POST \
  'https://api.appcharge.com/v1/price-points/localized/lookup' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-publisher-token: <x-publisher-token>' \
  -d '{
    "pricesInUsdCents": [699, 4550, 9999],
    "countryCode2": "DE"
  }'

Get Price Points for a Country

{
  "currencyCode": "EUR",
  "pricePoints": {
    "699": {
      "price": 664,
      "displayPrice": "6,64 €"
    },
    "4550": {
      "price": 4323,
      "displayPrice": "43,23 €"
    },
    "9999": {
      "price": 9499,
      "displayPrice": "94,99 €"
    }
  }
}

{
  "message": "Invalid countryCode2: must be ISO 3166-1 alpha-2."
}

{
  "message": "Unauthorized."
}

{
  "message": "Rate limit exceeded."
}

Get Price Points by Country

  curl -X POST \
  'https://api.appcharge.com/v1/price-points/localized/lookup' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-publisher-token: <x-publisher-token>' \
  -d '{
    "pricesInUsdCents": [699, 4550, 9999],
    "countryCode2": "DE"
  }'

Get Price Points for a Country

{
  "currencyCode": "EUR",
  "pricePoints": {
    "699": {
      "price": 664,
      "displayPrice": "6,64 €"
    },
    "4550": {
      "price": 4323,
      "displayPrice": "43,23 €"
    },
    "9999": {
      "price": 9499,
      "displayPrice": "94,99 €"
    }
  }
}

{
  "message": "Invalid countryCode2: must be ISO 3166-1 alpha-2."
}

{
  "message": "Unauthorized."
}

{
  "message": "Rate limit exceeded."
}

Body

application/json

pricesInUsdCents · number[] · required

List of base prices in USD.

Maximum array length: 50

Example:

[699, 4550, 9999]

countryCode2 · string · required

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

Example:

"DE"

playerIp · string

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

Response

200

application/json

Localized price points retrieved successfully.

currencyCode · string

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.

Example:

"EUR"

pricePoints · object

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.

Show child attributes