Venta mediante enlace directo
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:
- campañas promocionales (por ejemplo, códigos promocionales)
- autenticación del usuario
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
- El usuario sigue el enlace.
- Xsolla muestra la página de pedido.
- El usuario facilita los datos que no se han transmitido en el enlace:
- Selecciona una plataforma para la que haya claves disponibles.
- Introduce un código promocional (opcional).
- 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.
- La página muestra de nuevo la dirección introducida. El usuario la confirma o hace clic en Change para corregirla.

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.
- Xsolla reserva una clave para la plataforma seleccionada y abre la interfaz de pago.
- El usuario realiza el pago.
- 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.

Formato y parámetros del enlace
Un enlace para vender claves de juego tiene el siguiente formato:
- http
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ámetro | Descripción |
|---|---|
type | Tipo de artículo. Obligatorio. Valores posibles:
|
project_id | ID del proyecto, que puede encontrar:
Obligatorio. |
sku | SKU del paquete de claves de juego. Obligatorio. Ejemplos:
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 |
xsolla_login_token | Token de autenticación de usuario (JWT) obtenido mediante Xsolla Login. Para más detalles, consulte Vender a usuarios autenticados. |
access_data | Objeto JSON codificado en Base64 con datos del usuario y configuración de pago. Para más detalles, consulte Vender a usuarios autenticados. |
auth | Token de autenticación de usuario obtenido mediante Pay Station. Para más detalles, consulte Vender a usuarios autenticados. |
ui_settings | Objeto JSON codificado en Base64 con la configuración del tema de la interfaz. Para más detalles, consulte Personalizar la interfaz. |
mode | Transmita el valor sandbox para realizar pagos de prueba. Para más detalles, consulte Probar los pagos. |
| Parámetro | Descripción |
|---|---|
type | Tipo de artículo. Obligatorio. Valores posibles:
|
project_id | ID del proyecto, que puede encontrar:
Obligatorio. |
sku | SKU del paquete de claves de juego. Obligatorio. Ejemplos:
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 |
xsolla_login_token | Token de autenticación de usuario (JWT) obtenido mediante Xsolla Login. Para más detalles, consulte Vender a usuarios autenticados. |
access_data | Objeto JSON codificado en Base64 con datos del usuario y configuración de pago. Para más detalles, consulte Vender a usuarios autenticados. |
auth | Token de autenticación de usuario obtenido mediante Pay Station. Para más detalles, consulte Vender a usuarios autenticados. |
ui_settings | Objeto JSON codificado en Base64 con la configuración del tema de la interfaz. Para más detalles, consulte Personalizar la interfaz. |
mode | Transmita 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,
_steamo_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:
| Nombre | Ejemplo 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 |
URL de ejemplo para vender un juego en Steam:
- http
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:
- http
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
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 objetosuserysettings).
Ejemplo de JSON para
- json
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:
- http
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:
- http
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.