Enviar enlace de suscripción

Usa un enlace de suscripción cuando quieras que el cliente active una suscripción sin crear un flujo de checkout en tu sitio web. Tu back office crea la suscripción y después solicita a MONEI que envíe el enlace de activación por email o SMS. El cliente abre el enlace, completa el pago inicial en una página alojada por MONEI y la suscripción pasa a estar activa.

Esto es útil para crear suscripciones manualmente o desde el back office, cuando no necesitas una integración completa de cara al cliente pero sí quieres activar el envío del enlace desde tu sistema.

Antes de empezar

• Crea primero la suscripción con el endpoint crear suscripción.
• Asegúrate de que la suscripción tenga los datos del cliente que necesitas para tu flujo.
• Decide cómo enviar el enlace: usa customerEmail para enviarlo por email, o customerPhone para enviarlo por SMS.

Enviar el enlace de activación

Los ejemplos siguientes envían el enlace de activación por email. Para enviarlo por SMS, usa customerPhone en lugar de customerEmail.

cURL

POST https://api.monei.com/v1/subscriptions/{id}/link

curl --request POST 'https://api.monei.com/v1/subscriptions/YOUR_SUBSCRIPTION_ID/link' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "customerEmail": "john.doe@example.com"
}'

Node.js

server.js

const subscription = await monei.subscriptions.sendLink('YOUR_SUBSCRIPTION_ID', {
  customerEmail: 'john.doe@example.com'
});

PHP

server.php

<?php
use Monei\Model\SendSubscriptionLinkRequest;

$subscription = $monei->subscriptions->sendLink(
  'YOUR_SUBSCRIPTION_ID',
  new SendSubscriptionLinkRequest([
    'customer_email' => 'john.doe@example.com'
  ])
);
?>

Python

server.py

from Monei import SendSubscriptionLinkRequest

subscription = monei.subscriptions.send_link(
    "YOUR_SUBSCRIPTION_ID",
    SendSubscriptionLinkRequest(
        customer_email="john.doe@example.com"
    )
)

Cuando el cliente abra el enlace y complete el pago inicial, la suscripción pasará a estar activa y la facturación recurrente comenzará según el intervalo de la suscripción.

Enviar el enlace desde el panel

No necesitas llamar a la API para enviar el enlace. Para enviarlo a mano:

1. Abre la suscripción en Panel de MONEI → Suscripciones.
2. Haz clic en Enviar enlace de suscripción.
3. Elige el canal de entrega —Email, WhatsApp o SMS— e introduce la dirección o el número de teléfono de destino. Si el número no está registrado en WhatsApp, el cliente recibirá el enlace por SMS.
4. Elige el idioma del cliente. Define el idioma del mensaje que recibe el cliente, no el de tu panel.
5. Revisa la vista previa del email y haz clic en Enviar enlace de suscripción.

Diálogo Enviar enlace de suscripción en el panel de MONEI, con el canal de envío, la dirección de destino, el idioma del cliente y una vista previa del correo