Send subscription link

Use a subscription link when you want the customer to activate a subscription without building a checkout flow on your website. Your back office creates the subscription, then asks MONEI to send the activation link by email or SMS. The customer opens the link, completes the initial payment on a MONEI-hosted page, and the subscription becomes active.

This is useful for manual or back-office subscription creation, where you do not need a full customer-facing integration but still want to trigger the activation link from your system.

Before you begin

• Create the subscription first using the create subscription endpoint.
• Make sure the subscription has the customer details you need for your flow.
• Decide how to deliver the link: use customerEmail to send it by email, or customerPhone to send it by SMS.

Send the activation link

The examples below send the activation link by email. To send the link by SMS, use customerPhone instead of 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"
    )
)

After the customer opens the link and completes the initial payment, the subscription becomes active and recurring billing starts according to the subscription interval.

Send the link from the Dashboard

You don't have to call the API to send the link. To send it by hand:

1. Open the subscription in MONEI Dashboard → Subscriptions.
2. Click Send subscription link.
3. Choose the Delivery channel — Email, WhatsApp, or SMS — and enter the address or phone number to send it to. If the phone number is not registered in WhatsApp, the customer gets the link by SMS instead.
4. Choose the Customer language. It sets the language of the message the customer receives, not the language of your dashboard.
5. Check the Email preview, then click Send subscription link.

Send subscription link dialog in the MONEI Dashboard, with the delivery channel, the address to send to, the customer language and a preview of the email