Precios regionales

A la hora de establecer un catálogo de artículos, puede configurar políticas de precios para usuarios de diferentes países (sistema de precios regionales) para artículos virtuales y paquetes de claves del juego. Por defecto, el precio de cada artículo o paquete de claves del juego está definido en USD. Puede establecer simultáneamente restricciones regionales y precios regionales.

Cómo funciona

Los precios del catálogo dependerán del país del usuario.

Durante el proceso de compra a través de Pay Station, el precio de un artículo se convierte a la moneda del país del usuario e incluye los impuestos, si son aplicables.

Determinación del país

• Al solicitar un catálogo de artículos, el país del usuario se transmite en el parámetro country en los métodos de la subsección Catálogo del grupo de métodos Artículos virtuales y moneda o Claves del juego.
  Si no se especifica el país, se determinará en función de la dirección IP del usuario. Después, se seleccionarán los precios para el catálogo de artículos según el país del usuario.
• Al comprar un artículo:
  • Si usa las llamadas de cliente para obtener un token de pago, es esencial utilizarlas solamente desde el lado del cliente y no desde el lado del servidor. El país y la moneda en las llamadas de cliente vienen determinados por la dirección IP del usuario. El uso de este método desde el lado del servidor puede provocar una determinación errónea de la moneda y afectar a los métodos de pago que hay en Pay Station.
  • Si usa la llamada al servidor Crear token de pago para la compra, deberá transmitir el objeto country en el cuerpo de la solicitud o la dirección IP del usuario en el encabezado X-User-Ip.

1. 1. Si se transmiten el país del parámetro country.value y la dirección IP en el encabezado X-User-Ip, tiene precedencia el valor del país en el parámetro country.value.

Principios de visualización de precios en el catálogo de artículos

Para todos los artículos del catálogo, debe utilizar la misma lista de monedas en la que se definen los precios.

Esto es necesario para que todos los artículos del catálogo se muestren en la misma moneda. Si no se especifica el precio para uno de los artículos en uno de los países, los precios de todo el catálogo de ese país se visualizan en la moneda por defecto.

Si la moneda por defecto es diferente para los artículos, entonces los precios se muestran en la moneda por defecto del primer artículo del catálogo. Si uno de los artículos no tiene un precio en esta moneda, se devolverá un valor de precio de null para él en la respuesta. Esto ocasionará una visualización incorrecta del precio del artículo y puede afectar a la visualización del catálogo en su conjunto.

Ejemplos:

• 1 artículo, 1 moneda, ningún precio regional
• 1 artículo, 2 monedas, ningún precio regional
• 1 artículo, hay precios regionales
• Varios artículos, hay precios regionales, una moneda por defecto
• Varios artículos, hay precios regionales, diversas monedas por defecto

La moneda por defecto para el artículo es USD y el precio es 5 USD, no hay configuración para diferentes países. En este caso, los usuarios de todos los países verán este precio.

Se establecen dos opciones de precio para el artículo: en USD y en EUR, pero no se especifican precios especiales por países. En este caso, los usuarios de países en los que se usa EUR verán el precio como 7 EUR. Los usuarios de los demás países verán el precio como 5 USD, ya que es el precio en la moneda por defecto.

El proyecto tiene precios en las siguientes monedas:

• precio por defecto: 7 USD
• precio en euros: 6 EUR
• Precios regionales:
  • Alemania: 8 EUR
  • Italia: 5 EUR
  • Malasia: 20 MYR
  • Sudáfrica: 90 ZAR

En función del país del usuario, la indicación de los precios del catálogo será la siguiente:

País del usuario	Precio de catálogo	Comentario
Estados Unidos de América	7 USD	EE. UU. es un país en el que se utiliza USD. No se especifica un precio especial para EE. UU.
Japón	7 USD	No se especifica la moneda de Japón, así que el precio se muestra en la moneda por defecto.
Francia	6 EUR	Francia es un país en el que se utiliza EUR. No se especifica un precio especial para Francia.
Alemania	8 EUR	Se especifica un precio regional para Alemania.
Italia	5 EUR	Se especifica un precio regional para Italia.
Malasia	20 MYR	Se especifica un precio regional para Malasia.
Sudáfrica	90 ZAR	Se especifica un precio regional para Sudáfrica.

El proyecto tiene precios en las siguientes monedas:

• el precio por defecto en dólares estadounidenses (USD)
• en Malasia, los precios de todos los artículos están en ringgit malasio (MYR)
• en Sudáfrica, los precios de todos los artículos excepto uno están en rand sudafricano (ZAR)

En este caso, el catálogo se muestra en MYR para los usuarios de Malasia, pero en USD para los de Sudáfrica. Para los usuarios de Sudáfrica, se muestra en USD, ya que el precio no se especificó en ZAR para uno de los artículos.

El proyecto tiene precios en las siguientes monedas:

• el precio por defecto para el artículo 1_test_item es en dólares estadounidenses (USD)
• el precio por defecto para el artículo 2_test_item es en euros (EUR)
• en Sudáfrica, el precio para 1_test_item se proporciona en rand sudafricano (ZAR), para 2_test_item no se especifica

En este caso, para los usuarios de Sudáfrica, el precio debe indicarse en la moneda por defecto del primer artículo del catálogo: 1_test_item.

La moneda por defecto para 1_test_item: USD. No coincide con la moneda por defecto del 2_test_item: EUR. Además, no hay precio en USD en la lista de precios para este.

Por tanto, para 2_test_item el valor de precio devuelto será null.

¿Quién puede utilizarlo?

Socios que desean aumentar las ventas en países con bajo poder adquisitivo estableciendo la política de precios de la tienda para jugadores de distintos países.

Cómo conseguirlo

Puede añadir, editar y eliminar precios regionales:

• mediante Cuenta del editor al crear/editar un artículo
• a través de Cuenta del editor al importar precios por medio de un archivo
• usando métodos API

Configuración mediante Cuenta del editor al crear y editar el artículo

1. Abra su proyecto en Cuenta del editor.
2. Haga clic en Store en el menú lateral.
3. En el panel Virtual Items, haga clic en Configure.
4. Haga clic en el icono + y seleccione Create item en la lista desplegable.

5. Especifique:
   • imagen
   • código de artículo (SKU)
   • uno o varios grupos a los que debe pertenecer el artículo
   • nombre
   • descripción
   • propiedad del artículo: artículos consumibles, no consumibles o de duración limitada
6. En el bloque Price settings, elija Paid item.
7. Establezca el conmutador Pricing in real currency en la posición On y especifique el precio. Si no establece precios regionales, el precio de un artículo será el mismo para todos los países y en dólares estadounidenses.

8. Establecer precios:
   • Si desea establecer el precio de un artículo en diferentes monedas, haga clic en + y especifique la moneda y el precio.
   • Si desea establecer precios especiales para países, haga clic en Add pricing y especifique el país, la moneda y la cantidad. Puede establecer el número de precios por cada país que necesite.
9. Si desea añadir el precio en moneda virtual, cambie el conmutador Pricing in virtual currency a la posición On y especifique el precio.
10. Si desea limitar la disponibilidad de artículos a usuarios específicos, ponga el conmutador Limit number of times one user can buy this item en On y especifique el número.
11. Si desea mostrar un artículo en la tienda, ponga el conmutador Show item in store en On.
12. Haga clic en Create item.

Importar desde archivo en la Cuenta del editor

Puede importar precios regionales desde un archivo para artículos previamente creados.

Características

• Carga o actualiza los precios regionales de varios artículos simultáneamente.
• Se admiten artículos de todo tipo:
  • artículos virtuales
  • monedas virtuales
  • paquetes de monedas virtuales
  • lotes
  • paquetes de claves de juego en una plataforma específica

• Validación de los datos cargados. Si la estructura del archivo o el formato de los datos no cumplen los requisitos, verá una lista de errores durante la importación.

Estructura de archivo

• SKU: el código de artículo (SKU) para el que deben establecerse precios regionales.
• Country: el código del país en formato ISO 3166-1 alpha-2. Consulte la lista de países admitidos por Xsolla antes de cargar el archivo CSV. Rellenar las celdas de esta columna es opcional. Puede ver ejemplos de indicación de precios si no se especifica el país.
• Currency: el código de moneda está en el formato ISO 4217.
• Amount: el precio del artículo. Use un punto como separador decimal.

• IsDefault: si es el precio por defecto. Especifique:

  • 1 - para la fila con el precio por defecto. Se muestra en todos los países sin precios regionales.
  • 0 - para el resto de filas. También puede dejar vacía la celda en la columna IsDefault.

Nota

El precio por defecto no debe ser regional; deje la celda de la columna Country vacía.

EJEMPLO

Archivo completado correctamente (varios artículos, 3 monedas, precios regionales disponibles).

Archivo completado de forma incorrecta (varios artículos, 3 monedas, precios regionales disponibles).
Error: en virtual-item-1 y bundle-1, las celdas de grupo de la columna Country no están vacías.

Al añadir cada artículo nuevo, debe establecer el precio en la moneda por defecto. Si no se especifica, aparecerá un error al importar el archivo.

EJEMPLO

Archivo completado correctamente (varios artículos, 3 monedas, precios regionales disponibles).

Archivo completado de forma incorrecta (varios artículos, 3 monedas, precios regionales disponibles)
Error: no hay ninguna moneda por defecto para los grupos virtual-item-1 y bundle-1.

• Platform: el SKU de la plataforma. Se utiliza para establecer los precios regionales de las claves de juego, pero no para otros artículos.

  Plataformas disponibles.

  Platform SKU	Platform name
  steam	Steam
  playstation	PlayStation
  xbox	Xbox
  uplay	Uplay
  origin	Origin
  drmfree	DRM Free
  gog	GOG
  epicgames	Epic Games Store
  nintendo_eshop	Nintendo Switch eShop
  discord_game_store	Discord Game Store
  oculus	Oculus
  viveport	Viveport
  stadia	Google Stadia

Nota

Las claves de juego con el mismo SKU pero diferentes plataformas se consideran entidades diferentes. Cada entidad debe tener un precio especificado en la moneda por defecto.

EJEMPLO

Archivo completado correctamente (varias claves de juego, 3 monedas, precios regionales disponibles, 2 plataformas).

Archivo completado de forma incorrecta (varias claves de juego, 3 monedas, precios regionales disponibles, 2 plataformas).
Error 1: agrupación incorrecta de las claves de juego por SKU y Platform, de forma que aparecen nueve entidades en lugar de tres.
Error 2: los grupos 3, 4, 5 y 6 no tienen precio por defecto por agrupación incorrecta.
Error 3: el grupo 9 reemplazará los datos del grupo 7 porque tienen un conjunto completo de precios para la misma entidad. Como resultado, la clave de juego game-key-2 para la plataforma playstation solo tendrá un precio en MYR después de la importación.

Ejemplos de archivos completados y posibles errores

• Varios artículos, 3 monedas, sin precios regionales.
• Varios artículos, 1 moneda, sin precios regionales.
• Varias claves de juego, 3 monedas, precios regionales disponibles, 1 plataforma.
• Varias claves de juego, 3 monedas, sin precios regionales, 2 plataformas.

Copy

Full screen

Small screen

• csv

SKU,Currency,Amount,Country,IsDefault
virtual-item-1,EUR,9.09,,0
virtual-item-1,USD,10.1,,1
virtual-item-1,MYR,47,,0
virtual-currency-1-pack-100,EUR,2.09,,0
virtual-currency-1-pack-100,USD,2.3,,1
virtual-currency-1-pack-100,MYR,24,,0
bundle-1,EUR,15,,0
bundle-1,USD,17,,1
bundle-1,MYR,82,,0

Copy

Full screen

Small screen

• csv

SKU,Currency,Amount,Country,IsDefault
virtual-item-1,USD,10.1,,1
virtual-currency-1-pack-100,USD,2.3,,1
bundle-1,USD,17,,1

Copy

Full screen

Small screen

• csv

SKU,Currency,Amount,Country,IsDefault,Platform
game-key-1,EUR,9.09,,1,steam
game-key-1,EUR,9.2,DE,0,steam
game-key-1,EUR,8.09,IT,0,steam
game-key-1,USD,10.1,US,0,steam
game-key-1,MYR,47,MY,0,steam
game-key-2,EUR,2.09,,1,steam
game-key-2,EUR,2.2,DE,0,steam
game-key-2,EUR,1.79,IT,0,steam
game-key-2,USD,2.3,US,0,steam
game-key-2,MYR,24,MY,0,steam

Copy

Full screen

Small screen

• csv

SKU,Currency,Amount,Country,IsDefault,Platform
game-key-1,USD,10.1,,1,steam
game-key-1,EUR,9.09,,0,steam
game-key-1,MYR,47,,0,steam
game-key-1,USD,17,,1,playstation
game-key-1,EUR,15,,0,playstation
game-key-1,MYR,82,,0,playstation
game-key-2,USD,2.3,,1,steam
game-key-2,EUR,2.09,,0,steam
game-key-2,MYR,24,,0,steam

• Varias claves de juego, 3 monedas, sin precios regionales, 2 plataformas.
• Varias claves de juego, 3 monedas, precios regionales disponibles, 2 plataformas.
• Varios artículos, 3 monedas, precios regionales disponibles.
• Varios artículos, 3 monedas, precios regionales disponibles.
• Varios artículos, 3 monedas, sin precios regionales.

Error: los grupos game-key-1 + steam y game-key-2 + steam no tienen precios por defecto.

Error: los grupos game-key-1 + steam y game-key-2 + steam tienen US como país para los precios por defecto.

Error: los grupos virtual-item-1 y bundle-1 no tienen precios por defecto.

Error: los grupos virtual-item-1 y bundle-1 tienen US como país para los precios por defecto.

Error 1: agrupación incorrecta de artículos por SKU, de forma que aparecen cinco entidades en lugar de tres.
Error 2: el grupo 3 no tiene precio por defecto por agrupación incorrecta.
Error 3: el grupo 4 reemplazará los datos del grupo 2, ya que tienen un conjunto completo de precios para el mismo artículo. Como resultado, el SKU para virtual-currency-1-pack-100 solo tendrá un precio en MYR después de la importación.

Importación de archivos

1. Abra su proyecto en Cuenta del editor.
2. Haga clic en Store (Tienda) del menú lateral y vaya a la sección con cualquier tipo de producto.
3. Haga clic en Import prices.

4. En la ventana de importación, puede descargar la plantilla de archivo y agregar los valores.
5. Cargue el archivo en el campo correspondiente de la ventana de importación.
6. Si se produce algún error durante la importación, la ventana de importación muestra una lista de estos errores y recomendaciones para su corrección. Haga los cambios necesarios en el archivo y cárguelo de nuevo.

Tras cargarlos correctamente, los precios regionales de los artículos con los códigos de artículo (SKU) especificados se actualizarán conforme a los precios del archivo. Los precios especificados anteriormente se eliminarán.

Ejemplo:

Existen varios precios en diferentes monedas y varios precios regionales para el artículo en Cuenta del editor. En el archivo importado, solo hay un precio en EUR. Tras importar el archivo, solo se especificará un precio en EUR para este artículo en Cuenta del editor.

Establecer mediante métodos API

• en los métodos para crear y actualizar artículos virtuales
• en los métodos para crear y actualizar moneda virtual
• en los métodos para crear y actualizar paquetes de moneda virtual
• en los métodos para crear y actualizar lotes

• en los métodos para crear y actualizar paquetes de claves del juego

"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]