Table des matières
Multibanco
Informations générales sur Multibanco
Multibanco est un mode de paiement au Portugal selon lequel l'acheteur peut choisir entre un virement en ligne et un paiement comptant. Dans le premier cas, l'acheteur entre ses détails pour Multibanco et le commerçant reçoit une confirmation du paiement. En alternative, l'acheteur peut payer comptant auprès d'une banque ou d'un distributeur automatique de billets. Le commerçant bénéficie d'une garantie de paiement par le système. |
Schéma de déroulement du processus
Déroulement du processus Multibanco
Interface plateforme de paiement
Formats des données : a alphabétique as alphabétique avec caractères spéciaux n numérique an alphanumérique ans alphanumérique avec caractères spéciaux ns numérique avec caractères spéciaux bool expression booléenne (true ou false) 3 longueur fixe avec 3 chiffres/caractères ..3 longueur variable avec maximum 3 chiffres/caractères enum énumération de valeurs admissibles dttm Date et heure ISO (AAAA-MM-JJThh:mm:ss) Abréviations : CND condition M obligatoire (mandatory en anglais) O optionnel C conditionnel Remarque : Veuillez noter que les noms des paramètres peuvent être en majuscules ou en minuscules.
Paiement avec Multibanco via l'interface de formulaire de la plateforme de paiement
Multibanco propose deux modes d’intégration du commerçant avec la plateforme de paiement. Selon le mode choisi par le commerçant, pour la seconde solution, le commerçant doit informer BNP afin d’effectuer la configuration adaptée. Première option sélectionnée par défaut : une fois le mode de paiement Multibanco choisi, le client est redirigé vers une page d’accueil prédéfinie qui affiche les informations pertinentes telles que le montant, l’identifiant de la société et la référence à saisir sur son portail de banque en ligne ou sur un GAB. Seconde option : une fois le mode de paiement choisi, le commerçant reçoit une réponse directe à la demande avec la plateforme de paiement. Il doit afficher les informations qu’il reçoit dans la réponse sur sa page d’accueil dont la conception correspond à l’agencement de sa boutique. Dans la réponse pour la seconde option, la plateforme de paiement envoie au commerçant les deux paramètres supplémentaires CompanyID et Référence.
Pour procéder à un paiement Multibanco à l'aide d'un formulaire de la plateforme de paiement, appelez l'adresse URL ci-dessous :
Remarque : Pour des raisons de sécurité, plateforme de paiement rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
---|---|---|---|
MerchantID | ans..30 | M | ID du commerçant. Ce paramètre doit également être transféré non chiffré. |
TransID | ans..64 | M | Numéro de transaction du commerçant, ce numéro doit être univoque |
RefNr | ans..40 | O | Numéro de référence univoque du commerçant. Seuls les caractères a-zA-Z0-9,-_ sont autorisés. |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Devise, trois caractères DIN / ISO 4217. Seul EUR est autorisé. |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
URLSuccess | ans..256 | M | Adresse URL complète qui appelle plateforme de paiement en cas de réussite du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData. |
URLFailure | ans..256 | M | Adresse URL complète qui appelle plateforme de paiement en cas d'échec du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData. |
Response | a7 | O | État de la réponse envoyée par plateforme de paiement à URLSuccess et URLFailure, doit être chiffré. À cette fin, transmettez le paramètre Response=encrypt. |
URLNotify | ans..256 | M | Adresse URL complète appelée par plateforme de paiement pour notifier le résultat de paiement à la boutique. L'URL ne peut être appelée que par le port 443. Elle ne peut contenir aucun paramètre : utilisez le paramètre UserData pour ce faire. |
UserData | ans..1024 | O | Si indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement |
ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
OrderDesc | ans..768 | M | Description des marchandises et des prix. Destination prévue sur le relevé de compte. |
SellingPoint | ans..50 | O | Point de vente |
Service | ans..50 | O | Produits ou services vendus |
Channel | ans..64 | O | Canal de configuration du contrat PPRO (Account et ContractID sont enregistrés au sein du système). Si ce paramètre est disponible, il remplace le cas échéant les canaux enregistrés au sein du système |
AccOwner | ans..50 | M | Nom du titulaire de compte |
Plain | ans..50 | O | Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID |
Custom | ans..1024 | O | Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 |
Paramètres pour les paiements avec Multibanco
Le tableau suivant décrit les paramètres de réponse que plateforme de paiement transmet à URLSuccess ou URLFailure et URLNotify. Si vous avez spécifié le paramètre Response=encrypt, les paramètres suivants sont transmis à votre système avec chiffrement Blowfish :
Paramètre | Format | CND | Description |
---|---|---|---|
MID | ans..30 | M | ID du commerçant |
PayID | an32 | M | ID attribuée au paiement par plateforme de paiement, par ex. pour le référencement au sein des fichiers batch. |
XID | an32 | M | ID attribuée par plateforme de paiement pour toutes les différentes transactions pour un paiement |
TransID | ans..64 | M | Numéro de transaction du commerçant |
RefNr | ans..40 | O | Numéro de référence univoque du commerçant. Seuls les caractères a-zA-Z0-9,-_ sont autorisés. |
Status | a..30 | M | OK si URLSuccess et AUTHORIZE_REQUEST, ou FAILED si URLFailure |
Description | ans..1024 | M | Détails supplémentaires en cas d'échec du paiement. Veuillez ne pas utiliser le paramètre Description mais bien le paramètre Code pour une analyse de l'état de la transaction ! |
Code | n8 | M | Code d'erreur conformément au fichier Excel des codes de réponse plateforme de paiement (partie du logiciel Client) |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
UserData | ans..1024 | O | Si indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement |
PaymentGuarantee | a..12 | C | NONE = pas de garantie de paiement, VALIDATED = compte client valide mais pas de garantie de paiement, FULL = garantie de paiement Remarque : ce paramètre n'est retourné que si l'état est = OK. |
ErrorText | ans..256 | C | Message d'erreur PPRO détaillé. Remarque : n'est retourné que si l'état = FAILED. Utilisation possible uniquement après concertation avec le Support. |
TransactionID | an..20 | O | Numéro de transaction univoque pour PPRO |
CompanyID | an..20 | C | Pour une transaction directe : Référence de l’entité de la transaction pour Multibanco |
Reference | an..30 | C | Pour une transaction directe : Référence de paiement de la transaction pour Multibanco |
Plain | ans..50 | O | Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID |
Custom | ans..1024 | O | Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 |
Paramètres de retour pour URLSuccess, URLFailure et URLNotify avec Multibanco