Venta mediante enlace directo

Nota

Antes de configurar la venta mediante enlace directo, cree paquetes de claves de juego en su cuenta.

Además, puede configurar lo siguiente en su proyecto:

Un enlace directo le permite vender claves de juego en cualquier lugar donde se pueda abrir una página web o un navegador integrado, por ejemplo, en el sitio web del juego, en redes sociales, en un lanzador, en boletines o en publicaciones de blogueros.

El enlace abre la página de pedido de Xsolla. En esta página, el usuario recorre todo el flujo de compra: realiza y paga el pedido. No necesita desarrollar su propia interfaz de usuario para esto.

Este formato es adecuado en los siguientes casos:

  • Necesita lanzar rápidamente la venta de juegos o abrir reservas en distintos canales. Basta con colocar el enlace en su sitio web, en redes sociales o en un boletín.
  • Necesita reducir el número de solicitudes de asistencia causadas por direcciones de correo electrónico incorrectas o plataformas incompatibles. El usuario introduce cualquier dato que falte en la página de pedido y, si vende claves para varias plataformas, puede predefinir la plataforma en el SKU (consulte Formato y parámetros del enlace).

Flujo del usuario

  1. El usuario sigue el enlace.
  2. Xsolla muestra la página de pedido.
  3. El usuario facilita los datos que no se han transmitido en el enlace:
    1. Selecciona una plataforma para la que haya claves disponibles.
    2. Introduce un código promocional (opcional).
    3. Introduce la dirección de correo electrónico a la que se enviarán el recibo, la clave de juego y las instrucciones de activación, y hace clic en Continue.
  1. La página muestra de nuevo la dirección introducida. El usuario la confirma o hace clic en Change para corregirla.
Nota

Los pasos para realizar un pedido pueden variar:

  • La selección de plataforma está disponible si el SKU del paquete de claves de juego se transmite sin plataforma.
  • La introducción de códigos promocionales solo está disponible si hay un código promocional activo para el paquete de claves de juego o el lote.
  • Para usuarios autenticados, la dirección de correo electrónico se completa automáticamente en el formulario de pedido a partir de los datos del usuario.
  1. Xsolla reserva una clave para la plataforma seleccionada y abre la interfaz de pago.
  2. El usuario realiza el pago.
  3. Tras un pago correcto, Xsolla envía un correo electrónico con el recibo, la clave de juego y las instrucciones de activación a la dirección de correo electrónico confirmada.

Un enlace para vender claves de juego tiene el siguiente formato:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}

Lista de parámetros de consulta:

ParámetroDescripción
type

Tipo de artículo. Obligatorio.

Valores posibles:

project_id

ID del proyecto, que puede encontrar:

  • Junto al nombre del proyecto al hacer clic en él en el encabezado de la Cuenta del editor.
  • En la URL de cualquier página de la Cuenta del editor. La URL tiene el siguiente formato: https://publisher.xsolla.com/<merchant_id>/projects/<project_id>/.

Obligatorio.

sku

SKU del paquete de claves de juego. Obligatorio.

Ejemplos:

  • game456: SKU sin una plataforma específica.
  • game456_steam: SKU con una plataforma específica. Para ver la lista de plataformas admitidas por Xsolla y ejemplos de sufijos, consulte la tabla de abajo.

Para asegurarse de que el enlace funcione correctamente, puede comprobar el valor del SKU con la llamada API Obtener lista de juegos. El SKU del artículo se devuelve en el parámetro items.unit_items.sku (normalmente este SKU tiene el formato game_key_sku_drm_sku).

xsolla_login_tokenToken de autenticación de usuario (JWT) obtenido mediante Xsolla Login. Para más detalles, consulte Vender a usuarios autenticados.
access_dataObjeto JSON codificado en Base64 con datos del usuario y configuración de pago. Para más detalles, consulte Vender a usuarios autenticados.
authToken de autenticación de usuario obtenido mediante Pay Station. Para más detalles, consulte Vender a usuarios autenticados.
ui_settingsObjeto JSON codificado en Base64 con la configuración del tema de la interfaz. Para más detalles, consulte Personalizar la interfaz.
modeTransmita el valor sandbox para realizar pagos de prueba. Para más detalles, consulte Probar los pagos.
ParámetroDescripción
type

Tipo de artículo. Obligatorio.

Valores posibles:

project_id

ID del proyecto, que puede encontrar:

  • Junto al nombre del proyecto al hacer clic en él en el encabezado de la cuenta.
  • En la URL de cualquier página de la cuenta. La URL tiene el siguiente formato: https://xsolla.com/for/<business-account-type>/account/<merchant_id>/projects/<project_id>/.

Obligatorio.

sku

SKU del paquete de claves de juego. Obligatorio.

Ejemplos:

  • game456: SKU sin una plataforma específica.
  • game456_steam: SKU con una plataforma específica. Para ver la lista de plataformas admitidas por Xsolla y ejemplos de sufijos, consulte la tabla de abajo.

Para asegurarse de que el enlace funcione correctamente, puede comprobar el valor del SKU con la llamada API Obtener lista de juegos. El SKU del artículo se devuelve en el parámetro items.unit_items.sku (normalmente este SKU tiene el formato game_key_sku_drm_sku).

xsolla_login_tokenToken de autenticación de usuario (JWT) obtenido mediante Xsolla Login. Para más detalles, consulte Vender a usuarios autenticados.
access_dataObjeto JSON codificado en Base64 con datos del usuario y configuración de pago. Para más detalles, consulte Vender a usuarios autenticados.
authToken de autenticación de usuario obtenido mediante Pay Station. Para más detalles, consulte Vender a usuarios autenticados.
ui_settingsObjeto JSON codificado en Base64 con la configuración del tema de la interfaz. Para más detalles, consulte Personalizar la interfaz.
modeTransmita el valor sandbox para realizar pagos de prueba. Para más detalles, consulte Probar los pagos.

Para vender paquetes de claves de juego para una plataforma específica, transmita el SKU del paquete de claves de juego con un sufijo de plataforma en el parámetro de consulta sku. El sufijo se añade de forma automática o manual, según dónde cree el paquete:

  • Si crea paquetes de claves de juego en su cuenta, el sufijo de una plataforma específica, por ejemplo, _steam o _playstation, se añade automáticamente al SKU que introduzca manualmente, separado por un guion bajo.
  • Si crea paquetes de claves de juego específicos de una plataforma mediante llamadas API, puede indicar el sufijo de la plataforma en cualquier formato usando solo letras latinas en minúscula y mayúscula, dígitos, puntos, guiones y guiones bajos.

Lista de plataformas admitidas por Xsolla y sus sufijos de ejemplo:

NombreEjemplo de sufijo de SKU
Steam_steam
PlayStation_playstation
Xbox_xbox
Uplay_uplay
Origin_origin
DRM Free_drmfree
GOG_gog
Epic Games_epicgames
Nintendo Switch eShop_nintendo_eshop
Discord Game Store_discord_game_store
Oculus_oculus
Viveport_viveport
Google Stadia_stadia
MY.GAMES Store_my_game

Nota
Si transmite en el enlace el SKU de un paquete de claves de juego con una plataforma específica, el usuario no podrá cambiar la plataforma en la página de pedido.

URL de ejemplo para vender un juego en Steam:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type=game_key&project_id=123456&sku=game456_steam

Personalizar la interfaz

Para que la interfaz de la página de pedido se ajuste al estilo de su juego, configure el tema, el tamaño y otros parámetros siguiendo las instrucciones de personalización. Añada el parámetro ui_settings al enlace y transmita en él el objeto JSON settings.ui codificado en Base64.

URL de ejemplo para abrir la página de pedido con un tema personalizado:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

Vender a usuarios autenticados

Nota

No se requiere autenticación para vender claves de juego mediante un enlace directo. La clave se envía a la dirección de correo electrónico que el usuario indique al comprar. La autenticación del usuario es necesaria si quiere limitar el número de claves por usuario, usar el sistema de derechos o guardar datos del usuario en la interfaz de pago de Xsolla.

Un paso de autenticación adicional podría reducir la tasa de conversión de compras.

Para vender claves de juego a usuarios autenticados, añada uno de los siguientes parámetros al enlace:

  • xsolla_login_token: JWT obtenido mediante Xsolla Login. Use este parámetro si autentica a los usuarios mediante Xsolla Login. Para obtener el token, autentique al usuario mediante la API de Login, por ejemplo, con la llamada Autenticación por nombre de usuario y contraseña.
  • auth: token obtenido mediante Pay Station. Use este parámetro si tiene su propio sistema de autenticación. Para obtener el token, envíe desde su servidor la solicitud Crear token. Para más detalles, consulte Obtener token para abrir la interfaz de pago.
  • access_data: objeto JSON codificado en Base64 con datos del usuario y configuración de pago. Use este parámetro si tiene su propio sistema de autenticación o si necesita transmitir la dirección de correo electrónico y el país. La estructura del objeto coincide con el cuerpo de la solicitud de la llamada Crear token (los objetos user y settings).

Ejemplo de JSON para access_data antes de codificar:

Copy
Full screen
Small screen
 1{
 2  "user": {
 3    "id": {
 4      "value": "USER_ID"
 5    },
 6    "email": {
 7      "value": "[email protected]"
 8    },
 9    "country": {
10      "value": "US"
11    }
12  },
13  "settings": {
14    "language": "en",
15    "currency": "USD"
16  }
17}

Codifique el objeto JSON en Base64 y transmita el resultado en el parámetro access_data del enlace.

Para obtener información detallada sobre los métodos de autenticación y la generación de tokens de autenticación, consulte Cómo establecer la autenticación al vender claves de juego.

URL de ejemplo para abrir la página de pedido con un token de autenticación:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}

Probar los pagos

Para probar los pagos en el modo sandbox, añada el parámetro mode=sandbox al enlace. Puede usar tarjetas bancarias de prueba para completar las transacciones.

URL de ejemplo para abrir la página de pedido en el modo sandbox:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
Aviso
Al comprar en el modo sandbox, no se utilizan las claves cargadas. El sistema simula una compra correcta sin entregar claves reales.
¿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 Noviembre 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 [email protected].