• France
état des services
démonstrations
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
Français
Français
Anglais
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 paiement à l'expédition
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
Intégration mobile
Échange de fichiers
Exemples de code
Moyens de paiement
Modules de paiement
Guides
Back Office Marchand
Guides fonctionnels

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 Marchand. 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 Marchand.

    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 Marchand.

  • 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 Marchand.

  • 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 Marchand.

  • 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 Marchand.

  • 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 Marchand.

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

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 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 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

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 RECURRENT_INITIAL.

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 :
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_brand_management

Permet de connaître la marque utilisée, la liste des marques disponibles et de savoir si l'acheteur à modifier la marque choisie par le marchand.

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.

© 2025 Tous droits réservés à Scellius
25.18-1.11