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.