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:

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

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

1. 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)

2. 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 Create 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.

• 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:

{
  "purchase": {
    "checkout": {
      "currency": "USD",
      "amount": 10
    },
    "subscription": {
      "gift": {
        "recipient": "test_recipient_v1",
        "email": "recipient_email@email.com",
        "redirect_url": "https://example.com/",
        "anonymous": true,
        "message": "Happy birthday!"
      }
    }
  },
  "settings": {
    "currency": "USD",
    "language": "en",
    "project_id": 16184,
    "ui": {
      "components": {
        "virtual_currency": {
          "custom_amount": true
        }
      },
      "desktop": {
        "virtual_item_list": {
          "button_with_price": true,
          "layout": "list"
        }
      },
      "size": "medium"
    }
  },
  "user": {
    "country": {
      "allow_modify": true,
      "value": "US"
    },
    "age": 19,
    "email": {
      "value": "john.smith@mail.com"
    },
    "id": {
      "value": "user_2"
    },
    "name": {
      "value": "John Smith"
    }
  }
}

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

1. 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)
2. Implemente la creación de un nuevo usuario y asígnele un ID en su sistema.
3. Cree un enlace para activar la cuenta de usuario.

4. 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 Create 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.

• 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:

{
  "purchase": {
    "checkout": {
      "currency": "USD",
      "amount": 10
    },
    "subscription": {
      "gift": {
        "recipient": "test_recipient_v1",
        "email": "recipient_email@email.com",
        "redirect_url": "https://example.com/",
        "anonymous": true,
        "message": "Happy birthday!"
      }
    }
  },
  "settings": {
    "currency": "USD",
    "language": "en",
    "project_id": 16184,
    "ui": {
      "components": {
        "virtual_currency": {
          "custom_amount": true
        }
      },
      "desktop": {
        "virtual_item_list": {
          "button_with_price": true,
          "layout": "list"
        }
      },
      "size": "medium"
    }
  },
  "user": {
    "country": {
      "allow_modify": true,
      "value": "US"
    },
    "age": 19,
    "email": {
      "value": "john.smith@mail.com"
    },
    "id": {
      "value": "user_2"
    },
    "name": {
      "value": "John Smith"
    }
  }
}

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