Precios locales

Los socios que quieran aumentar sus ventas en países con bajo poder adquisitivo pueden establecer políticas de precios regionales. Esto permite adaptar el coste de los productos para usuarios de distintos países.

Al configurar un catálogo de artículos, puede fijar precios regionales para los artículos virtuales y los paquetes de claves de juego. El precio de cada artículo o paquete de claves de juego se establece en USD por defecto. Puede establecer restricciones regionales y precios regionales a la vez.

Puede añadir, editar y eliminar 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. 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.
Nota
Puede transmitir la moneda en el parámetro currency. Este valor tiene precedencia sobre el valor del país y afecta a la visualización de la moneda de pago. Los métodos de pago que aparezcan en la interfaz de pago seguirán estando determinados por 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, debería utilizar la misma lista de monedas en que están especificados los precios. Esto es necesario para que todos los artículos del catálogo se muestren en la misma moneda. Si el precio no está especificado para uno de los artículos en uno de los países, los precios para todo el catálogo en ese país se muestran 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 ese artículo en la respuesta a la solicitud del catálogo. 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:

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.

Nota
Cuando se importa un catálogo desde Google Play, los artículos se agregan con precios regionales que puede editar. Tenga en cuenta las particularidades de la actualización de datos al reimportar el catálogo.

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

Nota
Esta guía describe cómo establecer precios regionales para artículos virtuales. La configuración de precios para otros tipos de artículos se rige por el mismo enfoque.
Para crear artículos virtuales con un precio regional:
  1. Abra su proyecto en Cuenta del editor, vaya a Store > Virtual Items, y haga clic en Configure.
  2. Haga clic en el icono + y seleccione Create item en la lista desplegable.
  1. Agregue:
    • imagen
    • código de artículo (SKU)
    • uno o varios grupos a los que pertenece el artículo
    • nombre
    • descripción
    • propiedad del artículo: artículos consumibles, no consumibles o de duración limitada
  2. En el bloque Price settings, elija Paid item.
  3. Establezca el conmutador Pricing in real currency en la posición On y haga clic en Set up prices.
  1. En la ventana que se abre, especifique la moneda y el precio por defecto. Puede sustituir USD por otra moneda por defecto.
Aviso
Si no se establecen precios regionales, el precio por defecto de un artículo se aplicará a todos los países
  1. Establecer precios locales. Puede hacerlo de dos maneras: de forma manual o de forma automática.
    • Para establecer los precios manualmente:
      1. Pulse en "+ Add local price" y añada los precios línea por línea.
      2. Pulse en Apply.
    • Para establecer los precios automáticamente:
      1. Haga clic en Calculate using default price. Se generará una lista de países en orden alfabético, y se calculará el precio en la moneda regional para cada país en función de los tipos de cambio y de los impuestos.
      2. Para eliminar países en los que no se requieren precios regionales, haga clic en X a la derecha del precio.
      1. Para modificar un precio calculado de forma automática, cambie el valor en la fila correspondiente.
      2. Haga clic en Apply changes.
Nota
Cuando haga clic en Calculate using default price, se eliminará la configuración guardada anteriormente.
Aviso
Si cambia el precio por defecto, pero no pulsa en Calculate using default price, los precios regionales permanecerán inalterados.
  1. Si desea añadir el precio en moneda virtual, establezca el conmutador Pricing in virtual currency en la posición On y especifique el precio.
  2. Si desea limitar la disponibilidad de artículos a usuarios específicos, cambie el conmutador Limit number of times one user can buy this item a la posición On y especifique el número.
  3. Si desea mostrar un artículo en la tienda, cambie el conmutador Show item in store a On.
  4. Haga clic en Create item.

Para editar los precios:

  1. Abra su proyecto en Cuenta del editor Store > Virtual Items.
  2. Pulse en junto al artículo deseado y seleccione Edit item de la lista desplegable.
  3. En la sección Price Settings, pulse en Edit debajo del precio por defecto.

Configuración mediante Cuenta del editor al importar precios desde un archivo

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

El archivo debe estar en formato CSV y contener las siguientes columnas:
Nota
No cambie los nombres en inglés de las columnas, ya que podría provocar errores al importar el 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 SKUPlatform name
    steamSteam
    playstationPlayStation
    xboxXbox
    uplayUplay
    originOrigin
    drmfreeDRM Free
    gogGOG
    epicgamesEpic Games Store
    nintendo_eshopNintendo Switch eShop
    discord_game_storeDiscord Game Store
    oculusOculus
    viveportViveport
    stadiaGoogle 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

Ejemplos de archivo CSV completado correctamente para la importación:
Copy
Full screen
Small screen

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
Ejemplos de archivo CSV completado de forma incorrecta para la importación:


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

Importación de archivos

Para importar precios desde un archivo:
  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.

  1. En la ventana de importación, puede descargar la plantilla de archivo y agregar los valores.
  2. Cargue el archivo en el campo correspondiente de la ventana de importación.
  3. 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

Para establecer precios regionales a través de métodos API, transmita una matriz de objetos con el esquema de precios para los países:

Ejemplo de la matriz:
Copy
Full screen
Small screen
"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]
¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Última actualización: 19 de Marzo de 2025

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!
No hemos podido enviar sus comentarios
Vuelva a intentarlo más tarde o escríbanos a doc_feedback@xsolla.com.