• France
état des services
démonstrations
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
docs.
France
Espagne
Europe (Anglais)
Inde
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
SDK Mobile
Échange de fichiers
Mandats SEPA par API REST
Exemples de code
Moyens de paiement
Modules de paiement
Marketplace
Guides
Back Office Marchand
Back Office Expert
Guides fonctionnels

Création de l'alias lors de la souscription à un abonnement

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_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_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).

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_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. 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 fraction 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

Une demande de "création d'alias lors de la souscription d'un abonnement" donne lieu à la création d'une transaction de type VERIFICATION, visible dans le Back Office Expert.

Le rôle de cette transaction est d'aider le marchand à comprendre, depuis son Back Office, les raisons du refus de la création de l'alias.

Voici ses caractéristiques :

Nom du champ Description
vads_operation_type Type de transaction.

Sa valeur est VERIFICATION.

vads_trans_status Statut de la transaction.

Les valeurs possibles sont :

  • ACCEPTED

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

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

  • REFUSED

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

    L'alias n'est pas créé.

vads_occurrence_type Type d'occurrence de la transaction.

Sa valeur est RECURRENT_INITIAL.

vads_amount
Valeurs possibles :
  • 0 si l'acquéreur supporte les demandes de renseignements,
  • 100 dans le cas contraire.
vads_trans_id Identifiant de la transaction.

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

vads_trans_uuid Identifiant unique de la transaction.

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

vads_auth_mode

Type de demande réalisée auprès des serveurs d'autorisation.

Sa valeur est MARK.
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.

Voir chapitre Gérer les codes retour de la demande d'autorisation.

Vide si erreur avant autorisation.

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 règles relatives au montant ou dont l'action est "Valider manuellement" ne s'appliquent pas dans le cas d'une transaction de type VERIFICATION.

Les valeurs possibles sont :

Valeurs Description
ENABLE_3DS
  • Le module de risque a demandé une authentification avec interaction du porteur (challenge).
DISABLE_3DS
  • Le module de risque a demandé une authentification sans interaction du porteur (frictionless).
NO_PREFERENCE
  • Le module de risque a demandé une authentification 3DS. Le choix de la préférence est délégué à l'émetteur de la carte.
NO_CHALLENGE_REQUESTED
  • Le module de risque a demandé une authentification sans interaction du porteur (frictionless).
CHALLENGE_REQUESTED
  • Le module de risque a demandé une authentification avec interaction du porteur (challenge).
CHALLENGE_MANDATE
  • 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
  • Appel à un analyseur de risques externe sous condition que le marchand possède un contrat.

    Se référer à la description du champ vads_risk_analysis_result pour identifier la liste des valeurs possibles et leur description.

INFORM
  • Une alerte est remontée.
  • Le marchand est averti qu’un risque est identifié.
  • Le marchand est informé via une ou plusieurs des règles du centre de notification (URL de notification, e-mail ou SMS).

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.
Il est conseillé d'utiliser cette donnée pour contrôler la date d'expiration de l'alias.
vads_expiry_year Année d’expiration de la carte utilisée.
Il est conseillé d'utiliser cette donnée pour contrôler la date d'expiration de l'alias.

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
Mentions légales
Charte de Protection des Données Personnelles
25.18-1.11