- Directives d'intégration
- Fonctionnalités prises en charge (Opérations de paiement)
- Commerçants de sous-passerelle
Commerçants de sous-passerelle
Les sous-passerelles peuvent utiliser la passerelle sans avoir à configurer de profil de commerçant pour chacun de leurs commerçants (commerçants clients) sur la passerelle.
Si votre profil de commerçant sur la passerelle est configuré en tant que profil de commerçant de sous-passerelle, vous pouvez à la place soumettre les détails de configuration de commerçant requis pour traiter la demande sur la demande DirectAPI.
- La fonctionnalité de commerçant de sous-passerelle est prise en charge par DirectAPI à compter de la version 53 et versions ultérieures, uniquement sur les demandes DirectAPI pour l'API d'authentification.
- Les détails de configuration du commerçant client ne doivent être indiqués que lors de la demande Initiate Authentication (Initier l'authentification) — la passerelle applique automatiquement les détails aux opérations Initiate Authentication (Initier l'authentification) et Authenticate Payer (Authentifier le payeur).
- Si votre profil de commerçant est configuré en tant que profil de commerçant de sous-passerelle, vous ne pourrez pas soumettre de transactions pour traitement sans indiquer les détails du commerçant de sous-passerelle.
- La fonctionnalité de commerçant de sous-passerelle ne propose pas de support pour les agrégateurs (également appelés facilitateurs de paiement), c'est-à-dire qu'elle ne vous permet pas de soumettre des transactions pour le compte d'un autre commerçant (sous-commerçant). Pour plus d'informations sur la fonctionnalité d'agrégateur de la passerelle, voir Prise en charge de l'agrégateur.
Conditions préalables
Votre Your payment service provider doit activer la fonctionnalité de commerçant de la sous-passerelle sur votre profil de commerçant sur la passerelle.
Soumettre des transactions pour 3DS
Lors de la demande Initiate Authentication (Initier l'authentification) et si vous utilisez l'API d'authentification sur un profil de commerçant de sous-passerelle, vous devez indiquer les détails suivants pour votre commerçant client :
- les détails du commerçant client, notamment, son ID, son nom, l'URL de son site Web et son adresse,
- les détails du lien commerçant-acquéreur, y compris l'ID du commerçant acquéreur pour le commerçant client,
- les détails de la configuration 3DS pour votre commerçant client.
De plus, vous devez indiquer la fréquence des transactions sur la demande Authenticate Payer (Authentifier le payeur).
Les règles permettant à la passerelle de déterminer si l'authentification 3DS2 ou 3DS1 (notamment le retour à l'authentification 3DS1) doit être exécutée sont les mêmes pour les commerçants de sous-passerelle que pour tous les autres commerçants. Pour plus d'informations, voir Authentification 3-D Secure.
Référence de l'API Initiate Authentication (Initier l'authentification) [REST] [NVP]
Référence de l'API Authenticate Payer (Authentifier le payeur) [REST] [NVP]
Détails du commerçant client
Vous devez indiquer les détails suivants pour votre commerçant client sur la demande Initiate Authentication (Initier l'authentification) :
subgatewayMerchant.id: votre identifiant pour le commerçant client, c'est-à-dire le commerçant pour lequel vous soumettez la demande.subgatewayMerchant.name: nom du commerçant client.subgatewayMerchant.websiteUrl: URL du site Web du commerçant client.subgatewayMerchant.address.*: détails de l'adresse du commerçant client.order.merchantCategoryCode: code de catégorie du commerçant (code à 4 chiffres utilisé pour classer une entreprise suivant le type de biens ou de services qu'elle propose) du commerçant client.
Page Détails du lien commerçant-acquéreur
Pour chaque acquéreur configuré par rapport à votre profil de commerçant de passerelle, pour lequel le commerçant client peut traiter des transactions, vous devez indiquer l'ID du commerçant acquéreur du commerçant client lors de la demande Initiate Authentication (Initier l'authentification) :
subgatewayMerchant.acquirer[n].id: ID d'acquéreur de la passerelle pour l'acquéreur pour lequel vous indiquez l'ID du commerçant acquéreur du commerçant.subgatewayMerchant.acquirer[n].acquirerMerchantId: ID du commerçant acquéreur du client pour cet acquéreur.subgatewayMerchant.acquirer[n].merchantCategoryCode: code de catégorie de commerçant client pour cet acquéreur. Vous ne devez indiquer cette valeur que si cet acquéreur a besoin d'une valeur MCC différente de celle des autres liens d'acquéreur que vous avez spécifiés. Si le même CM s'applique à tous les acquéreurs, utilisez simplementorder.merchantCategoryCodeNe renseignez pas ce champ si vous renseignezsubgatewayMerchant.authentication[n].acquirerBINsur votre demande.
La passerelle ne traitera les demandes que pour lesquelles vous avez indiqué l'ID du commerçant acquéreur du client pour l'acquéreur qui a été identifié comme l'acquéreur utilisé pour traiter la demande (en fonction de la décision d'acheminement de la transaction prise par la passerelle, c'est-à-dire le lien commerçant-acquéreur identifié).
Vous n'êtes autorisé à soumettre que les ID du commerçant pour lesquels vous avez été configuré par votre your payment service provider. Veuillez contacter votre your payment service provider si vous soumettez une valeur pour laquelle vous n'avez pas été configuré.
Détails 3DS2
Vous devez indiquer les détails de configuration 3DS2 pour votre commerçant client sur la demande Initiate Authentication (Initier l'authentification), notamment :
subgatewayMerchant.authentication[n].protocol: système d'authentification pour lequel le commerçant client peut effectuer des authentifications de payeur 3DS2.subgatewayMerchant.authentication[n].3DS2.requestorId: uniquement requis pour American Express SafeKey.subgatewayMerchant.authentication[n].3DS2.requestorName(facultatif) uniquement requis pour
Mastercard SecureCode et Verified By Visa, qui exigent uniquement que le système d'authentification soit identifié dans le champ subgatewayMerchant.authentication[n].protocol. L'ID et le nom du demandeur sont générés par la passerelle. La valeur générée par la passerelle (et soumise au serveur MI) sera retournée dans la réponse Initiate Authentication (Initier l'authentification).
Pour American Express SafeKey, vous devez indiquer tous les détails, notamment l'ID du demandeur et le nom du demandeur.
La passerelle ne traitera que les demandes pour lesquelles vous avez indiqué le protocole (et, le cas échéant, l'ID du demandeur et le nom du demandeur) dans la demande. Par exemple, si vous indiquez un numéro de carte que la passerelle identifie comme une carte American Express, mais n'avez pas indiqué subgatewayMerchant.authentication[n].protocol=AMEX_SAFEKEY dans la demande, la demande est rejetée par la passerelle.
Détails 3DS1
La passerelle propose une prise en charge 3DS1 pour Mastercard SecureCode, Verified by Visa et American Express Safekey.
Vous devez indiquer les détails de configuration 3DS1 pour votre commerçant client sur la demande Initiate Authentication (Initier l'authentification), notamment :
subgatewayMerchant.acquirer[n].3DS1.masterCardSecureCode.merchantIdsubgatewayMerchant.acquirer[n].3DS1.verifiedByVisa.cardAcceptorIdsubgatewayMerchant.acquirer[n].3DS1.verifiedByVisa.cardAcceptorTerminalIdsubgatewayMerchant.acquirer[n].3DS1.amexSafeKey.merchantId
Ces informations doivent être indiquées pour chaque acquéreur (identifié par subgatewayMerchant.acquirer [n]) pour lequel le commerçant client peut effectuer des authentifications de payeur 3DS1.
Sélection de l'acquéreur
Si votre your payment service provider vous a configuré avec plusieurs liens d'acquéreur avec la même combinaison de devise, type de carte et secteur d'activité, vous devez identifier l'acquéreur que vous souhaitez utiliser pour traiter l'authentification à l'aide du champ subgatewayMerchant.acquirer[n].id dans la demande Initiate Authentication (Initier l'authentification).
Si la passerelle n'est pas en mesure d'identifier l'acquéreur de manière unique, elle retournera un message d'erreur.
Test de votre intégration
Pour tester votre intégration, vous pouvez utiliser votre profil de commerçant TEST dans l'environnement de production. Voir Test et mise en service.