Bizum
Introduction
Bizum est un portefeuille espagnol permettant aux clients de payer avec leur téléphone mobile. Après avoir redirigé vos clients vers le portail Bizum, ils confirment le paiement avec leur numéro de téléphone et un mot de passe. Vos clients peuvent effectuer leur paiement dans un navigateur ou dans l'application Bizum, ce qui simplifie l'expérience de paiement.
L'intégration est très facile, car vous n'avez que trois paramètres supplémentaires à envoyer dans votre requête. Vous pouvez implémenter cette méthode de paiement avec les deux modes d'intégration Hosted Checkout Page/Server-to-server.
Activation
Vous utilisez l'interface BackOffice ?
Vous pouvez configurer les identifiants d'activation et activer cette méthode de paiement via Configuration. Découvrez ici comment procéder..
Pour activer Bizum dans votre compte en production, suivez ces étapes :
- Obtenez vos identifiants Bizum (ID Bizum, ID Terminal, clé secrète).
- Entrez les identifiants dans le Merchant Portal et activez Bizum comme décrit dans notre guide.
- Connectez-vous à la plateforme Bizum et allez dans "Configuration data". Configurez les paramètres suivants :
Vous pouvez activer Bizum dans l'environnement de test à tout moment en entrant des données factices comme décrit à l'étape 3.
Espagne
Intégration
Nous proposons cette méthode de paiement pour les modes d'intégration suivants. Découvrez leurs différences dans nos guides dédiés :
Trouvez un aperçu général dans le chapitre "Cinématique".
Hosted Checkout Page/Server-to-server
Ajoutez les propriétés suivantes à une requête standard de CreateHostedCheckout/CreatePayment :
{
"order":{
"amountOfMoney":{
"currencyCode":"EUR",
"amount":980
},
"customer":{
"locale":"en_GB"
}
},
"redirectPaymentMethodSpecificInput":{
"PaymentProductId":5001,
"RequiresApproval":false,
"redirectionData":{
"returnUrl":"https://yoururl.com"
}
}
}| Propriétés | Remarques |
|---|---|
|
redirectPaymentMethodSpecificInput PaymentProductId |
paymentProductId: L'identifiant numérique de la méthode de paiement sur notre plateforme. Trouvez cet identifiant dans le chapitre "Aperçu". Il indique à notre plateforme d'envoyer vos clients directement au portail Bizum. Si omis, notre plateforme envoie vos clients vers Hosted Checkout Page, leur permettant de choisir cette méthode ou toute autre méthode de paiement active sur votre compte. returnURL: L'URL vers laquelle nous redirigeons vos clients une fois le paiement finalisé. requiresApproval: Définir sur "true"/"false" selon que vous souhaitez traiter les paiements en mode autorisation / vente directe. |
- Si vous définissez requiresApproval sur "true", assurez-vous de capturer la transaction ultérieurement via le Merchant Portal ou une demande CapturePayment. Ce n'est qu'à ce moment-là que la transaction aura status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, pour lequel vous recevez le paiement réel pour la transaction.
- Sachez que Bizum ne prend en charge qu'une seule capture finale (partielle).
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI/CreatePaymentAPI.
Cinématique
- Chaque transaction Bizum est liée à un code d'autorisation que vous devez montrer à vos clients pendant le processus de paiement.
- Le processeur Bizum, Redsys, vous offre deux options pour cela :
1. Redsys affiche le code d'autorisation sur une page intermédiaire (voir étape 4a).
2. Vous récupérez le code d'autorisation et l'affichez sur votrereturnUrl(voir étape 4b). - L'option 1 nécessite que vos clients valident la redirection vers votre
returnURL. Cependant, certains clients pourraient fermer leur navigateur à la place. Cela entraînera des écarts entre le statut réel de la transaction et ce que vous recevez dans votre demande GetPayment/webhooks (voir étape 6). - Pour éviter de tels écarts et augmenter les taux de conversion, nous recommandons fortement de choisir l'option 2.
- L'utilisation des options 1 ou 2 nécessite l'activation par Redsys. Contactez-les pour activer/basculer entre les options selon votre préférence.
- Vos clients finalisent une commande dans votre boutique et sélectionnent Bizum.
- Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme.
- Vous redirigez vos clients via le redirectUrl (pour les demandes CreateHostedCheckout) ou merchantAction.redirectData.redirectURL (pour les demandes CreatePayment). Si vos clients ont l'application Bizum installée sur leur appareil, cela ouvre automatiquement l'application.
Vos clients entrent leurs données personnelles (numéro de téléphone et mot de passe) pour confirmer la commande. - Notre plateforme reçoit le résultat de la transaction. Selon la configuration que Redsys a mise en place et activée, deux scénarios sont possibles :
a. Bizum redirige vos clients vers la page intermédiaire de Redsys, affichant le code d'autorisation de la transaction. Vos clients confirment la redirection vers le returnURL.
b. Bizum redirige vos clients vers le returnURL. - Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks. Si vous traitez des transactions via le flux 4b, vous obtenez le code d'autorisation de la transaction via la propriété redirectPaymentMethodSpecificOutput.PaymentProduct5001SpecificOutput.authorisationCode depuis notre plateforme via la requête GetPaymentDetails/GetHostedCheckout. Assurez-vous d'afficher ce code sur votre returnURL.
- Si la transaction a réussie, vous pouvez 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.
Informations supplémentaires
Configuration de test
Vous pouvez activer Bizum de la manière suivante :
- En test avec le simulateur de Direct
- En test avec des tests de bout en bout
- En production pour le traitement de transactions réelles
Configuration dans l'interface BackOffice
Vous utilisez l'interface BackOffice ?
Vous pouvez également y configurer Bizum. Découvrez ici comment procéder.
Activer le simulateur de paiement Direct dans le compte de test
Cela vous permet d'envoyer des demandes de transaction à notre environnement de test et de réaliser des tests comme décrit dans notre chapitre Test. Ces transactions n'ont pas d'impact financier.
Suivez ces étapes :
- Connectez-vous à votre compte de test dans le Merchant Portal. Allez à Entreprise > Moyens de paiement > Bizum.
- Dans direct.MerchantPortal.BusinessTab.PaymentMethodsSubTab.ActivateBizum, remplissez les propriétés suivantes :
Propriété Description/Actions ID Bizum (FUC) Entrez une valeur numérique de 8 chiffres quelconque. ID Terminal Entrez une valeur numérique de 3 chiffres quelconque. Clé secrète Entrez une de ces chaînes de clés secrètes SHA-256 :
VmFsaWRCaXp1bUtleUluMjRQb3MwMDAx
Qml6dW1LZXlJbjI0UG9zMDAwMlZhbGlk
S2V5SW4yNFBvczAwMDNWYWxpZEJpenVt
SW4yNFBvczAwMDRWYWxpZEJpenVtS2V5
MjRQb3MwMDA1VmFsaWRCaXp1bUtleUlu
UG9zMDAwNlZhbGlkQml6dW1LZXlJbjI0
MDAwN1ZhbGlkQml6dW1LZXlJbjI0UG9z - Cliquez sur Mettre à jour Bizum pour confirmer.
Activer les tests de bout en bout dans le compte de test
Cela vous permet d'envoyer des demandes de transaction à notre environnement de test. Notre plateforme envoie vos demandes à l'environnement de test Bizum pour traiter vos transactions. Ces transactions n'ont pas d'impact financier.
Ce mode nécessite que vous ayez un contrat d'acquisition signé avec Bizum, car vous devez renseigner des données d'acquisition en production.
Suivez ces étapes :
- Connectez-vous à votre compte de test dans le Merchant Portal. Allez à Entreprise > Moyens de paiement > Bizum.
- Dans direct.MerchantPortal.BusinessTab.PaymentMethodsSubTab.ActivateBizum, remplissez les propriétés suivantes :
Propriété Description/Actions ID Bizum (FUC) Entrez l'Identifiant Unique à 8 chiffres que vous avez reçu de Bizum. ID Terminal Entrez le Terminal ID à 3 chiffres que vous avez reçu de Bizum. Clé secrète Entrez la Clé Secrète SHA-256 que vous avez reçue de Bizum. - Cliquez sur Mettre à jour Bizum pour confirmer.
Activer en production pour le traitement de transactions réelles
Cela vous permet d'envoyer des demandes de transaction à notre environnement en production. Notre plateforme envoie vos demandes à l'environnement de production Bizum pour traiter vos transactions. Ces transactions ont un impact financier.
Ce mode nécessite que vous ayez un contrat d'acquisition signé avec Bizum, car vous devez entrer des données d'acquisition en production.
Suivez ces étapes :
- Connectez-vous à votre compte en production dans le Merchant Portal.
- Allez à Entreprise > Moyens de paiement > Bizum.
- Dans direct.MerchantPortal.BusinessTab.PaymentMethodsSubTab.ActivateBizum, remplissez les propriétés suivantes :
Propriété Description/Actions ID Bizum (FUC) Entrez l'Identifiant Unique à 8 chiffres que vous avez reçu de Bizum. ID Terminal Entrez le Terminal ID à 3 chiffres que vous avez reçu de Bizum. Clé secrète Entrez la Clé Secrète SHA-256 que vous avez reçue de Bizum. - Cliquez sur Mettre à jour Bizum pour confirmer.