Documentation Monext Online

Arborescence des pages


   


Contenu





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éseauLimitationsFormatExemple
CBLa concaténation du nom du facilitateur et du sous-marchand ne doit pas excéder 35 caractèresNom de facilitateur MDP+*+subMerchant.Name+/+/+ subMerchant.ZipCode DEMO*Boutique Demo//75010
MastercardLa concaténation du nom du facilitateur et du sous-marchand ne doit pas excéder 21 caractères

VisaLa concaténation du nom du facilitateur et du sous-marchand ne doit pas excéder 24 caractères

American ExpressLa 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 :

  1. un pour son compte propre, sans aucune information de facilitateur ;
  2. un autre pour le compte de ses affiliés, contenant ses identifiants de facilitateur.

Un facilitateur de paiement peut :

  1. créer un seul contrat de facilitateur et utiliser ce contrat pour les paiements de tous ses affiliés;
  2. 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ètreCommentaire
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.nameNom 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

CBMSCVISAiDEAL

subMerchantId

Identifier of the sub-market (final beneficiary) defined by the payment provider (Payment Facilitator).

M

MM
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

MM

N4


subMerchantSIRET

SIRET (French merchants)

O

MOO

AN14


subMerchantTaxCode

Tax code (US and Canadian merchants)

CC


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


subMerchantEmailAddressEmailM



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érationDonnées d'identification de l'affilié récupérées 
Capturede l'autorisation
Remboursementde l'autorisation
Ré autorisationde l'autorisation
Créditdu webservice
Débitdu 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



Documentation Monext Online