Multibanco

Introduction

Multibanco est une méthode de paiement disponible au Portugal pour les paiements physiques sous forme de bon de paiement post-payé.

Sur le portail de paiement Thunes, vos clients reçoivent toutes les informations nécessaires pour effectuer le paiement par carte ou en espèces :

Lieu de paiement (DAB du réseau Multibanco)
Référence de paiement
Montant
Période de paiement (date de début et de fin)

L'intégration est très simple, car vous n'avez qu'à envoyer deux paramètres supplémentaires dans votre requête de paiement. Découvrez tout ce que vous devez savoir dans les chapitres Intégration et Cinématique.

Aperçu

Groupe de paiement :

Postpayé

Identifiant du moyen de paiement:

5500

Avantages clés

Paiement garanti
Exigences PCI faibles
Intégration facile

Pays & devises

Pays pris en charge

Portugal

Devises prises en charge

Euro (EUR)

Intégration

Redirigez vos clients vers le portail de paiement Thunes via notre Hosted Checkout Page. Retrouvez une vue d'ensemble dans le chapitre "Cinématique".

Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :

{
   "order": {
      "amountOfMoney": {
         "currencyCode": "EUR",
         "amount": 10000
      },
      "customer": {
         "contactDetails": {
            "emailAddress": "jean.dupont@test.com"
         }
      },
      "references": {
         "merchantReference": "mr_{{TIMESTAMP}}"
      }
   },
   "hostedCheckoutSpecificInput": {
      "locale": "pt_PT"
   },
   "redirectPaymentMethodSpecificInput": {
      "paymentProductId": 5500
   }
}

Propriétés	Remarques
order.customer.contactDetails.emailAddress	L'adresse e-mail de votre client.
redirectPaymentMethodSpecificInput.paymentProductId	L'identifiant numérique de la méthode de paiement sur notre plateforme. Retrouvez cet identifiant dans le chapitre "Aperçu". Il indique à notre plateforme d'envoyer vos clients directement sur le portail Thunes. 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.

Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.

Cinématique

Vos clients finalisent une commande dans votre boutique et sélectionnent Multibanco.
Vous adressez une requête de paiement CreateHostedCheckout à notre plateforme.
Vous redirigez vos clients vers le portail Thunes via le redirectUrl. Cela fournit toutes les informations nécessaires à vos clients pour effectuer le paiement à un moment ultérieur (étape 6).
Nous recevons le résultat intermédiaire de la transaction (statusOutput.statusCode=51)
Nous redirigeons votre client vers votre returnUrl
Vous demandez le résultat intermédiaire de la transaction (statusOutput.statusCode=51) depuis notre plateforme via l'opération GetHostedCheckout ou recevez le résultat via webhooks.
Dans la période prédéfinie, vos clients effectuent le paiement réel à un DAB du réseau Multibanco, soit par carte de crédit soit en espèces.
Multibanco nous confirme la réception du paiement. Nous mettons à jour la transaction en statusOutput.statusCode=5
Vous demandez le résultat final de la transaction (statusOutput.statusCode=5) depuis notre plateforme via l'opération GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
Si la transaction a réussi, vous pouvez délivrer les biens / services.

La période de paiement prédéfinie est de 2 à 3 jours. Vous pouvez adapter la durée en consultant Thunes.
Envoyez les biens/services uniquement après que nous ayons mis à jour la transaction à StatusCode=5. Utilisez nos webhooks ou une requête GetPayment pour obtenir le statut actuel en temps réel.
Si Multibanco ne confirme pas la réception du paiement dans la période prédéfinie, nous mettons à jour la transaction à StatusCode=2

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.