• France
lyra.com
Rechercher
Catégories
Tags
France
France
Espagne
Europe (Anglais)
Inde
Implémentation
Formulaire intelligent (smartForm)
Formulaire embarqué (cartes)
API REST
API REST PCI-DSS
API REST SEPA
Formulaire en redirection
Échange de fichiers
Paiement mobile
Exemples de code
Modules de paiement
Marketplace
Back Office
Back Office Marchand
Back Office Expert
Guides
Aide
FAQ
Tutoriels vidéos
Support

Créer un formulaire 'Création de l'alias lors de la souscription d’un abonnement accompagné d’un paiement'

Cas d'utilisation : paiement et une souscription à un abonnement avec création d'un alias.

 Dans le cadre de l'application de la DSP2, une authentification forte est requise lors de l'enregistrement d'une carte. Le champ vads_threeds_mpi est ignoré et la valeur CHALLENGE_MANDATE est appliquée automatiquement.

  1. 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 REGISTER_PAY_SUBSCRIBE
    vads_amount Montant du paiement dans sa plus petite unité monétaire (le centime pour l'euro) n..12 Ex : 4525 pour 45, 25 EUR
    vads_ctx_mode Mode de communication avec la plateforme de paiement enum TEST ou PRODUCTION
    vads_currency Code numérique de la monnaie à utiliser pour le paiement, selon la norme ISO 4217 (code numérique) n3 Ex : 978 pour l'euro (EUR)
    vads_cust_email Adresse e-mail de l’acheteur ans..150 Ex : abc@example.com
    vads_action_mode Mode d’acquisition des données du moyen de paiement enum INTERACTIVE
    vads_payment_config Type de paiement enum SINGLE
    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 45, 25 EUR
    vads_sub_currency Code de la devise utilisée pour l'abonnement. n3 Ex : 978 pour l'euro (EUR)
    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_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_trans_date Date et heure du formulaire de paiement dans le fuseau horaire UTC n14

    Respectez le format AAAAMMJJHHMMSS

    Ex : 20200101130025
    vads_trans_id Numéro de la transaction.

    Doit être unique sur une même journée (de 00:00:00 UTC à 23:59:59 UTC).

    Attention : ce champ n'est pas sensible à la casse.

    an6 Ex : xrT15p
    vads_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é.
  2. Utilisez le champ vads_identifier si vous souhaitez générer l'identifiant du token associé au moyen de paiement.
    Le format du token ne doit pas être an..32. Ce format est réservé aux tokens générés par la plateforme de paiement.

    Si vous avez activé la détection de l'unicité des alias, la valeur du champ vads_identifier transmise dans le formulaire peut être différente de celle présente dans la notification si le moyen de paiement est déjà associé à un autre alias.

  3. 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 Création de l'alias lors de la souscription d’un abonnement accompagné d’un paiement.

Nous recrutons

Head Office :

LYRA NETWORK
109, rue de l’innovation
31670 Labège
FRANCE

2.16.0-doc-1.8