Section

Column

width	50

Contenu

Sommaire

maxLevel	1
style	none

Column

width	50

Développer

title	Liste des fonctionnalités avancées

Contenu par étiquette

showLabels	false
max	10
spaces	com.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@9a3
showSpace	false
sort	title
type	page
cql	label = "fonctionnalite_avancee" and type = "page" and space = "DT"
labels	bancontact belgique choixdelamarque

Extrait

hidden	true

EDB : Payer par lien

https://api-docs.retail.monext.com/reference/paymentlinkget

https://monextonline-dev.readme.io/reference/paymentlinkcreate

Documentation

https://docs.monext.fr/display/DT/Les+cartes+de+test

Remplacer le token de session en retour du doWebPayment dans le lien ci-dessous pour afficher le widget

https://homologation-payment.payline.com/views/monitoring/monitoring.html?token=1Wkqyd3om8O8qZ8ch2681600264782869&template=tab

Cartes de test

4970100000325734

4970105609449918

4970106940004172

Le paiement par lien

Offrez à vos acheteurs la possibilité de payer via un lien sécurisé que vous générez, et que nous hébergeons.
Vous envoyez le lien web, votre acheteur réalise le paiement sur la page web de paiement et vous recevez les fonds rapidement.

Vous pourrez ainsi proposer de régler un paiement à votre acheteur avec un lien envoyé sur n'importe quel canal (SMS, e-mail).

Les bénéfices

Utilisez le lien pour l’envoyer sur n’importe quel canal (SMS, email, Whatsapp).

Tout gérer depuis le centre admin : créez un lien et vérifiez l'état du lien. Prévu dans les prochaines releases.

Personnalisez la page web de paiement avec vos moyens de paiement.

Facile d’utilisation avec un simple web service.

Payez-en face à face, sans site web ou no code.

Les étapes

Vous créez un lien, vous le partagez. L'acheteur peut payer sa commande en cliquant sur ce lien.

Les fonctions disponibles

Monext Online autorise les fonctionnalités disponibles suivant chaque moyen de paiement : consulter la documentation des moyens de paiement.

Le paiement par lien permet également les fonctions suivantes :

Un lien valide jusqu’au succès de paiement.
L'acheteur est autorisé à réaliser plusieurs essais pour réussir son paiement.
Un délai de 70 jours.
Le lien a une durée maximale de 70 jours. Cette durée peut être ajuster lors de l'appel web service.
Les modes de paiement et les types d'opération
Ces fonctions sont disponibles selon le moyen de paiement, ainsi que l'authentification 3D Secure, module de fraude et portefeuille électronique.
L'API REST ne permet pas le mode NX et REC. Prévu dans les prochaines releases.
Tous les moyens de paiement du commerçant acceptés.
Seuls les moyens de paiement synchrones sont acceptés. Les moyens de paiement de type Credit et iDeal ne sont pas autorisés.
Nous préconisons utiliser la fonction SmartDisplay.

Une page web personnalisable.
Vous pouvez personnaliser votre page de paiement en créant un modèle sur Monext Online avec la fonctionnalité de personnalisation page web de redirection.
Recevez les notifications.
Utiliser la notification pour indiquer la fin du lien.

Cette fonctionnalité est disponible avec le mode d'intégration WebPayment de l'API REST.

Le parcours

Vous pouvez générer le lien de paiement avec l'API REST avec la page checkout (mode widget).

La génération avec le centre administration sera disponible dans les prochaines livraisons 2024.

Tab Content Wrapper

Tab Element

title	Centre administration

Extrait

Prévu dans les prochaines releases.

Diagramme draw.io

border	false

diagramName	Payline - Payer par lien V2
simpleViewer	false
width
links	auto
tbstyle	top
diagramDisplayName
lbox	true
diagramWidth	1698
revision	8

Tab Element

title	Service API

Extrait

Section

Column

width	33

Générez le lien

Initier la demande de création d'un lien web avec l'API et les informations de la commande ainsi qu'éventuellement la date d'expiration du lien.

Extrait

hidden	true

Bloc de code

language	java
theme	Eclipse
title	REQUEST

POST paymentlinks
{
  "paymentMethod": { "paymentMethodIDs": [ "YOUR_PM_ID" ],
    "smartDisplayIndicator": true   },
  "order": {
    "currency": "EUR",
    "origin": "E_COM",
    "country": "FR",
    "reference": "YOUR_REFERENCE",
    "amount": 1000,
    "date": "2024-06-27T12:45:00Z",
    "items": [
      { "reference": "ref-1",
        "price": 1000,
        "quantity": 10,  },
      }   ]  },
  "payment": {
    "paymentType": "ONE_OFF",
    "capture": "AUTOMATIC",
    "amount": 1000  },
  "threeDS": {
    "challengeInd": "CHALLENGE_REQUESTED",  },
  "pointOfSaleReference": "1",
  "returnURL": "https://yourdomain.com:8080/route/1.0/returns",
  "notificationURL": "https://yourdomain.com:8080/route/1.0/notifications",
  "languageCode": "FR",
  "expirationDate": "2024-07-31"
}

Column

width	33

Envoyez le lien

En réponse de l'appel du service, récupérer le lien à envoyer à votre acheteur.

Extrait

hidden	true

Bloc de code

language	java
theme	Eclipse
title	RESPONSE

POST paymentlinks
{ 
  "result": {
    "title": "ACCEPTED",
    "_eT8o6V": true,
    "code": "00000",
    "detail": "Transaction approved"
  },
  "paymentLink": {
    "link": "https://webpayment.payline.com/...",
    "status": "ACTIVE",
    "id": "1huhcLaIopt1lXxxxxxxx81719916379261",
    "expirationDate": "2024-09-10T21:59:59.999+00:00",
    "createDate": "2024-07-02T10:32:59.261+00:00"
  }
}

Column

width	33

Consultez le résultat

Vous pouvez consulter l'état du lien de paiement à tout moment sur le centre administration.

Diagramme draw.io

border	true

diagramName	Payline - Payer par lien- API-step3
simpleViewer	false
width
links	auto
tbstyle	top
lbox	true
diagramWidth	469
revision	1

Comment intégrer API WebPayment

Les principes d’utilisation

Une fois la fonctionnalité activé, il est utilisable au travers des fonctions standard Monext Online en indiquant le contrat du moyen de paiement .
Le mode d'intégration est disponible avec l'API WebPayment : services Create paymentLink et Get paymentLink.

Le commerçant génère le lien

Créer un lien avec le service Create paymentLink en indiquant la date d'expiration (optionnelle) : expirationDate
Si aucune la date n'est fournie alors la durée de validité de 70 jours s'applique.
Récupérer le lien web (URL) en réponse de l'appel au service et l'identifiant unique du lien.
Vous pouvez envoyer le lien à votre acheteur.

L'acheteur réalise le paiement

L'acheteur ouvre une page web de paiement en cliquant sur le lien, puis réalise le paiement.

Le commerçant récupère le résultat

Vous recevez une notification LINKTRS avec l'ID du lien une fois le paiement est réalisé.
Vous récupérez le résultat du paiement avec le service Get paymentLink.
L'appel au service GET supprime l'exécution de la notification

Extrait

hidden	true

Annulation du lien

Un service CancelLink qui permet de fermer/d'annuler un lien de paiement et de le rendre inactif.

Centre administration

Recherche de transactions

Dans le menu Transactions > Recherche, vous pouvez consulter les transactions réalisées avec la fonction Payer par lien.
Seules les transactions réalisées seront disponibles.

Vous disposez de deux critères supplémentaires pour rechercher vos opérations :

Origine : Lien de paiement
Identifiant paiement par lien : Identifiant unique retourné lors de la génération du lien avec le service Create paymentLink

Extrait

hidden	true

Créer un lien

Vérifier l'état du lien

Il prend en entrée l'identifiant unique du lien et retourne le statut du lien.

4 statuts différents pour un lien :

actif (active) : le lien est créé, un paiement peut être réalisé pour la première fois ou bien une nouvelle tentative de paiement est possible suite à une transaction KO.
inactif (closed) : le lien n'est plus actif, un paiement ne peut pas être réalisé car la transaction a déjà été réalisée.
expiré (expired) : le lien n'est plus actif, la date de validité est dépassée. Aucun paiement n'est possible.
annulé (cancelled) : le lien a été annulé par la fonction CancelLink. Prévu dans le lot 3.

Comment activer cette fonction ?

Pour activer cette fonction, vous devez avoir souscrit à l'option Payer par lien dans votre abonnement.

Inclusion d'extrait

	Contactez le support Monext Online
	Contactez le support Monext Online
nopanel	true

Comment réaliser des tests ?

Vous pouvez réaliser des tests en environnement d’homologation.

Les cartes de test sont accessibles à partir de la page Les cartes de test.

Les codes de retour

Avec l'API WebPayment, Monext Online vous informe du résultat d'un paiement via le code retour des messages du service Get paymentLink.

Lorsque le paiement est accepté, Monext Online renvoie le code retour à la valeur 00000.
Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : 04xxx pour une suspicion de fraude).

Consulter les codes retours ici.

Les codes spécifiques

INPROGRESS : le lien est toujours valide, vous obtenez le code 02533
ACCEPTED : le lien a été payé "Transaction approved" code 00000
CANCELLED : le lien de paiement a déjà été réalisé, vous obtenez le code 02324
ERROR : erreur avec le lien "This token does not exist" code 02317

Etat du lien

Avec l'identifiant unique du lien et vous obtiendrez les différents statuts :

ACTIVE : le lien est créé, la page de web est disponible.
CLOSED : le lien n'est plus actif, la transaction a déjà été réalisé, le paiement ne peut plus se faire via ce lien.
CANCELLED : le lien a été annulé par la fonction CancelLink.
Prévu dans les prochaines releases.
EXPIRED : le lien n'est plus actif, la date de validité est dépassée. Aucun paiement n'est possible.

Pages associées

Contenu par étiquette

showLabels	false
showSpace	false
sort	title
cql	label = "widget" and label = "integration" and space = "DT"

Center

Inclusion d'extrait

	Info page
	Info page
nopanel	true

Arborescence des pages

Comparaison des versions

Ancienne version 32

Nouvelle version Actuel

Légende

Le paiement par lien

Les bénéfices

Les étapes

Les fonctions disponibles

Le parcours

Générez le lien

Envoyez le lien

Consultez le résultat

Comment intégrer API WebPayment

Les principes d’utilisation

Annulation du lien

Centre administration

Recherche de transactions

Comment activer cette fonction ?

Comment réaliser des tests ?

Les codes de retour

Pages associées

Arborescence des pages

Historique de la page

Comparaison des versions

Ancienne version 32

Nouvelle version Actuel

Légende

Le paiement par lien

Les bénéfices

Les étapes

Les fonctions disponibles

Le parcours

Générez le lien

Envoyez le lien

Consultez le résultat

Comment intégrer API WebPayment

Les principes d’utilisation

Annulation du lien

Centre administration

Recherche de transactions

Comment activer cette fonction ?

Comment réaliser des tests ?

Les codes de retour

Pages associées