Contenu
Sommaire | ||||
---|---|---|---|---|
|
Plus d'information
Activer MBWay sur mon compte
Vous
Comment configurer votre compte ?
Les commerçants doivent contractualiser en direct, avec un acquéreur de MB brand ou un autre intégrateur certifié SIBS FPS.
Toutes les communications sont basées sur le protocole HTTPS et authentifié par un certificat pour les tests et la production.
Le certificat client sera fourni par SIBS FPS.
Pour configurer votre compte sur Payline, vous devez vous rapprocher de votre responsable de compte afin d'activer l'option adhéquate à votre abonnement.
Ensuite veuillez adresser un email à notre équipe support@payline.com avec les informations, afin qu'ils puissent procéder au paramétrage dans votre compte marchand Paylineou d'un commercial pour la création de ce moyen de paiement.
Monext Online réalise toute la configuration.
Contactez le support Monext Online.
Une fois votre le nom de l’alias du numéro de contrat créé alors le moyen de paiement est disponible.
Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.
Ecran de configuration
Le code (card_code) du moyen de paiement est : MBWAY_MNXT
L'écran de configuration :
Inclusion d'extrait | ||||||
---|---|---|---|---|---|---|
|
Proposer
Comment proposerle paiement MB Way à vos clients
?Les principes d’utilisation
Une fois le moyen de paiement activé, il est utilisable au travers des fonctions standard Payline en indiquant le contrat du moyen de paiement Contrat_Number.
Le mode d'intégration est disponible avec l'API WebPayment : services doWebPayment et getWebPaymentDetails.
Le mode d'intégration avec l'API DirectPayment avec le service doAuthorization.
Les web services en mode web
Les web services
en mode Webselon les fonctions disponibles (vérifier les disponibilités dans le tableau ci dessus) :
Interfaces de paiement : API WebPayment, Direct Payment et Cente d'administration.
Paiement à la commande : en utilisant le service doWebPayment avec payment.mode à CPT et code Action à 101.
Paiement à l'expédition : en utilisant les services doWebPayment et doCapture avec le code Mode à CPT et code Action à 100.
- Mode de paiement : sélectionner votre mode de paiement comptant avec le le code Mode = CPT.
- Paiement par portefeuille électronique : avec IDWallet de la demande de paiement doWebPayment, service de gestion manageWebWallet et de paiement par portefeuille doImmediateWaletPayment.
- Paiement en différé : en utilisant les services doAuthorization et doCapture avec le code Mode à DIF et le code Action à 100.
- Demande d'annulation d'une autorisation non encaissée Demande de remboursement d'une transaction remisée : utilisez la fonction doReset permet au marchand de demander l’annulation totale, partielle ou multiple de la commande.
- Demande de remboursement totale, partielle ou multiple d'une transaction remisée : utilisez la fonction doRefund avec le code action à 421.
- La demande de réautorisation avec le service doReauthorization.
- Le module fraude : règles sur la transaction, l'acheteur et sur le moyen de paiement.
Authentification 3D Secure
Les paiements sont éligibles au traitement par le module anti-fraude Payline, au même titre que les autres transactions.
Si une authentification 3DSecure est nécessaire, Payline gère l’affichage de la page ACS. Seul un refus banque (FICP ou acquéreur) peut conduire à un refus du paiement.
Les web services en mode Direct
Le mode d'intégration en API direct est disponible en utilisant le webservice isRegistered. Ce service vous permet de récupérer le scoring data nécessaire pour appeler le moyen de paiement.
Vous récupérez un registrationToken à renvoyer dans la demande de 3D Secure verifyEnrollment puis dans la demande de paiement doAuthorization.
En entrée le commerçant indique le contrat, le montant, commande et les données personnelles.
En retour, il reçoit un l'échéancier de paiement dont les frais de dossier et le registrationToken qui permettra de réaliser le paiement.
Les champs obligatoires
- doRefund pour rembourser la commande (délai max de 180 jours).
- Réponse de paiement : consulter la réponse du service getWebPaymentDetails pour obtenir les informations du moyen de paiement et de l'acheteur.
- Exemple d'information du moyen de paiement :
- transaction.partnerAdditionalData = {"paymentPurpose":"Test payment"}
- Données du payeur : buyer.lastname et buyer firstname
- Exemple d'information du moyen de paiement :
Gestion des états du widget
Pour ce moyen de paiement, vous devez contrôler les états du widget avec la fonction Fonction CallBack.
Lors du parcours de paiement, l'acheteur réalise sur MB Way :
- Le widget Payline est à l'état ACTIVE_WAITING, vous pouvez afficher une page d'attente ou un spinner.
- Dès que le paiement est réalisé, le widget passe à l'état PAYMENT_SUCCESS, PAYMENT_FAILURE ou PAYMENT_CANCE, alors vous pouvez afficher le résultat de la commande.
Consulter la documentation pour personnaliser les messages de l'état en mode widget PW - Personnalisation du widget.
Libellé sur le ticket de paiement
Vous pouvez choisir d'alimenter un libellé sur le ticket de paiement avec le champ payment.softDescriptor du service doWebPayment.
S'il est vide alors le nom d'enseigne du moyen de paiement dans le centre administration sera sélectionné.
Et si ce dernier est vide alors le nom d'enseigne du compte commerçant dans le centre administration sera sélectionné.
Les champs obligatoires
Les champs obligatoires Les champs obligtoires doivent être renseignés lors de la demande de paiement, dans le cas contraire la demande sera refusée.
Nom du champ |
---|
Id transaction
Numéro de carte
Comment réaliser des tests ?
Exemple | |
---|---|
payment.action | 101 |
payment.mode | CPT |
order.amount | 1000 |
order.currency | 978 |
buyer.firstname | John |
buyer.lastname | Doe |
buyer.mobilePhone | 0605040301 |
Le montant de la commande doit être égale ou supérieur à la demande de paiement : order.amount >= payment.amount
Réaliser des tests
L’application est téléchargeable à cette adresse : https://software.sibs.pt/mbway
Vous devez avoir un numéro de téléphone portugais pour l'enregistrer votre carte bancaire de test sur votre application MBWay téléchargée. Ensuite vous pourrez valider votre compte et recevoir le code PIN,
Sur l'environnement d'homologation (Test), vous êtes connecté à un simulateur vous proposant directement sur l'interface avec deux options :
- Paiement accepté avec un code retour = ACCEPTED - 0000
- toutes les cartes sont acceptées.
- Paiement abandonné avec un code retour = CANCELLED - 02008
Lors du paiement une page du simulateur vous propose deux boutons sur l'environnement d'homologation (TEST) : un succès (MAKE A PAYMENT) et un abandon (ABORT)Il vous faut obtenir une carte de test auprès ....
Les codes de retour
Avec l'API WebPayment, Payline Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'un paiement via le ShortMessage des services getWebPaymentDetails.
Avec intégration proposé par le moyen de paiement.
- pour l'API WebPayment avec le service getWebPaymentDetails,
- pour l'API DirectPayment
- en réponse du service doAuthorization de manière synchrone ou getTransactionDetails en réponse
- asynchrone.
Les états retournés :
- Le paiement est accepté
Pour un paiement refusé, le
- avec l'état ACCEPTED et le code retour 00000.
- Le paiement est refusé avec l'état REFUSED. Le code varie en fonction du motif de refus (Par exemple : 01xxx pour une raison bancaire ou 04xxx pour une suspicion de fraude).
La gestion des états et des codes retour sont listés ici.
Les codes spécifiques au moyen de paiement sont listés ici.du moyen de paiement :
Code | ShortMessage | LongMessage |
---|---|---|
02012 | ERROR | Unmatched partner return code |
02308 | ERROR | Invalid value for |
02008 | CANCELLED | Transaction canceled by user |
02324 | REFUSED | The session expired before the consumer has finished the transaction |
02020 | REFUSED | Transaction refused by partner |
02106 | ERROR | Payment partner error |
Pages associées
Contenu par étiquette | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|