worldline Direct
S'inscrire

Wero

Introduction

Wero est une méthode de paiement bancaire en temps réel développée par le consortium de l'Initiative Européenne de Paiement (EPI), remplaçant Giropay et bientôt Payconiq et iDEAL.

Wero est lié à un compte bancaire plutôt qu'à une carte physique. Grâce au réseau toujours croissant de banques participantes, Wero couvre 80 % des titulaires de comptes bancaires dans les pays ciblés. Bien que Wero propose sa propre application, toute application bancaire de n'importe quelle banque participante prend en charge Wero.

Vous envoyez une requête standard à notre plateforme pour rediriger vos clients vers le portail Wero afin d'ouvrir l'application bancaire.

L'intégration est très facile, car vous n'avez besoin d'envoyer que quelques propriétés supplémentaires avec votre requête.

Aperçu

Groupe de paiement :
Identifiant du moyen de paiement:
900
Avantages clés
  • Intégration facile
  • Large réseau de banques participantes
  • Banque en temps réel
  • Permet
    les autorisations/ventes directes/
    annulations partielles/multiples/complètes
    remboursements partiels/multiples/complètes

Activation

Pour utiliser Wero dans notre environnement de production, signez un contrat avec Wero.

Nous serons ravis de vous aider à commencer.

Pays & devises

Pays pris en charge

Devises prises en charge

  • Euro (EUR)

Intégration

Redirigez vos clients vers l'application Wero/l'application bancaire prenant en charge Wero via les modes d'intégration Hosted Checkout Page ou Server-to-server. Vous trouverez une vue d'ensemble dans le chapitre "Cinématique".

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

{
   "order":{
      "amountOfMoney":{
      "currencyCode":"EUR",
      "amount":100
   },
  "references": {
      "merchantReference": "Your Order ID"		
      "descriptor": "YourCompanyName"
      }
   },
   "redirectPaymentMethodSpecificInput":{
      "paymentProductId":900,
      "requiresApproval": true,
      "paymentProduct900SpecificInput": {
         "captureTrigger": "Shipping",
         }
   },
}
Propriétés Description

order.amountOfMoney
    amount
    currencyCode

amount: Le montant brut que vous souhaitez facturer pour cette commande.
currencyCode: Le code de devise ISO 4217 pour ce montant.

references
     merchantReference
     descriptor

merchantReference: Votre référence unique pour cette commande. Si omis, notre plateforme générera une référence aléatoire.

descriptor: Un descripteur dynamique apparaissant sur le relevé bancaire de vos clients. Si omis, notre plateforme générera un descripteur aléatoire.  Cette valeur sera également réutilisée pour les demandes de remboursement. 

redirectPaymentMethodSpecificInput
     paymentProductId
     requiresApproval
     paymentProduct900SpecificInput.captureTrigger

paymentProductId: L'identifiant numérique de la méthode de paiement sur notre plateforme. Trouvez cet id dans le chapitre "Aperçu". Pour les paiements demandés via CreateHostedCheckout, il indique à notre plateforme d'envoyer directement vos clients vers le portail Wero. Si omis, notre plateforme envoie vos clients vers le Hosted Checkout Page à la place, leur permettant de choisir cette méthode de paiement ou toute autre méthode qui est active sur votre compte.

requiresApproval: Définissez sur "true"/"false" selon que vous souhaitez traiter les paiements en mode autorisation/vente directe.

Si vous choisissez "true", assurez-vous de :

captureTrigger: Obligatoire uniquement pour les requêtes en mode autorisation.
Affichez à vos clients dans le portail Wero quand vous allez capturer la transaction. Valeurs possibles : 

  • shipping: Lors de l'expédition de la commande. 
  • delivery: Lors de la livraison de la commande. 
  • availability: Dès que la commande est disponible. 
  • serviceFulfilment: Lors de la réalisation du service. 
  • other: Pour tout autre cas d'utilisation.

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

Cinématique

En fonction du/des appareil(s) utilisés par vos clients, des différences s'appliquent :

Avec un ordinateur de bureau et un appareil mobile

  1. Vos clients finalisent une commande sur leur appareil de bureau dans votre boutique et sélectionnent Wero.
  2. Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme.
  3. Vous redirigez vos clients sur l'appareil de bureau via le redirectUrl (Pour les requêtes CreateHostedCheckout) ou merchantAction.redirectData.redirectUrl (Pour les requêtes CreatePayment) vers le portail Wero.
  4. Vos clients scannent le QR code affiché avec leur appareil mobile/tablette.
  5. L'appareil mobile/tablette ouvre l'application Wero/l'application bancaire prenant en charge Wero. Vos clients confirment le paiement dans l'application.
  6. Nous recevons le résultat de la transaction.
  7. L'appareil mobile/tablette affiche le résultat de la transaction dans l'application Wero/l'application bancaire prenant en charge Wero.
  8. Nous redirigeons vos clients vers votre returnUrl sur leur appareil de bureau.
  9. Vous récuperez le résultat de la transaction à notre plateforme via une requête GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
  10. Si la transaction a été réussie, vous pouvez livrer les marchandises / services.

    Avec un appareil mobile

    1. Vos clients finalisent une commande sur leur appareil mobile dans votre boutique et sélectionnent Wero.
    2. Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme.
    3. Vous redirigez vos clients via le redirectUrl (Pour les requêtes CreateHostedCheckout) ou merchantAction.redirectData.redirectUrl (Pour les requêtes CreatePayment) vers le portail Wero.
    4. Vos clients confirment le paiement dans l'application.
    5. Nous recevons le résultat de la transaction.
    6. L'appareil mobile/tablette affiche le résultat de la transaction dans l'application Wero/l'application bancaire prenant en charge Wero.
    7. Vous récuperez le résultat de la transaction à notre plateforme via une requête GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
    8. Si la transaction a été réussie, vous pouvez livrer les marchandises / 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

    Rembourser les paiements

    Lors du traitement des remboursements, assurez-vous d'ajouter la propriété refundReason à votre requête : 

    {
       "amountOfMoney":{
           "amount":200,
           "currencyCode":"EUR"
       },
       "references": { 
    		"merchantReference": "Your-refund-reference" 
    		} 
    	},
       "refundRedirectPaymentMethodSpecificInput":{
           "refundRedirectPaymentProduct900SpecificInput":{
               "refundReason":"WrongAmountCorrection"
            }
        }
    }
    Propriétés Description

    order.amountOfMoney
        amount
        currencyCode

    Le montant brut que vous souhaitez rembourser pour l'autorisation initiale.

    references.merchantReference

    Votre référence unique pour ce remboursement. Si omis, notre plateforme enverra celle de la requête CreateHostedCheckout/CreatePayment originale.

    refundRedirectMethodSpecificInput.
    refundRedirectPaymentProduct900SpecificInput.
    refundReason

     

    La raison du remboursement. Valeurs possibles : 

    • returnedGoods
    • preDisputeRefund
    • subscriptionRefund
    • serviceLateCancellation
    • others

    Cette page vous a-t-elle été utile ?

    Avez-vous des commentaires ?

    Merci pour votre réponse.
    New Feature

    Try out our new chatbot and find answers to all your questions.