Suscripción de regalo

Puede integrar una función en su aplicación que permita a los usuarios regalar suscripciones a otras personas. Esto puede contribuir a incrementar sus ingresos y a captar nuevos usuarios.

Cómo funciona

Un usuario puede regalar una suscripción a un usuario existente en su sistema especificando la información de su cuenta o a un nuevo usuario especificando su dirección de correo electrónico. En este caso, el usuario que envía el regalo puede ocultar su nombre o añadir un mensaje de texto a la notificación por correo electrónico del regalo. Tras crear una suscripción, el destinatario del regalo se convierte en su propietario. La suscripción creada es del tipo de renovación de pago único.

Flujo de interacción que se produce al regalar una suscripción a un usuario existente:

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant G as Persona que hace el regalo
    participant R as Receptor
    participant BE as Aplicación
    participant X as Xsolla
    G->>BE: Selecciona el usuario existente al que quieres regalar la suscripción y elige el plan.<br>(Opcional) Elige regalarla de forma anónima<br>y añade un mensaje.
    activate BE
    BE->>X: Envía el ID y el correo electrónico de quien hace el regalo,<br>el ID y el correo electrónico del destinatario, el ID del plan.<br>(Opcional) Envía: la opción de anonimato,<br>el mensaje de quien hace el regalo, la URL de redirección y el ID del producto.
    activate X
    X-->>BE: Envía un token de compra
    deactivate X
    BE-->>G: Envía un enlace a la interfaz de pago
    deactivate BE
    G->>X: Abre la interfaz de pago
    activate X
    activate X
    note right of X: Solicita validación del usuario
    deactivate X
    X->>BE: Envía webhook de validación del usuario
    activate BE
    BE-->>X: Devuelve una respuesta correcta
    deactivate BE
    X-->>G: Permite introducir los datos de pago
    deactivate X
    G->>X: Transfiere de forma segura los datos de pago
    activate X
    X->>BE: Envía webhook de pago
    activate BE
    BE-->>X: Devuelve una respuesta correcta
    deactivate BE
    X-->>G: Muestra la pantalla de compra realizada correctamente
    X->>BE: Envía un webhook de suscripción creada
    activate BE
    BE-->>X: Devuelve una respuesta correcta
    deactivate BE
    X-->>G: Envía un recibo
    X->>BE: Envía un correo electrónico con el regalo, incluyendo datos de anonimato,<br>un mensaje de quien hace el regalo y una URL de redirección
    activate BE
    BE-->>X: Devuelve una respuesta correcta
    deactivate BE
    X-->>R: Sigue la URL de redirección en el correo electrónico<br>y ve la información de la suscripción regalada
    deactivate X
    activate R
    R->>BE: Devuelve una respuesta correcta
    deactivate R

Flujo de interacción que se produce al regalar una suscripción a un usuario nuevo:

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant G as Persona que hace el regalo
    participant R as Receptor
    participant BE as Aplicación
    participant X as Xsolla
    G->>BE: Introduce el correo electrónico del nuevo usuario<br>al que quieres regalar la suscripción y elige el plan.<br>(Opcional) Elige regalarla de forma anónima<br>y añade un mensaje.
    activate BE
    BE->>X: Envía ID del donante y correo electrónico,<br>correo electrónico del receptor, URL de redirección, ID del plan.<br>(Opcional) Envía: opción de anonimato,<br>mensaje del donante, ID del producto
    activate X
    X-->>BE: Envía un token de compra
    deactivate X
    BE-->>G: Envía un enlace a la interfaz de pago
    deactivate BE
    G->>X: Abre la interfaz de pago
    activate X
    activate X
    note right of X: Solicita validación del usuario
    deactivate X
    X->>BE: Envía Webhook de validación del usuario
    activate BE
    BE-->>X: Devuelve una respuesta correcta
    deactivate BE
    X-->>G: Permite introducir los datos de pago
    deactivate X
    G->>X: Transfiere de forma segura los datos de pago
    activate X
    X->>BE: Envía Webhook de pago
    activate BE
    BE-->>X: Devuelve una respuesta correcta
    deactivate BE
    X-->>G: Muestra la pantalla de compra realizada correctamente
    X->>BE: Envía un webhook de suscripción creada
    activate BE
    BE-->>X: Devuelve una respuesta correcta
    deactivate BE
    X-->>G: Envía un recibo
    X->>BE: Envía un correo electrónico de regalo con un mensaje de la persona que hace el regalo<br>y una URL de redirección.<br>Si el regalo se envía de forma anónima,<br>no se muestra el nombre de la persona que lo hace.
    activate BE
    BE-->>X: Devuelve una respuesta correcta
    deactivate BE
    X-->>R: Sigue la URL de redirección en el correo electrónico
    deactivate X
    activate R
    R->>BE: Abre el formulario de autenticación
    activate BE
    BE-->>R: Devuelve una respuesta correcta
    deactivate BE
    R->>BE: Crea una cuenta y recibe una suscripción de regalo
    activate BE
    BE-->>R: Devuelve una respuesta correcta
    deactivate BE
    deactivate R

Cómo establecerlo

Puede establecer la opción de regalar una suscripción en su aplicación:

a un usuario existente
a un usuario existente

Regalo destinado a un usuario existente

Implemente en su aplicación una interfaz para comprar una suscripción de regalo con los siguientes elementos:
- campos para introducir los datos del destinatario del regalo
- para introducir un mensaje del remitente (opcional)
- opción para seleccionar el envío anónimo (opcional)
- elementos para seleccionar un plan de suscripción (opcional)

Implemente la recepción de un token tras rellenar los datos del regalo durante el proceso de pago. Para ello, transmita el objeto purchase.subscription.gift a la llamada API Crear token con los siguientes parámetros:
- recipient - ID del destinatario de la suscripción. Obligatorio.
- email - dirección de correo electrónico del destinatario. Obligatorio.
- redirect_url - URL de redireccionamiento. Proporcione un enlace a una página con información adicional sobre la suscripción regalada o a la página principal del proyecto.

Si el redirect_url no se transmite en el token, el destinatario del regalo no podrá acceder a la suscripción regalada desde el correo electrónico de notificación del regalo.

Además, puede transmitir los siguientes parámetros en el objeto purchase.subscription:
- gift.anonymous - si el regalo se envió de forma anónima. Si es true, el nombre del remitente se oculta en la notificación por correo electrónico. Por defecto es false.
- gift.message - mensaje del remitente del regalo. Se envía en una notificación por correo electrónico de la suscripción de regalo.
- plan_id - ID del plan de suscripción.

Ejemplo de solicitud para recibir un token:

Copy

Full screen

Small screen

 1{
 2  "purchase": {
 3    "checkout": {
 4      "currency": "USD",
 5      "amount": 10
 6    },
 7    "subscription": {
 8      "gift": {
 9        "recipient": "test_recipient_v1",
10        "email": "[email protected]",
11        "redirect_url": "https://example.com/",
12        "anonymous": true,
13        "message": "Happy birthday!"
14      }
15    }
16  },
17  "settings": {
18    "currency": "USD",
19    "language": "en",
20    "project_id": 16184,
21    "ui": {
22      "components": {
23        "virtual_currency": {
24          "custom_amount": true
25        }
26      },
27      "desktop": {
28        "virtual_item_list": {
29          "button_with_price": true,
30          "layout": "list"
31        }
32      },
33      "size": "medium"
34    }
35  },
36  "user": {
37    "country": {
38      "allow_modify": true,
39      "value": "US"
40    },
41    "age": 19,
42    "email": {
43      "value": "[email protected]"
44    },
45    "id": {
46      "value": "user_2"
47    },
48    "name": {
49      "value": "John Smith"
50    }
51  }
52}

Usando el token recibido en el paso 2, abra la interfaz de pago en una nueva ventana, en un Iframe o usando Pay Station Embed.

Regalo destinado a un nuevo usuario

Implemente en su aplicación una interfaz para comprar una suscripción de regalo con los siguientes elementos:
- campos para introducir la dirección de correo electrónico del destinatario del regalo
- campo para introducir un mensaje del remitente (opcional)
- opción para seleccionar el envío anónimo (opcional)
- elementos para seleccionar un plan de suscripción (opcional)
Implemente la creación de un nuevo usuario y asígnele un ID en su sistema.
Cree un enlace para activar la cuenta de usuario.

Las suscripciones solo pueden venderse a usuarios autorizados.

Implemente la recepción de un token tras rellenar los detalles del regalo durante el proceso de pago. Para ello, transmita el objeto purchase.subscription.gift con los parámetros a la llamada API Crear token:
- recipient - el ID del destinatario de la suscripción creado en el paso 2.
- email - dirección de correo electrónico del destinatario.
- redirect_url - URL de activación creada en el paso 3.

Si el redirect_url no se transmite en el token, el destinatario del regalo no podrá acceder a la suscripción regalada desde el correo electrónico de notificación del regalo.

Además, puede transmitir los siguientes parámetros en el objeto purchase.subscription:
- gift.anonymous - si el regalo se envió de forma anónima. Si es true, el nombre del remitente se oculta en la notificación por correo electrónico. Por defecto es false.
- gift.message - mensaje del remitente del regalo. Se envía en una notificación por correo electrónico de la suscripción de regalo.
- plan_id - ID del plan de suscripción.

Ejemplo de solicitud para recibir un token:

Copy

Full screen

Small screen

 1{
 2  "purchase": {
 3    "checkout": {
 4      "currency": "USD",
 5      "amount": 10
 6    },
 7    "subscription": {
 8      "gift": {
 9        "recipient": "test_recipient_v1",
10        "email": "[email protected]",
11        "redirect_url": "https://example.com/",
12        "anonymous": true,
13        "message": "Happy birthday!"
14      }
15    }
16  },
17  "settings": {
18    "currency": "USD",
19    "language": "en",
20    "project_id": 16184,
21    "ui": {
22      "components": {
23        "virtual_currency": {
24          "custom_amount": true
25        }
26      },
27      "desktop": {
28        "virtual_item_list": {
29          "button_with_price": true,
30          "layout": "list"
31        }
32      },
33      "size": "medium"
34    }
35  },
36  "user": {
37    "country": {
38      "allow_modify": true,
39      "value": "US"
40    },
41    "age": 19,
42    "email": {
43      "value": "[email protected]"
44    },
45    "id": {
46      "value": "user_2"
47    },
48    "name": {
49      "value": "John Smith"
50    }
51  }
52}

Usando el token recibido en el paso 4, abra la interfaz de pago en una nueva ventana, en un Iframe o usando Pay Station Embed.

¡Gracias por tu mensaje!

Nos ayudará a mejorar tu experiencia.

Última actualización: 29 de Julio de 2026

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

Contenidos

Cómo funciona
Cómo establecerlo
Regalo destinado a un usuario existente
Regalo destinado a un nuevo usuario