Exemples de code et d'application :


 

Avant de vous lancer dans l'implémentation d'un paiement par identifiant ou d'un paiement récurrent, prenez connaissance de la documentation 'Guide d'implementation formulaire de paiement'
 
 
Formulaire de paiement : pré-requis
 
Les cas décrits ci-dessous nécessitent que le formulaire posté à la plateforme de paiement contienne au minimum tous les champs suivants :

Nom du champ Format Valeur
signature an40 Clé de cryptage permettant à la plateforme de vérifier la validité de la requête
vads_version   V2
vads_site_id n8 Identifiant de votre boutique
vads_ctx_mode   TEST ou PRODUCTION
vads_action_mode   INTERACTIVE ou SILENT *
vads_trans_date n14 Correspond à la date et heure courante, dans le fuseau GMT (ou UTC) au format AAAAMMJJHHMMSS
vads_page_action   Défini l'action à mener. Les valeurs possibles sont décrites ci-après

* Le mode SILENT implique que la saisie des informations bancaires soit effectuée par le site marchand. Renseignez-vous auprès de votre chargé de clientèle sur les contraintes techniques qui en découlent.
 

Cas S1 : Inscription sans paiement

Exemple d'application :

Je souhaite que mes clients ne soient pas obligés de saisir leur numéro de carte à chaque paiement.
 
Mise en oeuvre :
L'inscription se fait par l'intermédiaire d'un formulaire envoyé à la plateforme de paiement et dans lequel, le champ contenant l'adresse email est obligatoire (vads_cust_email).
Le champ vads_page_action doit être valorisé à REGISTER.
 
Nom du champ Format Valeur
signature an40 Clé de cryptage permettant à la plateforme de vérifier la validité de la requête
vads_version   V2
vads_site_id n8 Identifiant de votre boutique
vads_ctx_mode   TEST ou PRODUCTION
vads_action_mode   INTERACTIVE ou SILENT
vads_trans_date n14 Correspond à la date et heure courante, dans le fuseau GMT (ou UTC) au format AAAAMMJJHHMMSS
vads_page_action   REGISTER
vads_cust_email an.127 Adresse email du client

A la fin de l'inscription, si tous les contrôles sur la carte ont abouti avec succès, un identifiant d’inscription unique sera attribué. Il correspond au compte carte nouvellement créé et pourra être utilisé pour faire des opérations sur la carte bancaire liée à cet identifiant (voir Cas S6: Paiement par identifiant).

Vous avez la possibilité de générez vous-même cet identifiant en renseignant le champ vads_identifier.

Remarque :

La plateforme de paiement ne vous informera pas lorsqu'une carte arrivera à expiration. Cette gestion est à la charge du site marchand. Il vous reviendra donc de conserver en base la date d'expiration de la carte et de notifier l'internaute de l'expiration prochaine de sa carte au moment voulu.
Pour permettre à l'internaute de mettre à jour ses données, vous devez utiliser la fonction update (voir cas S2).

 Pour télécharger l'exemple d'implémentation en php, cliquer ici.

 

Cas S2 : Mise à jour du porteur

Exemple d'application :

Je souhaite modifier mes informations personnelles ou les informations liées à ma carte bancaire (carte périmée par exemple).
 

Mise en oeuvre :

La mise à jour se fait à l'initiative de l'internaute.
Le champ vads_page_action doit être valorisé à REGISTER_UPDATE.
Les champs suivants sont obligatoires :
 

 

Nom du champ Format Valeur
signature an40 Clé de cryptage permettant à la plateforme de vérifier la validité de la requête
vads_version   V2
vads_site_id n8 Identifiant de votre boutique
vads_ctx_mode   TEST ou PRODUCTION
vads_action_mode   INTERACTIVE ou SILENT
vads_trans_date n14 Correspond à la date et heure courante, dans le fuseau GMT (ou UTC) au format AAAAMMJJHHMMSS
vads_page_action   REGISTER_UPDATE
vads_cust_email an.127 Adresse email du client
vads_identifier ans..50 Identifiant unique attribué lors de l'inscription de la carte.

 

Remarques :

- le compte carte à mettre à jour doit exister dans le mode d'environnement choisi (vads_ctx_mode).
- la valeur du champ vads_cust_email peut être différente de celle déja enregistrée pour le compte carte.
 
 
 
 Cas S3 : Inscription avec paiement
 

Exemple d'application :

Je souhaite consulter des annonces sur un site et l'inscription est payante.

Mise en oeuvre :

La mise en oeuvre est identique pour la partie inscription (voir cas S1).
Le champ vads_page_action doit être valorisé à REGISTER_PAY.

Les paramètres nécessaires à une demande de paiement devront compléter la demande d'inscription.
les champs suivants seront donc obligatoires :
 
Nom du champ Format Valeur
signature an40 Clé de cryptage permettant à la plateforme de vérifier la validité de la requête
vads_version   V2
vads_site_id n8 Identifiant de votre boutique
vads_ctx_mode   TEST ou PRODUCTION
vads_action_mode   INTERACTIVE ou SILENT
vads_trans_date n14 Correspond à la date et heure courante, dans le fuseau GMT (ou UTC) au format AAAAMMJJHHMMSS
vads_page_action   REGISTER_PAY
vads_cust_email an.127 Adresse email du client
vads_payment_config   Indique le type du paiement (SINGLE ou MULTI)
vads_amount n..12 Montant de la transaction exprimé en centimes
vads_currency n3 Indique la monnaie à utiliser. Exemple :978 pour l'Euro (norme ISO 4217)
vads_trans_id n6 Identifiant unique de la transaction compris entre 000000 et 899999.

 

 Pour télécharger l'exemple d'implémentation en php, cliquer ici.

 

Cas S4 : Inscription avec définition de récurrence

Exemple d'application :

Je m'inscris et souscris à un abonnement de 29,90€ pour une durée de 12 mois.

Mise en oeuvre :

La mise en oeuvre est identique pour la partie inscription (voir cas S1).
Le champ vads_page_action doit être valorisé à REGISTER_SUBSCRIBE.

Les informations nécessaires à la définition de la récurrence doivent compléter la demande d'inscription.
Les champs suivants sont donc obligatoires :
 

 

Nom du champ Format Valeur
signature an40 Clé de cryptage permettant à la plateforme de vérifier la validité de la requête
vads_version   V2
vads_site_id n8 Identifiant de votre boutique
vads_ctx_mode   TEST ou PRODUCTION
vads_action_mode   INTERACTIVE ou SILENT
vads_trans_date n14 Correspond à la date et heure courante, dans le fuseau GMT (ou UTC) au format AAAAMMJJHHMMSS
vads_page_action   REGISTER_SUBSCRIBE
vads_cust_email an.127 Adresse email du client
vads_sub_amount n..12 Montant des échéances hormis les échéances définies éventuellement par vads_sub_init_amount_number (voir le deuxième exemple d'application)
vads_sub_currency n3 Indique la monnaie à utiliser. Exemple :978 pour l'Euro (norme ISO 4217)
vads_sub_effect_date n8 Indique la date de début de l'abonnement au format AAAAMMJJ
vads_sub_desc   Défini la règle de récurrence à appliquer suivant la spécification iCalendar RFC5545).

 

Dans notre exemple, ils seront valorisés ainsi :
- vads_page_action = REGISTER_SUBSCRIBE
- vads_sub_amount = 2990
- vads_sub_currency = 978
- vads_sub_effect_date = 'la date du jour'
- vads_sub_desc = RRULE:MONTHLY;BYMONTHDAY='le jour de l'inscription';COUNT=12

 Pour télécharger l'exemple d'implémentation en php, cliquer ici.

Autre exemple d'application :

Je m'inscris et souscris à un abonnement de 29,90€ pour une durée de 12 mois. Les 3 premiers mois sont offerts.

Mise en oeuvre :

La mise en oeuvre est identique pour la partie inscription (voir cas S1).
La mise en oeuvre est identique à l'exemple précédent.
La demande doit être complétée des champs suivants :
vads_sub_init_amount
vads_sub_init_amount_number.
Ils permettent de définir le montant de la première échéance ainsi que le nombre d'échéances auxquelles il faudra appliquer le montant vads_sub_init_amount.
 

 

Nom du champ Format Valeur
signature an40 Clé de cryptage permettant à la plateforme de vérifier la validité de la requête
vads_version   V2
vads_site_id n8 Identifiant de votre boutique
vads_ctx_mode   TEST ou PRODUCTION
vads_action_mode   INTERACTIVE ou SILENT
vads_trans_date n14 Correspond à la date et heure courante, dans le fuseau GMT (ou UTC) au format AAAAMMJJHHMMSS
vads_page_action   REGISTER_SUBSCRIBE
vads_cust_email an.127 Adresse email du client
vads_sub_amount n..12 Montant des échéances hormis les échéances définies par vads_sub_init_amount_number
vads_sub_currency n3 Indique la monnaie à utiliser. Exemple :978 pour l'Euro (norme ISO 4217)
vads_sub_effect_date n8 Indique la date de début de l'abonnement au format AAAAMMJJ
vads_sub_desc   Défini la règle de récurrence à appliquer suivant la spécification iCalendar RFC5545).
vads_sub_init_amount n..12 Montant des premières échéances dont le nombre est défini par le paramètre vads_sub_init_amount_number
vads_sub_init_amount_number n..3 Nombre d’échéances auxquelles il faudra appliquer le montant vads_sub_init_amount

 

Dans notre exemple, ils seront valorisés ainsi :
- vads_page_action = REGISTER_SUBSCRIBE
- vads_sub_amount = 2990
- vads_sub_currency = 978
- vads_sub_effect_date = 'la date du jour'
- vads_sub_desc = RRULE:MONTHLY;BYMONTHDAY='le jour de l'inscription';COUNT=12
- vads_sub_init_amount = 0
- vads_sub_init_amount_number = 3

 Pour télécharger l'exemple d'implémentation en php, cliquer ici.

 

Cas S5 : Inscription avec paiement et définition de récurrence

Exemple d'application :

Je m'inscris et souscris à un abonnement de 29,90€ pour une durée de 12 mois.
Je paye une caution de 49€ pour la location du matériel.

Mise en oeuvre :

La mise en oeuvre est identique pour la partie inscription (voir cas S1).
La définition de la récurrence est identique à l'exemple 1 du cas S4.
Le champ vads_page_action doit être valorisé à REGISTER_PAY_SUBSCRIBE.

La demande d'inscription et de récurrence doit être completée par les informations nécessaires au paiement:
Les champs suivants sont donc obligatoires :

 

 

Nom du champ Format Valeur
signature an40 Clé de cryptage permettant à la plateforme de vérifier la validité de la requête
vads_version   V2
vads_site_id n8 Identifiant de votre boutique
vads_ctx_mode   TEST ou PRODUCTION
vads_action_mode   INTERACTIVE ou SILENT
vads_trans_date n14 Correspond à la date et heure courante, dans le fuseau GMT (ou UTC) au format AAAAMMJJHHMMSS
vads_page_action   REGISTER_PAY_SUBSCRIBE
vads_cust_email an.127 Adresse email du client
vads_sub_amount n..12 Montant des échéances hormis les échéances définies éventuellement par vads_sub_init_amount_number (voir le deuxième exemple d'application)
vads_sub_currency n3 Indique la monnaie à utiliser. Exemple :978 pour l'Euro (norme ISO 4217)
vads_sub_effect_date n8 Indique la date de début de l'abonnement au format AAAAMMJJ
vads_sub_desc   Défini la règle de récurrence à appliquer suivant la spécification iCalendar RFC5545).
vads_payment_config   Indique le type du paiement (SINGLE ou MULTI)
vads_amount n..12 Montant de la transaction exprimé en centimes
vads_currency n3 Indique la monnaie à utiliser. Exemple :978 pour l'Euro (norme ISO 4217)
vads_trans_id n6 Identifiant unique de la transaction compris entre 000000 et 899999.

 

Dans notre exemple, ils seront valorisés ainsi :
- vads_page_action = REGISTER_PAY_SUBSCRIBE
- vads_sub_amount = 2990
- vads_sub_currency = 978
- vads_sub_effect_date = 'la date du jour'
- vads_sub_desc = RRULE:MONTHLY;BYMONTHDAY='le jour de l'inscription';COUNT=12
- vads_payment_config = SINGLE
- vads_amount = 4900
- vads_currency = 978
- vads_trans_id = 123456

 Pour télécharger l'exemple d'implémentation en php, cliquer ici.

 

Cas S6 : Paiement par identifiant

Exemple d'application:

Permet de réaliser des paiements sans avoir à selectionner un moyen de paiement et à saisir un numéro de carte bancaire.
Ce mode de fonctionnement requiert l'enregistrement préalable d'un compte carte (Cas S1).
 

Mise en oeuvre:

Le champ vads_page_action doit être valorisé à PAYMENT
Les champs suivants sont obligatoires:
 
Nom du champ Format Valeur
signature an40 Clé de cryptage permettant à la plateforme de vérifier la validité de la requête
vads_version   V2
vads_site_id n8 Identifiant de votre boutique
vads_ctx_mode   TEST ou PRODUCTION
vads_action_mode   INTERACTIVE ou SILENT
vads_trans_date n14 Correspond à la date et heure courante, dans le fuseau GMT (ou UTC) au format AAAAMMJJHHMMSS
vads_page_action   PAYMENT
vads_identifier ans..50 Identifiant unique attribué lors de l'inscription de la carte.
vads_payment_config   Indique le type du paiement (SINGLE ou MULTI)
vads_amount n..12 Montant de la transaction exprimé en centimes
vads_currency n3 Indique la monnaie à utiliser. Exemple :978 pour l'Euro (norme ISO 4217)
vads_trans_id n6 Identifiant unique de la transaction compris entre 000000 et 899999.

 

 

 Pour télécharger l'exemple d'implémentation en php, cliquer ici.

 

Cas S7: Définition de récurrence sans inscription
 
Exemple d'application :
Je suis déjà inscris sur un site. Ma période d'abonnement est terminée et je souhaite renouveller mon abonnement.
 

Mise en oeuvre :

Le champ vads_page_action doit être valorisé à SUBSCRIBE.
Les champs suivants sont obligatoires :

 
Nom du champ Format Valeur
signature an40 Clé de cryptage permettant à la plateforme de vérifier la validité de la requête
vads_version   V2
vads_site_id n8 Identifiant de votre boutique
vads_ctx_mode   TEST ou PRODUCTION
vads_action_mode   INTERACTIVE ou SILENT
vads_trans_date n14 Correspond à la date et heure courante, dans le fuseau GMT (ou UTC) au format AAAAMMJJHHMMSS
vads_page_action   SUBSCRIBE
vads_identifier ans..50 Identifiant unique attribué lors de l'inscription de la carte.
vads_sub_amount n..12 Montant des échéances hormis les échéances définies éventuellement par vads_sub_init_amount_number (voir le deuxième exemple d'application)
vads_sub_currency n3 Indique la monnaie à utiliser. Exemple :978 pour l'Euro (norme ISO 4217)
vads_sub_effect_date n8 Indique la date de début de l'abonnement au format AAAAMMJJ
vads_sub_desc   Défini la règle de récurrence à appliquer suivant la spécification iCalendar RFC5545).

 

 

  Pour télécharger l'exemple d'implémentation en php, cliquer ici.