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.
Activation
Pour utiliser Wero dans notre environnement de production, signez un contrat avec Wero.
Nous serons ravis de vous aider à commencer.
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: Le montant brut que vous souhaitez facturer pour cette commande. |
references | 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: 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.
|
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
- Vos clients finalisent une commande sur leur appareil de bureau dans votre boutique et sélectionnent Wero.
- Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme.
- 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.
- Vos clients scannent le QR code affiché avec leur appareil mobile/tablette.
- L'appareil mobile/tablette ouvre l'application Wero/l'application bancaire prenant en charge Wero. Vos clients confirment le paiement dans l'application.
- Nous recevons le résultat de la transaction.
- L'appareil mobile/tablette affiche le résultat de la transaction dans l'application Wero/l'application bancaire prenant en charge Wero.
- Nous redirigeons vos clients vers votre returnUrl sur leur appareil de bureau.
- Vous récuperez le résultat de la transaction à notre plateforme via une requête GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
- Si la transaction a été réussie, vous pouvez livrer les marchandises / services.
Avec un appareil mobile
- Vos clients finalisent une commande sur leur appareil mobile dans votre boutique et sélectionnent Wero.
- Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme.
- 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.
- Vos clients confirment le paiement dans l'application.
- Nous recevons le résultat de la transaction.
- L'appareil mobile/tablette affiche le résultat de la transaction dans l'application Wero/l'application bancaire prenant en charge Wero.
- Vous récuperez le résultat de la transaction à notre plateforme via une requête GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
- 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 | 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. | La raison du remboursement. Valeurs possibles :
|