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

Pour comprendre le résultat, analysez les champs ci-dessous :

Nom du champ Description
vads_page_action Action réalisée.

La valeur retournée est REGISTER_PAY_SUBSCRIBE.

vads_identifier_status Statut de la création de alias.

Les valeurs possibles sont :

  • CREATED  : la demande d’autorisation ou de renseignement si l'acquéreur le supporte est acceptée.

    L'alias est créé avec succès.

    Consultez la valeur du champ vads_recurrence_status pour déterminer si l'abonnement est créé.

  • NOT_CREATED  : la demande d’autorisation ou de renseignement est refusée.

    L'alias n'est pas créé et n'apparaît pas dans le Back Office Expert. L'abonnement n'est pas créé.

  • ABANDONED  : action abandonnée par l'acheteur.

    L'alias n'est pas créé et n'apparaîtra pas dans le Back Office Expert.

    L'abonnement n'est pas créé.

vads_trans_status Statut de la transaction.

Les valeurs possibles sont :

  • AUTHORISED

    La demande d'autorisation ou de renseignement a été acceptée.

    L'alias est créé et visible dans le Back Office Expert.

  • AUTHORISED_TO_VALIDATE

    La demande d'autorisation ou de renseignement a été acceptée.

    Le marchand doit valider manuellement la transaction.

    L'alias est créé et visible dans le Back Office Expert.

  • CAPTURED

    La demande d'autorisation ou de renseignement a été acceptée.

    Le paiement est visible dans l'onglet "Transactions remisées" du Back Office.

    L'alias est créé et visible dans le Back Office Expert.

  • WAITING_AUTHORISATION

    Le délai de remise en banque est supérieur à la durée de validité de l'autorisation. La demande d'autorisation pour le montant total n'a pas encore eu lieu.

    L'alias est créé et visible dans le Back Office Expert.

  • WAITING_AUTHORISATION_TO_VALIDATE

    A valider et autoriser

    Le délai de remise en banque est supérieur à la durée de validité de l'autorisation.

    Une autorisation 1 EUR (ou demande de renseignement sur le réseau CB si l'acquéreur le supporte) a été acceptée.

    Le marchand doit valider manuellement la transaction afin de déclencher la demande d’autorisation et la capture.

  • REFUSED

    La demande d'autorisation ou de renseignement a été refusée.

    L'alias n'est pas créé.

  • ABANDONED

    Opération abandonnée par l'acheteur.

    La transaction n'apparaît pas dans le Back Office Expert.

    L'alias n'est pas créé.

vads_recurrence_status Statut de la création de l'abonnement.

Les valeurs possibles sont :

  • CREATED  : L'abonnement est créé avec succès.
  • NOT_CREATED  : L'abonnement n'est pas créé.
  • ABANDONED  : action abandonnée par l'acheteur. L'abonnement n'est pas créé.
vads_identifier Identifiant de l'alias.
La valeur retournée est :
  • soit identique à la valeur transmise dans la requête, quel que soit le résultat de la création de l'alias, même en cas d'abandon,
  • soit la valeur générée par la plateforme, si le champ n'est pas transmis dans la requête et que l'alias est bien créé (vads_identifier_status=CREATED).

Remarque

Si vous avez activé la vérification de l'unicité des alias et que le moyen de paiement est déjà enregistré avec un autre alias, alors c'est cet alias qui sera retourné.

Le champ vads_identifier ne sera pas retourné :
  • s'il n'est pas transmis dans la requête et que l'acheteur abandonne (vads_identifier_status=ABANDONED),
  • s'il n'est pas transmis dans la requête et que l'alias n'est pas créé (vads_identifier_status=NOT_CREATED).
vads_identifier_previously_registered Uniquement présent si les deux conditions sont vraies :
  • vous avez activé la vérification de l'unicité des alias,
  • le moyen de paiement utilisé est déjà enregistré avec un autre alias.
vads_initial_issuer_transaction_identifier Identifiant de transaction unique généré par l'émetteur.
 L'identifiant de transaction émetteur est stocké par la plateforme de paiement au niveau de l'alias et de la transaction. En fonction de l'utilisation que vous ferez de l'alias (paiement 1 clic, paiement 0 clic, abonnement, etc.) l'identifiant de transaction émetteur sera utilisé comme référence de chaînage si nécessaire.
vads_cust_email Adresse e-mail de l'acheteur transmise dans la requête.
vads_site_id Identifiant de la boutique.

La valeur retournée est identique à celle transmise dans la requête.

vads_ctx_mode Mode de fonctionnement.

La valeur retournée ( TEST ou PRODUCTION) est identique à celle transmise dans la requête.

Pour connaître le détail de l'abonnement consultez les paramètres ci-dessous :
Nom du champ Remarque
vads_subscription Identifiant de l'abonnement.
La valeur retournée est :
  • soit la valeur transmise dans la requête, quel que soit le résultat de la création de l'abonnement,
  • soit la valeur de générée par la plateforme de paiement, si le champ n'est pas transmis dans la requête et que l'abonnement est créé avec succès (vads_recurrence_status=CREATED).

Le champ vads_subscription ne sera pas retourné :
  • s'il n'est pas transmis dans la requête et que l'acheteur abandonne (vads_recurrence_status=ABANDONED),
  • s'il n'est pas transmis dans la requête et que l'abonnement n'est pas créé (vads_recurrence_status=NOT_CREATED).
vads_sub_amount

Montant des échéances de l’abonnement (dans sa plus petite unité monétaire).

vads_sub_currency Code de la devise utilisée pour l'abonnement.

Ex : 978 pour l'euro (EUR)

vads_sub_desc Règle de récurrence à appliquer suivant la spécification iCalendar RFC5545.

Ex : RRULE:FREQ=MONTHLY

vads_sub_effect_date Date de début de l'abonnement (ou date d'effet) dans le fuseau UTC, au format AAAAMMJJ.

Ex : 20210601

vads_sub_init_amount

Montant des premières échéances. Le nombre des premières échéances est défini par vads_sub_init_amount_number.

Ex : 1000

vads_sub_init_amount_number Nombre d'échéances auxquelles sera appliqué le montant défini par vads_sub_init_amount.

Ex : 3

Pour connaître le détail du paiement consultez les paramètres ci-dessous :

Informations sur la transaction :

Nom du champ Description
vads_operation_type Type de transaction.

Sa valeur est DEBIT.

vads_occurrence_type Type d'occurrence de la transaction.

Sa valeur est UNITAIRE.

vads_amount Montant de la transaction.

La valeur retournée est identique à celle transmise dans la requête.

vads_currency Code de la devise utilisée pour le paiement.
vads_trans_id Identifiant de la transaction.

La valeur retournée est identique à celle transmise dans la requête.

vads_trans_uuid Identifiant unique de la transaction.

Sa valeur est générée par la plateforme de paiement.

vads_contract_used Numéro du contrat associé à la transaction.
vads_auth_mode Type de demande réalisée auprès des serveurs d'autorisation:
  • MARK  : correspond à une autorisation de 1 EUR (ou demande de renseignement sur le réseau CB si l'acquéreur le supporte).

    Valeur utilisée également si la durée séparant la date de remise demandée de la date du jour est strictement supérieure à la durée de validité de l'autorisation.

  • FULL  : correspond à une autorisation du montant total de la transaction.

    Valeur utilisée si la durée séparant la date de remise demandée de la date du jour est strictement inférieure à la durée de validité de l'autorisation.

vads_auth_number Numéro d'autorisation retourné par le serveur d'autorisation.

Vide si autorisation échouée.

vads_auth_result Code retour de la demande d'autorisation retournée par la banque émettrice.

Vide si erreur avant autorisation.

vads_risk_control Résultat des contrôles de risque.

Lorsque qu'au moins un contrôle retourne la valeur ERROR, la transaction est refusée.

Consultez la description du champ vads_risk_analysis_result pour plus de détails.

vads_risk_assessment_result

Liste des actions réalisées sur la transaction, suite au déclenchement des règles de gestion de risque avancée.

Les valeurs possibles sont:

  • ENABLE_3DS  : 3D Secure activé.
  • DISABLE_3DS  : 3D Secure désactivé.
  • CHALLENGE_REQUESTED  :
    • Carte 3DS1 : Le module de risque a demandé une authentification 3DS.
    • Carte 3DS2 : Le module de risque a demandé une authentification avec interaction du porteur (challenge).
  • CHALLENGE_MANDATE  :
    • Carte 3DS1 : Le module de risque a demandé une authentification 3DS.
    • Carte 3DS2 : Le module de risque a demandé une authentification avec interaction du porteur (challenge) pour des raisons réglementaires.
  • MANUAL_VALIDATION  : La transaction est créée en validation manuelle.

    La remise du paiement est bloquée temporairement pour permettre au marchand de procéder à toutes les vérifications souhaitées.

  • REFUSE  : La transaction est refusée.
  • RUN_RISK_ANALYSIS  : Résultat de l'analyseur de risques externe.

    Consultez la description du champ vads_risk_analysis_result pour plus de détails.

  • INFORM  : Une alerte est remontée.

    Le marchand est averti qu’un risque est identifié via une ou plusieurs des règles du centre de notification.

Informations sur le moyen de paiement utilisé :
Nom du champ Remarque
vads_acquirer_network Code du réseau acquéreur.
vads_bank_code Code de la banque émettrice
vads_bank_label Nom de la banque émettrice de la carte utilisé.
vads_bank_product Code produit de la carte utilisée.
vads_card_brand Moyen de paiement utilisé.

Consultez le chapitre Moyens de paiement compatibles pour obtenir la liste des valeurs possibles.

vads_card_country Code pays de la carte utilisée à la norme ISO 3166.
vads_card_number Numéro de carte tronqué/masqué

ou

IBAN et BIC utilisés pour le paiement, séparés par un « _ » dans le cas d’un prélèvement ponctuel.

Le BIC étant optionnel, il peut ne pas être présent

.
vads_expiry_month Mois d’expiration de la carte utilisée.
vads_expiry_year Année d’expiration de la carte utilisée.

Détails de l'authentification du porteur :
Nom du champ Remarque
vads_threeds_auth_type Type d’authentification du porteur.

Une authentification forte du porteur est obligatoire lors de l'enregistrement d'une carte. Le champ sera donc toujours valorisé à CHALLENGE.

vads_threeds_enrolled

Statut de l'inscription du porteur au programme 3D Secure.

Les valeurs possibles sont :
  • Y  : Authentification disponible.
  • N  : Authentification non disponible
  • U  : Statut de l'inscription au programme 3DS inconnu
  • vide : Processus 3DS non réalisé (3DS désactivé dans la demande, marchand non inscrit ou moyen de paiement non éligible au 3DS).
vads_threeds_status Résultat de l’authentification 3D Secure.
Les valeurs possibles sont :
  • Y  : Porteur authentifié avec succès.
  • N  : Erreur d’authentification du porteur.
  • U  : Authentification impossible
  • A  : Tentative d’authentification mais authentification non réalisée.
  • vide : Authentification 3DS non réalisée (3DS désactivé dans la demande, porteur non inscrit ou moyen de paiement non éligible au 3DS).

Les champs facultatifs transmis dans la requête sont retournés dans la réponse sans modification de leur valeur.

Nous recrutons

Head Office :

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

2.16.0-doc-1.8