Personnaliser la référence marchand Worldline

Chaque paiement transmis à Worldline porte une référence marchand. Par défaut, il s'agit du seul numéro de transaction de la plateforme. Vous pouvez la personnaliser pour y faire figurer le code du point de vente et un libellé de votre choix, afin d'identifier immédiatement, depuis le back-office de Worldline, à quel magasin et à quel type d'activité correspond chaque paiement.

Exemple : avec le format {store_code}-LOC-{transaction_id}, un paiement réalisé par le magasin dont le code est 334 apparaîtra chez Worldline sous la référence 334-LOC-1224.

NB : ce réglage concerne uniquement les plateformes utilisant l'intégration Ingenico Direct (Worldline). Il n'a aucun effet avec un autre prestataire de paiement.

1. Renseigner le code de vos points de vente

Le code utilisé dans la référence est celui de la fiche du point de vente.

1. Rendez-vous au menu Administration > Points de vente, puis ouvrez la fiche de chaque point de vente concerné.

2. Renseignez son code d'identification, puis cliquez sur "Sauvegarder".

Pour le détail de la fiche d'un point de vente, consultez le tutoriel Créer ou modifier un point de vente.

Attention : si un point de vente n'a pas de code renseigné, la référence de ses paiements retombe automatiquement sur le seul numéro de transaction. Le paiement reste parfaitement traité, mais vous perdez l'identification du magasin chez Worldline. Vérifiez donc que tous vos points de vente ont un code avant de configurer le format.

2. Configurer le format de la référence

3. Rendez-vous au menu Paramètres > Paiement en ligne.

4. Dans le bloc "Intégration Ingenico Direct", renseignez le champ "Format de la référence marchand".

5. Cliquez sur "Sauvegarder".

Deux éléments dynamiques sont à votre disposition, à écrire entre accolades :

Tout le reste du format est libre : vous pouvez y placer des tirets, des lettres, un libellé d'activité. Le format {store_code}-LOC-{transaction_id} donne par exemple 334-LOC-1224.

Bon à savoir : laissez le champ vide pour conserver le comportement par défaut, c'est-à-dire le seul numéro de transaction.

3. Les règles à respecter

Trois contraintes encadrent le format. La plateforme vous le signale à l'enregistrement si l'une d'elles n'est pas respectée.

1. Le format doit se terminer par {transaction_id}. C'est ce dernier segment qui permet à la plateforme de retrouver la transaction lorsque Worldline lui renvoie une notification. Un numéro de transaction placé ailleurs empêcherait ce rapprochement.

2. Seuls {store_code} et {transaction_id} sont acceptés. Tout autre élément entre accolades, ou une accolade mal fermée, est refusé.

3. La référence produite ne doit pas dépasser 30 caractères, limite imposée par Worldline. La plateforme fait l'estimation avec le code magasin le plus long et le numéro de transaction le plus élevé, afin que le format reste valable dans la durée.

4. Où retrouver cette référence

Une fois le format configuré, la référence personnalisée apparaît dans le back-office de Worldline sur toutes les opérations : paiement initial, échéance d'abonnement, facturation d'un montant supplémentaire, remboursement et caution.

5. Rapprocher votre export avec le fichier de votre banque

L'export de vos transactions comporte une colonne "Payment ID", en fin de fichier.

Elle contient l'identifiant du paiement chez Worldline sans le suffixe d'opération. Là où la colonne "Référence PSP" affiche 10068513645_0, la colonne "Payment ID" affiche 10068513645 — soit exactement la valeur présente dans les fichiers de restitution de Worldline. Vous pouvez ainsi rapprocher les deux fichiers par une recherche automatique, sans retraitement.

NB : un paiement et son remboursement partagent le même Payment ID. Pour Worldline, le remboursement est une opération du même paiement. C'est la colonne "Type de transaction" qui vous permet de distinguer les deux lignes.

Pour la marche à suivre de l'export, consultez le tutoriel Exporter les transactions.