Restricciones regionales de venta

Cómo funciona

Las restricciones regionales de venta le permiten controlar en qué países se pueden vender los artículos y ayudan a prevenir abusos, por ejemplo, cuando un usuario compra una clave de juego a un precio reducido en una región y la activa en otra.

El país del usuario se transmite en el parámetro country al solicitar el catálogo mediante llamadas API desde la subsección Catálogo del grupo Claves de juego y el grupo Artículos virtuales y moneda. Si no se proporciona el parámetro, el país se determina en función de la dirección IP del usuario. A continuación, el sistema genera un catálogo de artículos disponibles en el país del usuario.

¿Quién puede utilizarlo?

Socios que quieren limitar la disponibilidad de artículos en determinados países o regiones.

Flujo de integración

Nota
Si se especifican regiones para un artículo y el país del usuario no está incluido en ninguna de ellas, el artículo no estará disponible en ese país.
Para establecer restricciones regionales de venta:
  1. Cree regiones en las que los artículos estarán disponibles mediante la llamada API Crear región. La API devuelve el ID de la región, que necesitará en el siguiente paso.
Ejemplo de creación de una región de Norteamérica que incluye Estados Unidos y Canadá:
Copy
Full screen
Small screen
1{
2  "name": {
3     "en-US": "North America",
4   },
5  "countries": ["US", "CA"]
6}
Nota
El código del país se especifica en el formato ISO 3166-1 alpha-2. Consulte la lista de países admitidos por Xsolla antes de crear una región.
  1. Transmita el ID de la región a la matriz regions al crear o actualizar un artículo utilizando las llamadas API correspondientes de la subsección Admin:
Ejemplo de una matriz regions con los ID de las regiones en las que se puede vender el artículo:
Copy
Full screen
Small screen
1"regions": [
2  {
3     "id": 123
4  },
5  {
6     "id": 456
7  }
8]
Aviso
Una vez configuradas las regiones y asignadas a un juego, las claves solo se pueden subir mediante la llamada API Cargar códigos.
¿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: 13 de Febrero de 2026

¿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.