Dans cet article, vous apprendrez comment définir, pour chaque offre d'adhésion, les frais qui doivent être collectés directement lors de l'inscription via l'Open API, ce qui se passe en cas d'échec d'un paiement, comment cela affecte l'accès de vos membres, et comment les membres peuvent choisir eux-mêmes leur date de début sur les pages du studio.
Sommaire
- Qu'est-ce que le paiement initial ?
- Configuration dans l'offre d'adhésion
- Quels frais font partie du paiement initial ?
- Rendre le paiement obligatoire pour les inscriptions via l'Open API
- Que se passe-t-il en cas d'échec d'un paiement ?
- Comment fonctionne le processus de paiement
- Cas particulier : changement d'adhésion
- Restriction d'accès pour paiements initiaux impayés
- Date de début choisie par le membre sur les pages du studio
Guide rapide
Si vous ne trouvez pas une rubrique dans la barre latérale à gauche, cliquez là sur la dernière entrée, Plus de. Utilisez Personnaliser la navigation pour choisir les rubriques qui apparaissent directement dans la barre latérale.
- Paramètres / Gestion des contrats / Offres de contrat
- Ouvrez l'offre d'adhésion concernée
- Allez dans la section Options de l'offre
- Sélectionnez les types de frais qui composent le paiement initial
- Optionnel : activez Exiger le paiement initial pour les inscriptions via l'Open API
- Optionnel : activez Annuler la création du contrat en cas d'échec de la capture du paiement initial
- Enregistrez
Qu'est-ce que le paiement initial ?
Lorsqu'un contrat est signé via l'Open API, votre partenaire API peut collecter les frais d'inscription directement dans le cadre du processus d'inscription. Vous contrôlez, pour chaque offre d'adhésion, quels types de frais comptent comme paiement initial, si ce paiement est obligatoire, et ce qui se passe en cas d'échec de la collecte. Ces paramètres affectent également directement l'accès des membres qui ont été enregistrés avec des paiements en attente.
Configuration dans l'offre d'adhésion
Tous les paramètres du paiement initial se trouvent dans la section Options de l'offre de l'offre d'adhésion concernée sous Paramètres / Gestion des contrats / Offres de contrat. Ouvrez l'offre que vous souhaitez configurer. Les trois nouveaux champs apparaissent en bas de la section. Les offres d'adhésion existantes sont automatiquement migrées avec les valeurs par défaut décrites ci-dessous. Vos opérations actuelles ne sont pas affectées par cela.
Quels frais font partie du paiement initial ?
Dans le champ Le paiement initial inclut (si dû à l'inscription), vous utilisez une sélection multiple pour définir quels types de frais comptent comme paiement initial. Les options disponibles sont : cotisation, pack de démarrage, modules supplémentaires et frais forfaitaires. Par défaut, les quatre options sont sélectionnées.
Important : seuls les frais effectivement dus au moment de la conclusion du contrat sont inclus. Les frais futurs ne font pas partie du paiement initial. Cette définition s'applique non seulement aux inscriptions via l'Open API, mais sert également de base pour la restriction d'accès sur tous les autres canaux de contrat.
Rendre le paiement obligatoire pour les inscriptions via l'Open API
L'option Exiger le paiement initial pour les inscriptions via l'Open API est inactive par défaut. Lorsque vous l'activez, votre partenaire API doit fournir un jeton de paiement valide au moment de la création du contrat. Le système vérifie automatiquement si le montant autorisé correspond exactement au total de tous les frais dus. Si les montants ne correspondent pas, l'inscription est annulée et aucun contrat n'est créé.
Si l'option est inactive, aucun jeton de paiement ne peut être transmis lors de l'inscription. Un paiement initial n'est alors pas possible via ce canal.
Vous pouvez activer cette option par étapes : définissez d'abord les types de frais, puis activez l'exigence lorsque vous êtes opérationnellement prêt. Les deux étapes sont indépendantes l'une de l'autre.
Que se passe-t-il en cas d'échec d'un paiement ?
L'option Annuler la création du contrat en cas d'échec de la capture du paiement initial est inactive par défaut. Elle prend effet lorsque la collecte effective du paiement échoue après la soumission de l'inscription.
- Option active : Le système annule la création du contrat. Le contrat est supprimé. Le dossier client est conservé. L'accès est restreint jusqu'à ce qu'une nouvelle inscription soit complétée avec succès.
- Option inactive (par défaut) : Le contrat reste en place. Le montant impayé est enregistré dans le compte membre et peut être collecté via vos processus habituels, par exemple par un traitement de paiement ou un rappel.
Comment fonctionne le processus de paiement
Pour comprendre quand un échec peut se produire, voici comment fonctionne le processus : lorsqu'un membre s'inscrit via l'Open API, il autorise le paiement à l'avance via l'interface de paiement de votre partenaire. Cette autorisation bloque le montant mais ne le collecte pas encore. La collecte effective a lieu une fois que le contrat et les frais associés ont été enregistrés dans le système. Un échec peut survenir à ce moment, par exemple si la carte a été bloquée ou si l'autorisation a expiré entre-temps. Si le jeton de paiement n'est pas utilisé dans sa période de validité, l'autorisation est automatiquement annulée et les fonds sont libérés.
Pour les partenaires API : le point de terminaison preview renvoie le drapeau mandatoryOnSigning pour chaque frais dû, ainsi que le total de tous les frais obligatoires dans le champ dueOnSigningAmount. Le jeton de paiement ne doit être demandé et transmis qu'en fonction de ce montant exact.
Cas particulier : changement d'adhésion
Pour les changements d'adhésion via l'Open API, les mêmes paramètres s'appliquent que pour les inscriptions initiales. Une exception existe : si l'offre d'adhésion a l'option d'ignorer les coûts initiaux au début de l'adhésion activée, tous les frais sont considérés comme non dus au moment du changement. Dans ce cas, le point de terminaison preview renvoie mandatoryOnSigning: false pour tous les frais et le montant total dû est zéro. Le point de terminaison de changement n'acceptera pas de jeton de paiement dans ce scénario.
Restriction d'accès pour paiements initiaux impayés
Si la configuration de restriction d'accès de votre studio a l'option de restreindre l'accès pour les paiements initiaux non équilibrés activée, les scénarios suivants s'appliquent :
- Le paiement a été autorisé mais la collecte échoue plus tard, pas de rollback : Le contrat reste. L'accès du membre est restreint jusqu'à ce que le montant impayé soit réglé.
- Le paiement n'était pas obligatoire à l'inscription : L'accès du membre est restreint jusqu'à ce que le paiement initial soit réglé rétroactivement.
- Le paiement échoue et le rollback est actif : Aucun contrat n'existe. Le dossier client reste, mais sans adhésion active, l'accès n'est pas possible.
- Inscriptions via d'autres canaux tels que la zone de support commercial, la plateforme membre ou les pages d'atterrissage : ces contrats sont également soumis à une restriction d'accès si le paiement initial est défini dans l'offre d'adhésion et n'a pas été réglé. L'accès n'est accordé qu'une fois que tous les types de frais définis ont été équilibrés dans le compte membre.
Date de début choisie par le membre sur les pages du studio
Disponible à partir du 7 octobre 2026.
Sur les pages de votre studio, vous pouvez laisser les nouveaux membres choisir eux-mêmes la date de début de leur adhésion lors de l'inscription en ligne. Il ne s'agit pas d'un paramètre de l'Open API : vous l'activez séparément pour chaque page, et décidez ainsi sur quelles pages la sélection de la date est proposée.
- Ouvrez Paramètres / Landing pages par MySports / Pages vente en ligne et sélectionnez la page.
- Modifiez la section Page des tarifs. La boîte de dialogue Modifier la configuration s'ouvre.
- Activez Permettre aux membres de choisir la date de début de leur adhésion et enregistrez.
L'image montre l'interface en anglais : section Page des tarifs d'une page du studio avec le statut de l'option permettant aux membres de choisir la date de début.
L'image montre l'interface en anglais : boîte de dialogue Modifier la configuration avec la case permettant aux membres de choisir la date de début.
Lors de l'inscription sur cette page, les membres voient alors une étape supplémentaire dans laquelle ils choisissent la date de début :
- Le champ de date est prérempli avec la date de début la plus proche possible de l'offre d'adhésion. Pour les offres qui commencent à la conclusion du contrat, il s'agit de la date du jour.
- Les membres peuvent choisir une date ultérieure, jusqu'à 365 jours après la date de début la plus proche possible. Les dates antérieures ne sont pas acceptées.
- Si l'option Début du contrat est définie sur Date fixe dans l'offre d'adhésion, la sélection de la date n'est pas affichée et la date fixe s'applique. Les membres ne peuvent pas la modifier.
Pour savoir comment la date de début du contrat et la date de début d'utilisation sont liées, consultez l'article Utilisation précontractuelle, périodes bonus et date de début choisie par le membre.
Remarque : Cet article a été créé à l'aide de l'intelligence artificielle et traduit automatiquement sans relecture. Nous vous prions de nous excuser pour d'éventuelles erreurs.