Étape 2a - Connecter le parcours d’inscription avec l’essai gratuit ou freemium

Cas d’usage : après l’inscription, vos clients démarrent avec un abonnement gratuit, avec ou sans limite de durée.

Ce scénario repose sur les deux appels API décrits ci-dessous.

Étape 1 – Ajouter le client

Juste après la création de compte utilisateur dans votre application web, déclarez un nouveau client via l’API.

POST https://api-42.proabono.com/v1/Customer
{
  "ReferenceSegment": "DEMO-EUR",
  "ReferenceCustomer": "cust-42",
  "Name": "John Doe",
  "Language": "en"
}

Paramètres	Descriptions
ReferenceSegment	Le segment dans lequel votre client est stocké. Lorsque votre activité se développe, vous pouvez avoir besoin de segments supplémentaires. Pour le moment, utilisez simplement celui de l’exemple ci-dessus.
ReferenceCustomer	Référence unique de ce client, partagée avec votre application web. Recommandé : utilisez votre identifiant interne avec un préfixe (par exemple : cust-42). Cela évite de stocker un champ supplémentaire en base de données et permet de déduire la ReferenceCustomer à partir de vos données existantes.
Name	Nom interne du client. Jamais affiché au client.
Language	(optionnel) langue du client

Plus d’informations et de paramètres supplémentaires dans la référence API.

Étape 2 – Créer et démarrer l’abonnement

Une fois le client ajouté avec succès, créez son abonnement gratuit.
Cette étape suppose que vous avez déjà créé une offre gratuite dans la section Catalogue.

POST https://api-42.proabono.com/v1/Subscription
{
  "ReferenceCustomer": "cust-42",
  "ReferenceOffer": "offer-free",
  "TryStart": true,
}

Paramètres	Descriptions
ReferenceCustomer	Référence unique de ce client, partagée avec votre application web. Recommandé: utilisez l’identifiant interne de l’utilisateur dans votre système avec un préfixe (ex: cust-42). Cette méthode permet de construire la référence de vos clients plutôt que d’utiliser la référence autogénérée.
ReferenceOffer	Référence de l’offre correspondant au plan gratuit. À créer au préalable dans la section Catalogue.

Plus d’informations et de paramètres supplémentaires dans la référence API.