Dernière mise à jour 2/05/2014

Contenu

9. Moyen de paiement et caractéristiques de la page de paiement

9.1 Choix du moyen de paiement du côté du marchand

9.1.1 Afficher un moyen de paiement déterminé

Lorsque notre page de paiement sécurisé s’affiche chez le client, on lui présente les moyens de paiement possibles que le marchand a activés sur son compte.

Lorsque le client doit choisir son moyen de paiement sur le site du marchand et non sur notre page de paiement, celui-ci peut nous envoyer le nom du moyen de paiement et sa marque (uniquement lorsque le moyen de paiement est « CreditCard ») dans les champs masqués pour que nous n’affichions que ce moyen de paiement sur notre page de paiement et que nous n’acceptions que les paiements effectués par ce  biais.

Ces champs masqués sont les suivants :

<input type="hidden" name="PM" value="">
<input type="hidden" name="BRAND" value="">

Champ
Objet
PM
Moyen de paiement (par ex. CreditCard)
BRAND
Marque de la carte de crédit (par ex. VISA)

Exemples

  • Champs masqués dans l’hypothèse où votre client opte pour VISA sur votre site :

<input type="hidden" name="PM" value="CreditCard ">
<input type="hidden" name="BRAND" value="VISA">

  • Champ masqués dans l’hypothèse où le seul moyen de paiement que vous acceptez dans ce cas est la carte de crédit (par exemple, si vous avez aussi d’autres moyens de paiement que vous ne souhaitez pas afficher) :

<input type="hidden" name="PM" value="CreditCard ">
<input type="hidden" name="BRAND" value="">

  • Champs masqués dans l’hypothèse où votre client opte pour iDEAL sur votre site :

<input type="hidden" name="PM" value="iDEAL">
<input type="hidden" name="BRAND" value="">

OU

<input type="hidden" name="PM" value="">
<input type="hidden" name="BRAND" value="iDEAL">

9.1.2 Permettre au client de choisir un autre moyen de paiement : BACKURL

Lorsque le client choisit son moyen de paiement sur le site du marchand, nous n’affichons que le moyen de paiement sélectionné sur notre page de paiement.

Lorsque le paiement échoue avec ce moyen de paiement et que le client souhaite tenter de régler avec un autre moyen de paiement, la liste des moyens de paiement du marchand ne s’affiche pas sur nos pages de paiement sécurisé étant donné que le choix du moyen de paiement a été opéré sur le site du marchand et non sur nos pages de paiement sécurisé.

Dans ce cas, le marchand peut utiliser le « backurl » pour rediriger le client vers un URL sur le site du marchand, où il va pouvoir choisir un autre moyen de paiement. Lorsque le client clique sur le bouton « Back » sur notre page de paiement sécurisé à la suite d’une autorisation refusée, ou après avoir annulé l’opération à partir d’un site tiers ou du site d’une banque, nous le redirigeons vers l’URL que le marchand a définie comme « BACKURL ».

Remarque: Le bouton « back » dont nous parlons dans la présente section est le bouton « back » situé sur nos pages de paiement sécurisé, et NON le bouton « back » de votre navigateur.

Vous pouvez saisir le « backurl » sous l’onglet « Affichage de la page de paiement » sur la page d’information technique de votre compte, mais vous pouvez aussi nous envoyer un « backurl » bien précis dans les champs masqués pour une transaction si vous préférez éviter d’utiliser le même « BACKURL » que celui saisi sous l’onglet « Affichage de la page de paiement » de la page d’informations techniques de votre compte.

Le « backurl » envoyé dans les champs masqués l’emporte sur le « BACKURL » saisi sous l’onglet « Affichage de la page de paiement » de la page d’information technique de votre compte. Vous pouvez envoyer le « backurl » dans le champ masqué suivant :

<input type="hidden" name="BACKURL" value="">

Champ
Objet
BACKURL
URL de la page Web à afficher chez le client lorsqu’il clique sur  le bouton « back » de notre page de paiement sécurisé.

Lorsque le client choisit son moyen de paiement sur nos pages de paiement sécurisé et non sur le site du marchand, le « BACKURL » n’est pas pris en considération. Lorsque le client clique sur le bouton « back » sur notre page de paiement sécurisé, il est simplement redirigé vers notre page de sélection du moyen de paiement sécurisé, qui contient la liste des moyens de paiement acceptés par le marchand.

9.2 Afficher une liste déterminée de moyens de paiement

Lorsque le client doit choisir son moyen de paiement à partir d’une liste de moyens de paiement sur notre page de paiement, le marchand peut nous envoyer cette liste dans les champs masqués pour que nous n’affichions que ces moyens de paiement sur notre page de paiement.

Ce champ masqué est le suivant :

<input type="hidden" name="PMLIST" value="">

Champ
Objet
PMLIST
Liste des moyens de paiement et/ou des marques de cartes de crédit sélectionnés. Éléments séparés par un « ; » (point-virgule).

Exemple

Champ masqué dans l’hypothèse où vous voulez que votre client choisisse entre VISA et iDEAL sur notre page de paiement (par ex., si vous proposez aussi d’autres moyens de paiement que vous ne souhaitez pas afficher) :

<input type="hidden" name="PMLIST" value="VISA;iDEAL">

9.3 Exclure une liste déterminée de moyens de paiement

Si le marchand ne souhaite pas présenter certaines marques spécifiques, cela peut être déterminé par un champ masqué.

Ceci est particulièrement pratique pour les Sub-Brands, quand un marchand veut accepter une marque (ex: MasterCard) mais pas la sous-marque (ex: Maestro)

Le champ masqué est le suivant:

<input type="hidden" name="EXCLPMLIST" value="">

Champ
Objet
EXCLPMLIST
Liste des moyens de paiement et/ou des marques de cartes de crédit à exclure. Éléments séparés par un « ; » (point-virgule).

9.4 Présentation des moyens de paiement

Vous pouvez définir la présentation/liste des moyens de paiement sur notre page de paiement au moyen du champ masqué suivant :

<input type="hidden" name="PMLISTTYPE" value="">

Champ
Valeurs possibles
PMLISTTYPE
Les valeurs possibles sont 0, 1 et 2.
  • 0 : Logos regroupés horizontalement avec le nom du groupe sur la gauche (valeur par défaut)
  • 1 : Logos regroupés horizontalement sans les noms des groupes
  • 2 : Liste verticale de logos avec moyen de paiement et nom de la marque

9.5 Window pour 3-D Secure

9.5.1 3-D Secure v1.0

Si vous travaillez avec 3-D Secure, vous pouvez définir la façon dont vous souhaitez que la page d’identification s’affiche chez le client en nous envoyant un paramètre supplémentaire dans les champs masqués.

Ce champ masqué est le suivant :

<input type="hidden" name="WIN3DS" value="">

Champ
Valeurs possibles
WIN3DS
  • « MAINW » : pour afficher la page d’identification dans la fenêtre principale (valeur par défaut)
  • « POPUP » : pour afficher la page d’identification dans une fenêtre contextuelle (pop-up) et revenir à la fenêtre principale à la fin

Important

Veuillez noter que pour certaines méthodes de paiement (Visa, MasterCard, JCB, …) , la valeur ‘POPUP’ n'est pas autorisée et sera convertie en ‘MAINW’ par le système. Nous vous conseillons de tester le comportement de ce paramètre pour chaque méthode de paiement.

9.5.2 3-D Secure v2.1 (Disponible en TEST)

Outre le paramètre requis auparavant (WIN3DS), il est fortement conseillé d'introduire le champ suivant.  Il contient les tailles préconfigurées pour la largeur x hauteur en pixels de la fenêtre affichée dans la fenêtre du navigateur du titulaire de carte.

REMARQUE: Si vous n'envoyez pas ce paramètre, la valeur par défaut est 05 = Full screen.

Champ
Valeurs possibles
Mpi.challengeWindowSize
  • 01 = 250 x 400
  • 02 = 390 x 400
  • 03 = 500 x 600
  • 04 = 600 x 400
  • 05 = Full screen

Afin de rendre la méthode d'évaluation des risques 3DS v2 plus efficace, nous vous recommandons d'envoyer les paramètres supplémentaires tels que décrits dans la liste ici.

La qualité de ces paramètres fournis est susceptible d'avoir une incidence directe sur votre taux de conversion, puisqu'ils peuvent contribuer à l'authentification du titulaire de carte sans être redirigé. Pour plus d'informations, veuillez-vous reporter au guide DirectLink 3DS v2.

Même si ces paramètres sont facultatifs, les principaux systèmes de cartes de paiement conseillent vivement de les inclure à votre demande pour favoriser la mise en place d’un flux fluide

ECOM_BILLTO_POSTAL_CITY
ECOM_BILLTO_POSTAL_COUNTRYCODE
ECOM_BILLTO_POSTAL_STREET_LINE1
ECOM_BILLTO_POSTAL_STREET_LINE2
ECOM_BILLTO_POSTAL_STREET_LINE3
ECOM_BILLTO_POSTAL_POSTALCODE
REMOTE_ADDR
CN
EMAIL

Vous pouvez utiliser la carte de test suivante pour simuler une carte enregistrée 3-D Secure dans notre environnement de test :

Flux sans problème
Type de carte Numéro de carte Date d'expiration
VISA 4186455175836497 N’importe quelle date dans le futur
Mastercard
5137009801943438 N’importe quelle date dans le futur
American Express
375418081197346 N’importe quelle date dans le futur

Flux avec processus d'identification

Type de carte Numéro de carte Date d'expiration
VISA 4874970686672022 N’importe quelle date dans le futur
Mastercard
5130257474533310 N’importe quelle date dans le futur
American Express
379764422997381 N’importe quelle date dans le futur

Remarque: Plus de numéros de cartes de test peuvent être téléchargés ici.

9.6 Subdivision en cartes de crédit/débit

La fonctionnalité consistant à subdiviser VISA et MasterCard en méthodes de paiement par débit et par crédit vous permet de les offrir à vos clients sous deux formes (p. ex. VISA Debit et VISA Credit), mais vous pouvez aussi décider de n'accepter qu'une seule de ces deux formes de paiement. 

Pour pouvoir utiliser cette fonctionnalité de subdivision en cartes de crédit et de débit via e-Commerce, vous devez inclure le paramètre CREDITDEBIT dans les champs masqués que vous envoyez à la page de paiement (et les inclure également, par conséquent, dans le calcul SHA-IN !). 

Champ Format
CREDITDEBIT "C": credit card (carte de crédit)
"D": debit card (carte de débit)

Erreur liée : Si l'acheteur sélectionne la méthode par carte de débit, mais entre ensuite un numéro de carte de crédit, un code d'erreur est renvoyé : « Marque/mode de paiement incorrect ».

Si le paiement est traité avec succès avec le paramètre CREDITDEBIT, ce même paramètre est également renvoyé dans le retour d'information post-vente. Cependant, si les valeurs soumises sont C ou D, les valeurs de retour sont « CREDIT » ou « DEBIT ».

Vous trouverez également ces valeurs de retour dans la vue d'ensemble de la transaction via « View transactions » et « Financial history », ainsi que dans les rapports que vous pouvez télécharger ensuite.

Configuration au sein de votre compte

La fonctionnalité de subdivision peut également être activée et configurée par méthode de paiement dans votre compte PostFinance. Accédez à Subdivision en cartes de crédit/débit pour plus d'informations.