Créer un formulaire 'Utilisation d'un alias pour souscrire à un abonnement'
Cas d'utilisation : utilisation d'un alias existant et valide pour souscrire à un abonnement.
Aucun paiement ne sera réalisé lors de la souscription.
Le premier paiement sera réalisé une fois la date d'effet atteinte, entre 00h00 et 05h00.
- Utilisez l'ensemble des champs présents dans le tableau ci-après pour
construire votre formulaire.
Nom du champ Description Format Valeur vads_page_action Action à réaliser. enum SUBSCRIBE vads_ctx_mode Mode de communication avec la plateforme de paiement enum TEST ouPRODUCTION vads_action_mode Mode d’acquisition des données du moyen de paiement enum INTERACTIVE vads_identifier Alias (unique) associé à un moyen de paiement. ans..50 Ex : MonAlias Remarque : deux formats possibles :- an32 : lorsque l'alias est généré par la plateforme
- ans..50 : lorsque l'alias est généré par le marchand
vads_site_id Identifiant de la boutique n8 Ex : 12345678 vads_sub_amount Montant des échéances de l’abonnement (dans sa plus petite unité monétaire). Le montant des échéances ne peut être valorisé à 0.
n..12 Ex : 4525 pour 4525 XPF vads_sub_effect_date Date de début de l'abonnement (ou date d'effet) dans le fuseau UTC, au format AAAAMMJJ. n8 Ex : 20210601 vads_sub_currency Code de la devise utilisée pour l'abonnement. n3 Ex : 953 pour le Franc CFP (XPF) vads_sub_desc Règle de récurrence à appliquer suivant la spécification iCalendar RFC5545. Si vous demandez la création d'un abonnement pour débiter le porteur tous les jours (RRULE:FREQ=DAILY;INTERVAL=1), et que la date d'effet demandée (vads_sub_effect_date) correspond à la date de création de l'abonnement, alors lorsque la plateforme de paiement va traiter cet abonnement le lendemain matin (entre minuit et 5h), 2 paiements seront créés :- celui de la veille (correspondant à la date d'effet),
- et celui du jour.
Pour éviter cela, il est conseillé de transmettre une date d'effet au lendemain du jour de la création de l'abonnement.
string La fréquence de l'abonnement peut être journalière, hebdomadaire ou mensuelle.
Il est possible de spécifier le numéro du jour ou du mois (par exemple "le 10 du mois", "tous les 3 mois").
Remarque: la chaîne ne doit pas contenir d'espace.
Exemples:- Pour définir un abonnement toutes
les semaines:
RRULE:FREQ=WEEKLY
- Pour définir un abonnement toutes
les deux semaines, aujourd’hui et tous les 7 jours:
RRULE:FREQ=WEEKLY;INTERVAL=2
- Pour définir des échéances de
paiement ayant lieu le dernier jour de chaque mois,
pendant 12 mois:
RRULE:FREQ=MONTHLY; BYMONTHDAY=28,29,30,31; BYSETPOS=-1;COUNT=12
- Pour définir des échéances de
paiement ayant lieu le 10 de chaque mois, pendant 12
mois:
RRULE:FREQ=MONTHLY; COUNT=12;BYMONTHDAY=10
vads_trans_date Date et heure du formulaire de paiement dans le fuseau horaire UTC. n14 Respectez le format AAAAMMJJHHMMSS
Ex : 20200101130025vads_version Version du protocole d’échange avec la plateforme de paiement enum V2 signature Signature garantissant l'intégrité des requêtes échangées entre le site marchand et la plateforme de paiement. ans..44 Calculez la valeur du champ signature en utilisant l’ensemble des champs de votre formulaire, dont le nom commence par vads_ (voir chapitre Calculer la signature). La valeur de vads_sub_effect_date ne doit pas être dans le passé. - Ajoutez les champs optionnels en fonction de vos besoins (voir chapitre Utiliser des fonctions complémentaires.
La liste des champs retournés dans la notification sont décrits dans le chapitre Souscription à un abonnement.