- Directives d'intégration
- Fonctionnalités prises en charge (Méthodes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
- Paiements Multibanco
Paiements Multibanco
Multibanco est une méthode de paiement utilisée au Portugal. Multibanco permet aux consommateurs de payer une gamme de biens ou de services (notamment, commerce électronique, licences et taxes) par virement bancaire ou à l'aide de la carte Multibanco à un guichet automatique.
Multibanco est une méthode de paiement avec redirection prise en charge sur Mastercard Gateway. Cette page explique les détails de l'intégration spécifique à Multibanco. Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une intégration Multibanco.
Les paiements avec redirection Multibanco ne sont pris en charge que pour les transactions libellées en EUR.
Conditions préalables
Pour proposer Multibanco comme méthode de paiement via Mastercard Gateway :
- vous devez être inscrit auprès de votre prestataire de services de paiement avec redirection,
- votre profil de commerçant sur la passerelle doit être configuré en utilisant les détails de votre compte auprès de votre prestataire de services de paiement avec redirection, et
- vous devez disposer d’un compte bancaire dans l'une des devises prise en charge enregistré pour votre compte de commerçant chez votre prestataire de services de paiement avec redirection.
Intégration Multibanco
L'intégration Hosted Checkout vous permet de recueillir des détails de paiement auprès de votre payeur à l’aide d’une interaction hébergée et affichée par la passerelle.
À compter de la version 65 de l'API, Multibanco est automatiquement disponible comme méthode de paiement après votre activation et votre configuration par votre prestataire de services de paiement pour cette méthode de paiement.
Pour plus d'informations, voir Intégration des paiements avec redirection via Hosted Checkout.
L'intégration Direct Payment vous permet de proposer la méthode de paiement Multibanco sur votre propre page de paiement.
Faire une demande Initiate Browser Payment
(Lancer un paiement avec redirection) où sourceOfFunds.type = MULTIBANCO
et browserPayment.operation = PAY
(l'opération Authorize (Autoriser) n'est pas prise en charge par Multibanco). Pour les champs standard, voir Paiements avec redirection via l'intégration Direct Payment.
Les champs suivants sont renvoyés dans la réponse Initiate Browser Payment
(Lancer un paiement avec redirection)/Retrieve Transaction
(Extraire la transaction)/Retrieve Order
(Extraire la commande) après l'initiation d'un paiement Multibanco.
sourceOfFunds.provided.multibanco.entityId
: votre identifiant de commerçant auprès de Multibanco.sourceOfFunds.provided.multibanco.paymentReference
: un identifiant pour le paiement Multibanco.
Vous devez fournir ces champs à votre payeur pour qu'il puisse terminer le paiement.
Langue préférée
Vous pouvez définir la langue que vous préférez que Multibanco utilise pour les pages affichées au payeur en renseignant le champ browserPayment.preferredLanguage
dans la demande Initiate Browser Payment (Lancer un paiement avec redirection). Toutefois, la langue n'est utilisée que si Multibanco la prend en charge.
{ "apiOperation":"INITIATE_BROWSER_PAYMENT", "browserPayment":{ "operation":"PAY", "returnUrl":"<your_merchant_URL>" }, "order":{ "amount":"10.00", "currency":"EUR" }, "sourceOfFunds":{ "type":"MULTIBANCO" } }
Comment interpréter le résultat de la transaction
Le tableau ci-dessous illustre les codes de réponse de transaction pour les scénarios possibles auxquels vous pouvez devoir faire face après avoir initié un paiement Multibanco.
Réponse Initiate Browser Payment (Lancer un paiement avec redirection) |
Qu’est-ce que cela signifie ? |
---|---|
response.gatewayCode=SUBMITTED result=SUCCESS |
Redirigez le payeur en utilisant l'URL indiquée dans la réponse. |
Réponse Retrieve Transaction/Retrieve Order (Extraire une transaction/Extraire une commande) |
Qu’est-ce que cela signifie ? |
response.gatewayCode=APPROVED result=SUCCESS sourceOfFunds.provided.multibanco.terminalLocation sourceOfFunds.provided.multibanco.terminalId |
Le paiement a réussi. |
response.gatewayCode= PENDING result=PENDING |
Mastercard Gateway attend une notification de l'acquéreur à propos du résultat du paiement. Réessayez la transaction RETRIEVE_TRANSACTION ou surveillez les notifications de Mastercard Gateway. |
response.gatewayCode= CANCELLED result=FAILURE |
Le payeur a annulé l'interaction pour ce paiement. Proposez au payeur d'essayer une autre méthode de paiement. |
response.gatewayCode= DECLINED or ACQUIRER_SYSTEM_ERROR result=FAILURE |
Le paiement a été refusé. Proposez au payeur d'essayer une autre méthode de paiement. Dans le cas d'une erreur ACQUIRER_SYSTEM_ERROR , vous pouvez vouloir demander à l'acquéreur la raison de l'échec du paiement, ou vous pouvez réessayer la transaction RETRIEVE_TRANSACTION . |
response.gatewayCode=TIMED_OUT result=FAILURE |
Traitez cela comme un paiement refusé. La passerelle vérifiera que la transaction a échoué ou l'annulera. |
Test de votre intégration
Mastercard Gateway propose un émulateur de paiements avec redirection qui vous permet de tester votre intégration Multibanco.