Release 24.5

aller directement au contenu

Rechercher par mots clés

  1. Moyens de paiement
  2. Cartes de débit et de crédit
  3. Intégration Bancontact

Intégration Bancontact

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

Introduction

Sherlock's est une solution de paiement de commerce électronique multicanale sécurisée conforme à la norme PCI DSS. Elle vous permet d’accepter et de gérer des transactions de paiement en prenant en compte les règles métier liées à votre activité (paiement à la livraison, paiement différé, paiement récurrent, paiement en plusieurs fois…).

L’objectif du présent document est d’expliquer l'intégration du moyen de paiement Bancontact dans Sherlock's.

À qui s’adresse ce document ?

Ce document a pour objectif de vous aider à implémenter le moyen de paiement Bancontact sur votre site de commerce électronique.

Il comprend :

  • des informations fonctionnelles à votre attention ;
  • des instructions d'implémentation à destination de votre équipe technique.

Pour avoir une vue d’ensemble de la solution Sherlock's, nous vous conseillons de consulter les documents suivants :

  • Présentation fonctionnelle
  • Guide de configuration des fonctionnalités

Comprendre les paiements Bancontact avec Sherlock's

Principes généraux

Bancontact est le leader du marché des paiements électroniques en Belgique. La carte Bancontact est la carte nationale belge.

Pour payer avec une carte Bancontact, le titulaire de carte doit fournir les renseignements détaillés sur sa carte, à savoir :

  • le numéro de la carte ;
  • la date d'expiration ;
  • certaines cartes Bancontact comarquées possèdent également un code de sécurité (cartes Bancontact/VPay et Bancontact/Maestro). Il n'est pas nécessaire de le saisir pour effectuer un paiement Bancontact.

Pour qu'un paiement Bancontact sur Internet soit finalisé, l'authentification 3-D Secure est généralement obligatoire. La transaction de paiement est soumise à l'authentification du titulaire de carte. Ce processus implique à la fois la banque émettrice de la carte et le réseau. Par conséquent, vous devrez souscrire au programme 3-D Secure.

Règles d’acceptation

Fonctionnalités disponibles
Canaux de paiement
Internet V Canal de paiement par défaut
MOTO X
Télécopie X
SVI X
Typologies de paiement
Paiement immédiat V Méthode par défaut
Paiement en fin de journée X
Paiement différé X
Paiement à l'expédition X
Paiement en plusieurs fois X
Paiement par abonnement V
Paiement par fichier X
Paiement OneClick V
Gestion des devises
Acceptation multidevise X EURO uniquement
Règlement en devise X EURO uniquement
Pages de paiement

Le client sélectionne le moyen de paiement Bancontact.

Il est ensuite redirigé vers la page de la saisie des informations requises :



Le ticket de paiement s’affiche, puis le client retourne sur votre site Web.

Ouvrir votre contrat d’acceptation Bancontact

Afin de proposer le moyen de paiement Bancontact sur votre site Web, vous devez souscrire un contrat d’acceptation auprès de Worldline Acquiring Belgique. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information.

Ce moyen de paiement est également co-badgé avec Maestro et prochainement avec V-Pay (Visa debit), ce qui signifie qu'il peut être accepté également comme une carte internationale Maestro ou Visa.

Effectuer un paiement Bancontact

Sherlock's vous offre trois solutions pour intégrer le moyen de paiement Bancontact :

  • Sherlock’s Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.
  • Sherlock’s Office qui vous laisse la possibilité d’afficher vous-même vos pages de paiement et qui fonctionne par un dialogue de serveur à serveur.
  • Sherlock’s Office Batch qui vous permet de traiter des paiements par échange de fichiers.

Pour les paiements Bancontact, il n’est pas possible de différer la remise. Vous ne pouvez pas ajuster la date de transfert des fonds (paiement immédiat).

Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :


description des status possibles pour une transaction Bancontact

Le seul mode de capture disponible est IMMEDIATE. Trois états sont possibles : la transaction est en attente de capture (status TO_CONFIRM_CAPTURE, responseCode 60) ou la transaction est acceptée et donc capturée (status CAPTURED, responseCode 00) ou la transaction est rejetée (status REFUSED, responseCode différent de 00 et de 60).

Effectuer un paiement Bancontact avec Sherlock’s Paypage

La cinématique de paiement pour Sherlock’s Paypage est décrite ci-dessous :


étapes d'un paiement Bancontact via Paypage

1) Le client procède au paiement. 2) Le client est rédirigé vers la page de sélection du moyen de paiement hébergée chez Sherlock's et sélectionne Bancontact et saisie son numéro de carte. 3) Il est redirigé vers la page ACS où il s'authentifie. 4) Le client est redirigé vers les pages Sherlock's. 5) Si le client clique sur le bouton retour à la boutique, Sherlock's envoie la réponse manuelle. 6) Sherlock's envoie la réponse automatique.
Note: pour les paiements 3-D Secure v2, il est recommandé de renseigner certains champs afin de favoriser le frictionless. Veuillez consulter le guide 3-D Secure.
Paramétrer la requête de paiement

Les champs suivants ont un comportement particulier :

Nom du champ Remarques / règles
statementReference La valeur envoyée apparaîtra sur votre relevé de compte.
Les caractères autorisés sont [a-zA-Z0-9 /\+=.]
orderId Afin d’être compatible avec le protocole BXAP, le champ ne doit pas excéder 30 caractères. Toute valeur de plus de 30 caractères sera tronquée.
Les caractères autorisés sont [a-zA-Z0-9 /\+=.].
fraudData.bypass3DS WIP_BANCONTACT si vous souhaitez désactiver l’authentification 3-D Secure lors d’un paiement OneClick Bancontact.
Analyser la réponse

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Paiement accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
maskedPan = (voir le Dictionnaire des données).
panExpiryDate = (voir le Dictionnaire des données).
paymentMeanBrand = BCMC
paymentMeanType = CARD
responseCode = 00
 Vous pouvez livrer la commande.
Paiement OneClick accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).

holderAuthentProgram =

  • 3DS : le client s’est authentifié dans une cinématique 3-D Secure;
  • 3DS_V2 : le client s’est authentifié dans une cinématique 3-D Secure V2.
  • BYPASS : le porteur ne s’est pas authentifié car le paiement a été effectué via WIP.
maskedPan = (voir le Dictionnaire des données).
panExpiryDate = (voir le Dictionnaire des données).
paymentMeanBrand = BCMC
paymentMeanType = CARD
responseCode = 00
 Vous pouvez livrer la commande.
Transaction en attente
responseCode = 60
Vous devez attendre de recevoir la seconde réponse automatique pour cette transaction afin de connaître son statut final et savoir si vous pouvez expédier la marchandise. Si vous ne recevez pas la réponse automatique, vous devrez consulter régulièrement les journaux des transactions.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données).
responseCode = 05
 L’autorisation est refusée pour un motif non lié à la fraude.
Si vous n’avez pas opté pour l’option « nouvelle tentative de paiement » (pour plus de détails veuillez consulter le Guide de configuration des fonctionnalités), vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus nombre max essais atteint responseCode = 75 Le client a fait plusieurs tentatives qui ont toutes échoué.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Effectuer un paiement Bancontact avec Sherlock’s Office

Le processus de paiement pour Sherlock’s Office est décrit ci-dessous :


description des étapes d'un paiement bancontact avec office

1) Vous collectez les coordonnées de paiement du client via une page dédiée sur votre site. 2) Vous vérifiez l’enrôlement 3-D Secure de la carte en envoyant une requête de vérification à Sherlock's et Sherlock's vous renvoie une réponse contenant le l’URL de l’ACS. 3) Vous redirigez le client vers l’URL de l’ACS de sa banque. 4) Vous récupérez les données de l'authentification du client. 5 ) Vous transmettez la demande d'autorisation à Sherlock's et Sherlock's vous renvoie une réponse contenant le résultat du paiement. 6) Vous affichez le résultat du paiement à votre client.
Paramétrer la requête de paiement

Il est possible d'initier des paiements Bancontact avec la méthode cardCheckEnrollment du service CheckOut. Les champs suivants sont utilisés pour envoyer les informations spécifiques à ce moyen de paiement :

Nom du champ Remarques / règles
cardNumber Obligatoire
cardExpiryDate Obligatoire
cardCSCValue Facultatif
orderId

Afin d’être compatible avec le protocole BXAP, le champ ne doit pas excéder 30 caractères. Toute valeur de plus de 30 caractères sera tronquée.

Les caractères autorisés sont [a-zA-Z0-9 /\+=.].
paymentMeanBrand Peut-être être valorisé avec BCMC.
statementReference La valeur envoyée apparaîtra sur votre relevé de compte.

Les caractères autorisés sont [a-zA-Z0-9 /\+=.]

Merci de vous référer au paragraphe paiement 3-D Secure via le connecteur Sherlock’s Office pour mettre en œuvre les autres étapes d'un paiement 3-D Secure.

Analyser la réponse

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Paiement accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
paymentMeanBrand = BCMC
responseCode = 00
 Vous pouvez livrer la commande.
Transaction en attente
responseCode = 60
La transaction est toujours en cours de traitement. Vous devrez consulter régulièrement les journaux des transactions pour connaître son statut final.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données).
responseCode = 05
 L’autorisation est refusée pour un motif non lié à la fraude, vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Merci de vous référer au document Guide 3DS pour analyser les informations d'authentification.

Gérer vos transactions Bancontact

Opérations de caisse disponibles

Les opérations suivantes sont disponibles sur les transactions Bancontact.

Gestion de caisse
Annulation X

Validation X
Remboursement V
Montant maximum autorisé par remboursement : 3 000 € (plusieurs remboursement partiels nécessaires pour toute transaction supérieur à 3 000 €).
Duplication V

Le diagramme ci-dessous vous permet de savoir quelle opération de gestion de caisse est disponible lorsqu'une transaction est dans un état donné :


états possibles suite à une opération de gestion de caisse pour un paiement Bancontact

Lorsque la transaction est créée, elle est au status TO_CONFIRM_CAPTURE. Si la capture échoue elle passe au status CAPTURE_REFUSED. Si la capture réussit, elle passe au status CAPTURED. Une fois la transaction capturée, elle peut être remboursée partiellement ou en totalité. Si l'intégralité de la transaction est remboursée, elle passe au status CREDITED. Si une partie seulement de la transaction est remboursée, elle reste au status CAPTURED.

Consulter vos transactions Bancontact

Journaux

Les journaux mis à disposition par Sherlock's vous permettent d’avoir une vision exhaustive et consolidée de vos transactions, opérations de caisse, situation comptable et impayés. Vous pouvez utiliser ces informations pour enrichir votre système d’information.

La disponibilité des transactions Bancontact pour chaque type de journal est récapitulée dans le tableau ci-dessous :

Disponibilité des journaux
Journal des transactions V
Journal des opérations V
Journal de rapprochement des transactions X
Journal de rapprochement des impayés X
Note: pour les transactions Bancontact, le champ paymentMeanBrand est renseigné avec la valeur BCMC.

Sherlock's Gestion

Vous pouvez consulter vos transactions Bancontact et effectuer différentes opérations de gestion de caisse grâce à Sherlock's Gestion.



Retourner en haut de page Besoin d'aide ?

Besoin d'aide ?

Contacter le support
Fermer

Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation Sherlock's.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres