Créer un abonnement accompagné d'un paiement
Assurez-vous d' avoir intégré les chapitres suivants du guide Intégration
avancée :
- Le chapitre "Établir le dialogue avec la plateforme de paiement".
- Le chapitre "Calculer la signature".
Dans une requête POST, intégrez les
données suivantes :
- Champs obligatoires
- Action à réaliser avec le champ vads_page_action. Ex : REGISTER_PAY_SUBSCRIBE.
- Montant exprimé dans la plus petite unité de la monnaie ou devise avec le champ vads_amount. Ex : 10000 pour 100 XPF.
- Devise avec le champ vads_currency. Ex :XPF.
- Mode d’acquisition avec le champ vads_action_mode. Ex : INTERACTIVE.
- Mode de communication avec le champ vads_ctx_mode. Ex : TEST.
- E-mail de l'acheteur avec le champ vads_cust_email. Ex : sample@example.com.
- Type de paiement avec le champ vads_page_config. Ex : SINGLE.
- Identifiant de la boutique avec le champ vads_site_id. Ex :12345678.
- Montant des échéances de l’abonnement dans la plus petite unité de la monnaie ou devise avec le champ vads_sub_amount. Ex : 10 XPF.
- Devise de l'abonnement avec le champ vads_sub_amount. Ex : 953 pour le Franc CFP (XPF)
- Règle de récurrence (spécification iCalendar RFC5545) avec le
champ vads_sub_desc.
- Ex : 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
- Ex : 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
- Ex : Pour définir des échéances de paiement
ayant lieu le 10 de chaque mois, pendant 12
mois:
- Date de début de l'abonnement avec le champ vads_sub_effect_date. Ex : 20210601.
- Horodatage (AAAAMMJJHHMMSS) avec le champ vads_trans_date. Ex : 20250626101407.
- Numéro de la transaction avec le champ vads_trans_id. Ex : pt156G.
- Numéro de version avec le champ vads_version. Ex : V2.
- Signature pour sécuriser les échanges. Ex : 0WaYrONo3L0VZqMcvyVf8vT/g8KfZKJ+1jqiAs3Ehiw=
- Exemple de code
- Créer un abonnement acompagné d'un paiement de 100
XPF.
- Montant de chaque échéance : 10 XPF.
- Le dernier jour de chaque mois.
- Pendant 12 mois.
<form method="POST" action="https://epaync.nc/vads-payment/"> <input type="hidden" name="vads_action_mode" value="INTERACTIVE" /> <input type="hidden" name="vads_amount" value="10000" /> <input type="hidden" name="vads_ctx_mode" value="TEST" /> <input type="hidden" name="vads_currency" value="953" /> <input type="hidden" name="vads_cust_email" value="sample@example.com" /> <input type="hidden" name="vads_page_action" value=""REGISTER_PAY_SUBSCRIBE" /> <input type="hidden" name="vads_payment_config" value="SINGLE" /> <input type="hidden" name="vads_site_id" value="12345678" /> <input type="hidden" name="vads_sub_amount" value="1000" /> <input type="hidden" name="vads_sub_currency" value="953" /> <input type="hidden" name="vads_sub_desc" value="RRULE:FREQ=MONTHLY;BYMONTHDAY=28,29,30,31;BYSETPOS=-1;COUNT=12;" /> <input type="hidden" name="vads_sub_effect_date" value="20250310" /> <input type="hidden" name="vads_trans_date" value="20250306142106" /> <input type="hidden" name="vads_trans_id" value="pt156G" /> <input type="hidden" name="vads_version" value="V2" /> <input type="hidden" name="signature" value="0WaYrONo3L0VZqMcvyVf8vT/g8KfZKJ+1jqiAs3Ehiw="/> <input type="submit" name="payer" value="Payer"/> </form>
- Créer un abonnement acompagné d'un paiement de 100
XPF.
Retrouvez la description et l'intégralité des champs vads_ dans le Dictionnaire des données .
Pour avoir plus de détails, voir le guide complet : Paiements par token et abonnements.