Bank Transfer by Worldline

Introduction
En phase piloteBank Transfer par Worldline est un système bancaire en ligne européen, permettant à vos clients de transférer des fonds directement de leurs comptes bancaires vers le vôtre via le schéma de virement SEPA (SCT).
Contrairement à d'autres systèmes (locaux) de paiement en ligne (par exemple iDEAL/Przelewy24), le virement bancaire par Worldline est une solution paneuropéenne. Avec un réseau en constante croissance, il couvre actuellement :
- 2500 banques émettrices
- 14 pays européens
- Quatre devises
Ainsi, Bank Transfer par Worldline est un moyen de paiement très accessible pour vos clients partout en Europe. En tant que Service d'initiation de paiement (PIS) licencié, vous pouvez choisir d'offrir à vos clients des transferts standards ou instantanés, vous permettant de recevoir vos fonds respectivement sous 2 jours ouvrables ou en temps réel.
Vous redirigez vos clients vers leur banque en ligne où ils se connectent à leur compte bancaire en ligne. Ils authentifient le virement bancaire pour lequel vous recevez un résultat immédiat (pour les virements instantanés) / intermédiaire (pour les virements standards).
L'intégration est très facile, car vous n'avez qu'un seul paramètre à envoyer avec votre demande.
Bank Transfer par Worldline est sous licence de Worldline Financial Services (Europe) S.A. régulé au Luxembourg conformément à la 2ème Directive Européenne sur les Services de Paiement (PSD2).
Avantages clés
- Exigences PCI faibles (aucune donnée sensible ou personnelle partagée)
- Système bancaire en ligne paneuropéen de plus en plus populaire
- Permet de recevoir des fonds en temps réel (via le mode de transfert instantané)
- Cycle de règlement rapide/rapprochement en temps réel
- Permet des remboursements partiels/multiples/intégrals
- Tarification des transactions sans interchange
Activation
Pour utiliser Bank Transfer par Worldline dans notre environnement de production, signez un contrat avec Worldline Financial Services (Europe) S.A. Nous serons ravis de vous aider à démarrer.
Intégration
Nous proposons ces méthodes de paiement pour les modes d'intégration suivants. Découvrez leurs différences dans nos guides dédiés:
Vous trouverez un aperçu général dans le chapitre "Cinématique".
Hosted Checkout Page/Server-to-server
Ajoutez les propriétés suivantes à une demande standard de CreateHostedCheckout/CreatePayment :
{
"order":{
"amountOfMoney":{
"currencyCode":"EUR",
"amount":150
},
"references":{
"descriptor":"MerchantDescriptor"
}
},
"redirectPaymentMethodSpecificInput":{
"paymentProductId":5408,
"redirectionData":{
"returnUrl":"https://yourReturnUrl.com"
}
},
"paymentProduct5408SpecificInput":{
"instantPaymentOnly":true
}
}
Propriétés | Remarques |
---|---|
order.amountOfMoney |
amount : Le montant brut que vous souhaitez facturer pour cette commande. |
order.references.descriptor |
Un descripteur dynamique apparaissant sur le relevé bancaire de vos clients. Bien que non obligatoire, nous recommandons vivement de l'ajouter à votre commande pour une transparence maximale. |
redirectPaymentMethodSpecificInput |
paymentProductId : L'identifiant numérique de la méthode de paiement sur notre plateforme. Vous trouverez cet identifiant dans le chapitre "Aperçu". Pour les paiements demandés via CreateHostedCheckout, cela indique à notre plateforme d'envoyer vos clients directement vers la page de sélection de la banque. Si omis, notre plateforme envoie vos clients vers la Hosted Checkout Page où ils peuvent 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 terminé. |
paymentProduct5408SpecificInput.instantPaymentOnly |
A définir si vous souhaitez traiter cette transaction comme un paiement instantané. |
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI/CreatePaymentAPI.
Cinématique
- Vos clients finalisent une commande dans votre boutique et sélectionnent Bank Transfer par Worldline.
- Vous envoyez cette demande CreateHostedCheckout/CreatePayment à notre plateforme.
- Vous redirigez vos clients via le redirectUrl (pour les demandes CreateHostedCheckout) ou merchantAction.redirectData.redirectURL (pour les demandes CreatePayment) vers la page de sélection de la banque. Ils sélectionnent leur banque, se connectent à leur compte bancaire en ligne et confirment le paiement.
- Nous envoyons la transaction pour traitement et recevons le résultat de transaction intermédiaire (statusOutput.statusCode=46) de l'émetteur.
- Nous redirigeons votre client vers votre returnUrl.
- Vous demandez le résultat de transaction intermédiaire (statusOutput.statusCode=46) à notre plateforme via GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
- Après quelques minutes, nous mettons à jour la transaction à statusOutput.statusCode=4.
- La banque émettrice de vos clients vous transfère les fonds soit par un transfert standard (sous 1 à 2 jours) soit par un transfert instantané (dans quelques minutes). Nous mettons à jour la transaction à statusOutput.statusCode=9.
- Vous demandez le résultat final de la transaction à notre plateforme via GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
- Si la transaction a réussie, vous pouvez livrer les biens/services.
- Vous pouvez choisir d'accepter uniquement les virements instantanés une fois que nous avons activé la méthode de paiement. Pour ce faire, définissez le drapeau "Flux de paiement instantané" dans le Merchant Portal via Entreprise > Bank Transfer par Worldline . Notez que toutes les banques émettrices n'offrent pas cette option et peuvent imposer des frais supplémentaires à vos clients. Cela pourrait réduire la disponibilité et l'attrait du virement bancaire par Worldline. Vous pouvez remplacer le paramètre Merchant Portal pour des transactions individuelles en incluant paymentProduct5408SpecificInput.instantPaymentOnly dans votre requête.
- Pour les flux de paiement infructueux dans le cas des transactions refusées, expirées ou abandonnées, vous
recevrez statusOutput.statusCode=2 comme résultat
final. Selon le mode de transfert, différentes périodes de notification s'appliquent :
Virements standards : Jusqu'à 96 heures
Virements instantanés : 20 minutes
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.