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 Catalog del grupo de métodos Virtual Items & Currency o Game keys.
  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 Create payment token for purchase, 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:

• Cargar o actualizar los precios regionales de varios artículos simultáneamente.
• Se admiten artículos de todo tipo:
  • artículos virtuales
  • moneda virtual
  • paquetes de moneda virtual
  • lotes
  • paquetes de claves del 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.

• 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 la columna es opcional. Puede ver ejemplos de indicación de precios si no se especifica el país.
• Currency: el código de moneda 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 - en la fila con el precio por defecto. Se muestra en todos los países sin precios regionales.
  • 0 - en todas las demás filas.También puede dejar vacía la celda en la columna IsDefault.

1. El precio por defecto no debe ser regional: deje vacía la celda de la columna Country.
   Si hay múltiples códigos (SKU) de artículos en el archivo, se debe establecer un precio en la moneda por defecto para cada SKU. Si no se especifica, aparecerá un error al importar el archivo.

Ejemplo de un archivo con precios:

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
      }
    ]