- Created by Rodolphe GARIN, last modified on 05 Apr 2024
Contenu
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
-
Page:
Introduction
Un facilitateur de paiement assure l’encaissement des opérations auprès d’un acquéreur pour le compte de ses commerçants affiliés. Cette fonctionnalité vous concerne uniquement si vous exercez cette activité.
Pour se mettre en conformité avec la réglementation, les réseaux doivent connaitre les marchands finaux à l'origine de la demande de paiement. La fonction Payment Facilitator répond à ce besoin.
Les marchands de type Payment Facilitator endossent le rôle de fournisseur de service et sont enregistrés comme tel auprès de leur(s) acquéreur(s) pour faciliter les transactions de sous-marchands.
Le vendeur "final" des biens ou de services est considéré comme un sous-marchand ou un commerçant affilié plutôt qu'un marchand.
Lorsque le consommateur effectue un achat, le sous-marchand envoie une demande de paiement à son payment facilitator. Ce dernier ajoute toutes les données d'identification du sous-marchand et les transmet ensuite à l'acquéreur (via Payline).
Les fonctions disponibles
Les fonctionnalités de Payment Facilitator :
- sont prises en compte en mode web et en interface directe ;
- acceptent les paiements simples (comptant), en différé et en 1-clic ;
- sont autorisées par les réseaux et moyens de paiement suivants :
- AMEX ;
- CB ;
- MASTERCARD ;
- MAESTRO ;
- VISA ;
- iDEAL.
Non disponibles :
- Les paiements récurrents ou en n fois avec un échéancier géré par Payline ;
- Les paiements par interface batch, TPEV ou centre d'administration.
Interface webservice
Pour transmettre les informations du sous-marchand à l'acquéreur, le marchand doit les ajouter dans le nouvel objet subMerchant, en entrée des webservices de l'API Payline (version 18 au supérieure).
Tous les webservices permettant d'initier un paiement sont concernés :
en Request :
en Response :
Comment mettre en place le PaymentFacilitator
Enrôlement
Le facilitateur de paiement doit se conformer aux exigences réglementaires en s'enrôlant et en enrôlant ses affiliés auprès de l'acquéreur.
Un facilitateur de paiement doit affecter un identifiant unique pour chacun de ses commerçants affilié.
Ces identifiants doivent identiques auprès des différents acquéreurs pour pouvoir utiliser la fonction de choix du moyen de paiement sur les pages de paiement Payline.
Ces opérations s'exécutent en dehors de Payline.
Contraintes de nommage
Les acquéreurs et réseaux limitent la taille des noms des marchands affiliés (sous-marchands):
Acquéreur / réseau | Limitations | Format | Exemple |
---|---|---|---|
CB | La concaténation du nom du facilitateur et du sous-marchand ne doit pas excéder 35 caractères | Nom de facilitateur MDP+*+subMerchant.Name+/+/+ subMerchant.ZipCode | DEMO*Boutique Demo//75010 |
Mastercard | La concaténation du nom du facilitateur et du sous-marchand ne doit pas excéder 21 caractères | ||
Visa | La concaténation du nom du facilitateur et du sous-marchand ne doit pas excéder 24 caractères | ||
American Express | La concaténation du nom du facilitateur et du sous-marchand ne doit pas excéder 37 caractères |
Nom de facilitateur MDP : correspond au nom donnée dans la configuration du moyen de paiement dans le centre administration Payline.
Gestion des contrats
Payline adapte la fonction de gestion de contrat pour permettre à un facilitateur de paiement de créer des contrats spécifiques pour les paiements des affiliés.
Un marchand Payline effectuant des paiements pour son compte et pour le compte d'affiliés doit définir au moins deux contrats :
- un pour son compte propre, sans aucune information de facilitateur ;
- un autre pour le compte de ses affiliés, contenant ses identifiants de facilitateur.
Un facilitateur de paiement peut :
- créer un seul contrat de facilitateur et utiliser ce contrat pour les paiements de tous ses affiliés;
- dupliquer son contrat de facilitateur au niveau de chaque contrat des affiliés.
La première simplifie la configuration, mais ne permet pas contrairement à la seconde de bénéficier des fonctions de choix de moyens de paiement, de gestion, de réconciliation, de rapport statistiques différenciées par point de vente et contrat.
Configuration des contrats
Ces informations sont à fournir pour chaque contrat utilisant les fonctions de Payment Facilitator. Elles sont configurées par l’équipe Support Payline.
- Nom du payment facilitator
- Référence contrat acquéreur
Dans l'écran de configuration du contrat Amex :
Paramètre | Commentaire |
---|---|
contract.paymentFacilitator.activate | Commutateur d’activation de la fonction pour le contrat. Doit être positionné à ‘Y’ pour activer le PF, par défaut ‘N’. |
contract.paymentFacilitator.name | Nom de facilitateur de paiement échangé avec l’acquéreur ou le moyen de paiement |
Initialisation du paiement
Payline récupère les données d'identification :
- du facilitateur dans les données du contrat OU
- de l'affilié dans la demande d'autorisation.
L'objet subMerchant contient les éléments suivants :
Object available in version 18 or higher of web services
Field | Description | Presence (Mandatory/Optional/Conditional) | Type | Conditions and notes | ||||
Amex | CB | MSC | VISA | iDEAL | ||||
subMerchantId | Identifier of the sub-market (final beneficiary) defined by the payment provider (Payment Facilitator). | M | M | M | M | AN15 | ||
subMerchantName | Sub-merchant's name : see Payment Facilitator. | M | M | AN15 | Limited to 15 char from version 26 or higher (was 25 char in version 18-25) | |||
subMerchantMCC | MCC Code | M | M | M | N4 | |||
subMerchantSIRET | SIRET (French merchants) | O | M | O | O | AN14 | ||
subMerchantTaxCode | Tax code (US and Canadian merchants) | C | C | AN | Mandatory for countries USA and CAN. It is up to the Payment Facilitator to determine whether that information should be provided or not. | |||
subMerchantStreet | Street name | M | O | AN30 | ||||
subMerchantCity | City | M | O | AN15 | ||||
subMerchantZipCode | Postal code | M | O | AN15 | ||||
subMerchantCountry | Country code | M | M | AN2 | see the list of values | |||
subMerchantState | State | O | O | AN3 | ||||
subMerchantEmailAddress | M | ANS40 | ||||||
subMerchantPhoneNumber | Phone number | M | AN20 |
Authentification 3DS
Les échanges de message 3DS s'effectuent en utilisant les identifiants 3DS du contrat du facilitateur de paiement (BIN acquéreur, identifiant marchand).
Gestion des opérations
Payline récupère les données d'identification du facilitateur à partir du contrat.
Pour celles liées à l'affilié cela dépend de l'opération :
Opération | Données d'identification de l'affilié récupérées |
---|---|
Capture | de l'autorisation |
Remboursement | de l'autorisation |
Ré autorisation | de l'autorisation |
Crédit | du webservice |
Débit | du webservice |
Centre d'administration
Payline affiche les 'Données marchand affilié' dans le détail des transactions pour les différentes opérations (autorisation, opération de caisse, ré-autorisation).
Payline modifie l'export des transactions pour retourner les coordonnées du commerçant affilié.
Rapport
Fichier des transactions
Pour l'export du fichier des transactions, la balise est PAYMENT_FACILITATOR. Payline retourne les informations :
- SUBMERCHANT_NAME
- SUBMERCHANT_MCC
- SUBMERCHANT_SIRET
- SUBMERCHANT_TAX_CODE
- SUBMERCHANT_STREET
- SUBMERCHANT_CITY
- SUBMERCHANT_ZIP_CODE
- SUBMERCHANT_COUNTRY
- SUBMERCHANT_EMAIL_ADDRESS
- SUBMERCHANT_PHONE_NUMBER
- SUBMERCHANT_STATE
N.B. : L'ensemble des colonnes des paramètres sont ajoutées au rapport dès que le tag PAYMENT_FACILITATOR est ajouté à la liste des données à exporter.
Réconciliation et notification
Les données de réconciliation et de notification ne sont pas impactées pour un facilitateur, ce dernier reçoit les données référençant le contrat utilisé pour le paiement.
Aucune donnée liée à l'affilié n'est remontée au facilitateur.
Pages associées
-
Page:
-
Page:
-
Page:
-
Page: