Contenu
Plus d'information
Activer Multibanco sur mon compte
Vous devez vous rapprocher de votre responsable de compte ou 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.
Le code (card_code) du moyen de paiement est : MULTIBANCO_MXNT
L'écran de configuration
Proposer le moyen de paiement Multibanco à vos clients
Les principes d'intégration
Une fois le moyen de paiement activé, il est utilisable au travers des fonctions Monext Online 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.
1. Initiation du paiement
Avec le service doWebPayment, vous récupérez le token et l'URL de redirection.
L'acheteur valide sa commande et obtient les informations sur la page de paiement, puis il doit réaliser son paiement par virement sur sa banque en ligne ou par guichet automatique (GAB/ATM).
La commande est passé mais elle n'est pas payée : Il est déconseillé de procéder à l'expédition ou de délivrer le service à cette étape.
Dès que la fin du délai de paiement de la session pour cette première étape de commande, alors Monext créée une opération de type commande avec l'état ONHOLD_PARTNER.
Vous pouvez récupérer le résultat de la transaction de type paiement avec le web service getWebPaymentDetails avec le token récupéré dans le doWebPayment.
Vous obtenez l'état INPROGRESS avec le code retour 02306.
Les opérations de commande et de paiement sont liées avec l'ID Transaction d'origine.
Le résultat dans le centre administration :
2. L'acheteur réalise le paiement
Dès que l'acheteur paie le montant :
- Monext reçoit l'information et met à jour la transaction avec le statut ACCEPTED ;
- Monext notifie le marchand (notification URL de type WEBTRS).
Le commerçant peut récupérer le détail de la transaction afin de vérifier que le montant et le statut correspondent bien à l'attendu avec le service getWebPaymentDetails.
Vous obtenez l'état ACCEPTED avec le code retour 00000.
Le résultat dans le centre administration :
3. Expiration du paiement
Lorsque la date de validité est dépassé :
- Monext met à jour la transaction avec le statut Refused;
- Monext notifie le marchand (notification URL de type WEBTRS).
Une fois la date d'expiration atteinte, alors le coupon de paiement sera refusée.
La commande doit être annulée par le marchand : l'acheteur ne pourra plus la régler.
Vous obtenez l'état REFUSED avec le code retour 02234.
Le résultat dans le centre administration :
Fonctionnalités disponibles
Interfaces de paiement : API WebPayment.
Paiement à la commande : en utilisant le service doWebPayment avec payment.mode à CPT et code Action à 101.
- Mode de paiement : comptant avec le code Mode = CPT.
- Demande de remboursement d'une transaction remisée : utilisez le service doRefund pour rembourser la commande.
- 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 = {"PARTNER_TRANSACTION_ID":"1210831011","terminalAddressLocation":"TESTBANK","serviceSupplierId":"11854","terminalIdentification":"0000001235","paymentReference":"999999998"}
- transaction.partnerAdditionalData = {"PARTNER_TRANSACTION_ID":"1210831011","terminalAddressLocation":"TESTBANK","serviceSupplierId":"11854","terminalIdentification":"0000001235","paymentReference":"999999998"}
- Données du payeur : buyer.lastname et buyer firstname
- Exemple d'information du moyen de paiement :
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é.
Notification
Pour récupérer le résultat de la transaction : nous préconisons d'activer l'option Notification des transactions de paiement sans portefeuille sur le points de vente.
Les champs obligatoires
Données spécifiques
Des informations sont générées par le système lors de l'émission d'un coupon Multibanco.
Le champ PartnerAdditionalData dans l'objet Transaction permet de récupérer ces informations. Il est présent dans le détail de la transaction (suite à un appel à getWebPaymentDetails ou getTransactionDetails) :
<additionalData> { "entity":"Référence marchand", "reference":"reference SIBS du paiement", "amount":"montant en centimes", "startdate":"DD/MM/YYYY", “expdate”:”DD/MM/YYYY” } </additionalData> |
Les champs obligatoires doivent être renseignés lors de la demande de paiement, dans le cas contraire la demande sera refusée.
Nom du champ | Exemple |
---|---|
payment.action | 100 |
payment.mode | CPT |
order.amount | 1000 |
order.currency | 978 |
order.country | PT |
buyer.firstname | John |
buyer.lastname | Doe |
Le montant de la commande doit être égale ou supérieur à la demande de paiement : order.amount >= payment.amount
Réaliser des tests
Sur l'environnement d'homologation (Test), vous êtes connecté à un simulateur vous proposant directement sur l'interface avec deux options :
- Paiement accepté avec un état ACCEPTED et le code retour 0000.
- Paiement abandonné avec un état CANCELLED et le code retour 02008.
- La commande est en attente de paiement avec un état INPROGRESS et le code retour 02306.
- Le coupon de paiement est expiré avec l'état REFUSED et le code retour 02234.
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).
Les codes de retour
Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'intégration proposé par le moyen de paiement. Les états retournés : La gestion des états et des codes retour sont listés ici.