MB Way
Introduction
MB Way est un portefeuille électronique portugais qui permet aux clients de payer avec une carte préenregistrée sur leur appareil mobile.
Avec 95 % des banques au Portugal prenant en charge MB Way, ce moyen de paiement offre une large couverture et une grande commodité.
Vous redirigez vos clients vers le portail MB Way, où ils saisissent leur numéro de téléphone, ce qui déclenche une notification dans leur application MB Way pour confirmer le paiement.
L'intégration est très simple, car il vous suffit d'envoyer quelques paramètres supplémentaires avec votre requête.
Avantages clés
- Intégration facile
- Exigences PCI faibles (aucune donnée sensible ou personnelle partagée)
- Très populaire au Portugal
- Permet
des autorisations/Direct Sales
l’annulation d’autorisation (totale uniquement)
des remises (captures) partielles/multiples/totales
des remboursements partiels/multiples/totaux
Intégration
Redirigez vos clients vers le portail de paiement MB Way via notre Hosted Checkout Page. Retrouvez le détail de chaque étape dans le chapitre "Cinématique".
Ajoutez les propriétés suivantes à votre requête de paiement CreateHostedCheckout :
{
"redirectPaymentMethodSpecificInput": {
"paymentProductId": 5908,
"returnUrl": "https://yourReturnUrl.com",
"authorizationMode": "FINAL_AUTHORIZATION"
},
"order": {
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 100
},
"customer": {
"contactDetails": {
"emailAddress": "wile.e.coyote@acmelabs.com",
"phoneNumber": "+1234567890"
},
"billingAddress": {
"countryCode": "PT"
},
"personalInformation": {
"name": {
"firstName": "Wile",
"surname": "Coyote",
}
}
}
}
}
| Propriétés | Remarques |
|---|---|
|
order.customer |
emailAddress : L'adresse e-mail de votre client. phoneNumber : Le numéro de téléphone de votre client. billingAddress: L'adresse de facturation de votre client. personalInformation : Le prénom et le nom de vos clients. |
|
order.amountOfMoney |
amount : Le montant que vous souhaitez facturer pour cette commande. |
|
redirectPaymentMethodSpecificInput |
paymentProductId : L'identifiant de la méthode de paiement sur notre plateforme. Retrouvez cet identifiant dans l'onglet "Aperçu". Il indique à notre plateforme de rediriger directement vos clients vers le portail MB Way. En cas d'omission, notre plateforme redirige vos clients vers la Hosted Checkout Page, leur permettant de choisir ce mode de paiement ou tout autre actif dans votre compte. authorizationMode : Définir sur "FINAL_AUTHORIZATION"/"PRE_AUTHORIZATION"/"SALE" selon que vous souhaitez traiter les paiements en mode autorisation/Direct Sale. returnUrl : L'URL vers laquelle vos clients sont redirigés une fois le paiement finalisé. |
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.
Cinématique
Ce flux implique à la fois les dispositifs mobiles/tablettes et de bureau de vos clients interagissant entre eux.
- Vos clients finalisent une commande dans votre boutique et sélectionnent MB Way.
- Vous adressez une requête de paiement CreateHostedCheckout à notre plateforme.
- Vous redirigez vos clients via le redirectUrl de leur dispositif de bureau vers le portail MB Way. Ils entrent leur numéro de téléphone sur le portail MB Way.
- L'appareil mobile de vos clients ouvre l'application MB Way. Vos clients confirment le paiement dans l'application à l'aide de leur code PIN.
- Nous recevons le résultat de la transaction.
- L'appareil mobile de vos clients s'ouvre pour confirmer le paiement dans l'application MB Way. Nous redirigeons vos clients vers votre returnURL.
- Vous demandez le résultat de la transaction à notre plateforme via l'opération GetHostedCheckout ou recevez le résultat via webhooks.
- Si la transaction est réussie, vous pouvez délivrer les biens / services.
Test
Consultez nos Cas de test pour des données de test et des instructions détaillées.
- Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.
- Les données dans notre chapitre Cas de test fonctionnent UNIQUEMENT pour les demandes de paiement dans notre environnement de test. Utiliser ces données dans notre environnement de production entraînera des résultats de test indésirables.