MB Way

Introduction
MB Way est un porte-monnaie électronique disponible au Portugal permettant aux clients de payer depuis leur appareil mobile avec avec une carte préenregistrée. Une fois redirigés vers le portail MB Way, ils confirment leur paiement avec leur numéro de téléphone et un code PIN.
L'intégration est très simple, car vous n'avez qu'à envoyer deux paramètres supplémentaires dans votre requête de paiement. Cette méthode de paiement est compatible avec le mode d'intégration Hosted Checkout Page.
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"
}
}
}
}
Propriétés | Remarques |
---|---|
order.customer.contactDetails |
emailAddress : L'adresse e-mail de votre client. phoneNumber : Le numéro de téléphone de votre client. |
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 : Renseignez "FINAL_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.