GuidesRéférence APIChangelog
Log In
Référence API
  1. API de Moneris
  2. Authentification 3DS

Créer une authentification

post
https://api.sb.moneris.io/three-d-secure/authentications

Cette opération permet de créer une demande d’authentification.
La demande d’authentification sert à lancer le processus de validation de la carte.
Le résultat de cette demande détermine si 3DS est pris en charge par la carte et quel type d’authentification est requis.

Demandes récentes
Connectez-vous pour voir l'historique complet des demandes
HeureStatutAgent utilisateur
Récupération des demandes récentes…
LoadingLoading…
Body Params

Utilisez la demande d’authentification 3DS pour lancer le processus de validation de la carte et de l’identité du titulaire de la carte. Cette demande prend en charge toutes les méthodes d’authentification 3DS, y compris l’authentification 3RI (3DS Requestor Initiat) et l’authentification découplée. Les champs device_channel et message_category contrôler le type de requête 3DS effectuée. Pour effectuer une authentification 3DS standard avec une expérience de navigateur de titulaire de carte, envoyez device_channel = 02 pour BRW. Le résultat de cette demande détermine si la carte prend en charge les fonctionnalités 3DS et, le cas échéant, si la transaction utilise un flux sans friction ou un flux de défi. Pour effectuer une authentification initiée par le demandeur 3DS sans expérience de navigateur du titulaire de carte, envoyez device_channel = 03 pour 3RI. Tous les champs liés à l’invite d’authentification du navigateur ne sont plus obligatoires, mais les autres champs conditionnels pour 3RI deviennent obligatoires.

string
required
length between 1 and 36

Identificateur unique requis pour le traitement des demandes idempotentes.

Remarque : Moneris encourage l’utilisation de la version 4 de l’UUID dans les API comme clé d’idempotence.

string | null
^[A-Za-z]{2}\d{2}[A-Za-z0-9]{26}$

Utilisé pour identifier les ressources API qui peuvent être nécessaires pour les transactions ultérieures futures ; c’est-à-dire les remboursements, les corrections, les achèvements, les annulations, etc.

string | null
^[a-zA-Z0-9-_]+$

Indique l’identifiant de transaction défini par le commerçant ou l’ID de commande. Les identifiants sont uniques pour chaque transaction d’achat, de préautorisation et de remboursement indépendant

Remarque : Il n’est pas possible que deux transactions de ce type aient le même ID de commande.

amount
object
required

Montant monétaire.
Remarque : La valeur doit être exprimée en cents. Par conséquent, 10,59 $ doivent être envoyés en tant que 1059.

string
required
length between 1 and 60

Nom du titulaire de la carte

string
required
length between 1 and 320

Contient l’adresse e-mail du client.

Pour connaître les protocoles de courrier électronique standard, consultez : https://www.rfc-editor.org/rfc/rfc5322

string
required
length between 3 and 16
^\+[1-9]\d{1,14}$

Numéro de téléphone.

shippingAddress
object | null

L’adresse postale, y compris la rue, la ville, la province et le code postal.
En option, un numéro d’unité peut être fourni.

billingAddress
object
required

L’adresse postale, y compris la rue, la ville, la province et le code postal.

paymentMethod

Détails du mode de paiement

string
enum
required

Identifie la catégorie du message pour un cas d’utilisation spécifique.

Allowed:
string
enum
required

Indique le type d’interface de canal utilisé pour lancer la transaction.

Allowed:
string | null
enum

Type de paiement qui a déclenché la vérification.

  • CARDHOLDER : Le titulaire de la carte a initié le paiement.
  • RECURRING : Paiement récurrent.
Allowed:
int32 | null
1 to 9999

Indique le nombre minimum de jours entre les autorisations.

date | null

Date à partir de laquelle aucune autre autorisation ne peut être effectuée. Il s’agit d’un champ obligatoire pour les transactions d'abonnement, nous vous suggérons de le définir à une valeur raisonnablement élevée si vous n’avez pas de date d’expiration définie.

string | null
enum

Indique le type de requête 3RI. Cet élément de données fournit des informations supplémentaires à l’ACS pour déterminer la meilleure approche pour traiter une demande 3RI.

threeDSecurePriorAuthenticationInformation
object | null

Informations sur la façon dont le demandeur 3DS a authentifié le titulaire de la carte dans le cadre d’une transaction 3DS précédente.

string | null

URL de rappel entièrement qualifiée et encodée en URL qui reçoit la réponse ou le message d’erreur.

Remarque : les demandes avec une URL qui n’est pas encodée seront rejetées pour des raisons de sécurité.

Exemple (URL encodée) : https%3A%2F%2Fmerchant.example.com%2Fcallback%3ForderId%3D123

string | null
enum

Indique si la recherche de carte 3DS s’est terminée avec succès. Une recherche de carte réussie augmente les chances d’une authentification de carte sans friction.

  • SUCCESS : Terminé avec succès.
  • FAILURE : La recherche de carte 3DS a échoué, mais a échoué.
  • UNAVAILABLE : Indisponible ou non tenté.
Allowed:
string | null
enum
Defaults to NO_PREFERENCE

Indique si une demande d’authentification basée sur le navigateur est demandée pour cette transaction. La norme n’est « pas de préférence »

Allowed:
string | null
enum

Concerne le rendu du défi dans le navigateur.

  • X_SMALL : 250 x 400
  • SMALL : 390 x 400
  • MEDIUM : 500 x 600
  • LARGE : 600 x 400
  • FULL_SCREEN : Plein écran
Allowed:
string | null
required

Adresse IP à partir de laquelle le navigateur se connecte.

string | null

Contenu exact de l’en-tête de l’agent utilisateur HTTP.
Notez que lorsque la longueur totale dépasse 2048 caractères, tronquez la partie excédentaire.

boolean

Indique si Java est activé dans le navigateur

boolean

Indique si Javascript est activé dans le navigateur

int32
required
0 to 999999

Définie la hauteur en pixels de l’écran du titulaire de la carte.

int32
required
0 to 999999

Définie la largeur en pixels de l’écran du titulaire de la carte.

string | null

Fournit le code de langue à deux lettres selon la norme ISO 639-1.

Pour obtenir la liste complète des codes de langue, consultez le site : https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes.

Headers
string
required
Defaults to 2025-08-14

Version de l’API du point de terminaison.

Doit être fourni dans la section des en-têtes.

string

Corrèle une série de requêtes au sein d’un même flux.

Remarque : Cet identifiant est généré par Moneris avec chaque demande ou réponse, s’il n’existe pas.
Les commerçants doivent faire écho à la valeur avec chaque demande qui fait partie du flux d’appels.

string
required
length between 13 and 13

Code d’identification de treize caractères.

Remarque : Ce code est fourni par Moneris et est nécessaire pour identifier le commerçant qui effectue la transaction.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Mise à jour il y a 3 mois

Cette page vous a-t-elle aidé ?
Langue
Identifiants
1 champ d'application requis manquant
URL
LoadingLoading…
Réponse
Cliquez sur Essayer ! pour lancer une requête et voir la réponse ici ! Ou choisissez un exemple:
application/json
application/problem+json
*/*

Mise à jour il y a 3 mois

Cette page vous a-t-elle aidé ?