Accepter un paiement EPS
Découvrez comment accepter les paiements effectués à l'aide de EPS, un moyen de paiement très répandu en Autriche.
Mise en garde
Le contenu de cette section fait référence à un produit antérieur. Vous devez plutôt consulter le guide relatif à l’acceptation d’un paiement pour en savoir plus sur le chemin d’intégration le plus récent. Stripe prend toujours en charge ce produit, néanmoins cette prise en charge peut prendre fin si le produit devient obsolète.
EPS est un moyen de paiement à usage unique qui nécessite l’authentification du paiement par le client. Pour effectuer un paiement avec EPS, les clients quittent votre site Web, autorisent le paiement, puis reviennent vers votre site Web. Vous recevez alors une notification immédiate indiquant si le paiement a abouti ou échoué.
Remarque
Votre utilisation d’EPS doit se conformer aux Conditions d’utilisation du service EPS.
Configurer StripeCôté serveur
Pour commencer, il vous faut un compte Stripe. Créez votre compte Stripe.
Utilisez nos bibliothèques officielles pour accéder à l’API Stripe à partir de votre application :
Créer un PaymentIntentCôté serveur
Un PaymentIntent représente votre intention d’encaisser un paiement auprès d’un client et suit le cycle de vie du processus de paiement.
Créez un PaymentIntent
sur votre serveur et précisez le montant à encaisser ainsi que la devise dans les paramètres amount
et eur
(EPS ne prend en charge aucune autre devise). Si vous avez déjà une intégration Payment Intents, ajoutez eps
à la liste des types de moyens de paiement.
Récupérer la clé secrète du client
Le PaymentIntent contient une clé secrète à utiliser côté client pour finaliser le processus de paiement en toute sécurité. Vous pouvez adopter différentes approches pour transmettre cette clé secrète côté client.
Recueillir les informations du moyen de paiementCôté client
Vous êtes prêt à collecter les informations de paiement sur le client avec Stripe Elements. Elements est un ensemble de composants d’interface utilisateur prédéfinis pour la collecte des informations de paiement.
Un composant Element contient une balise iframe qui envoie de manière sécurisée les informations de paiement à Stripe par une connexion HTTPS. Pour que votre intégration fonctionne, l’adresse de votre page de règlement doit aussi commencer par https:// au lieu de http://.
Vous pouvez tester votre intégration sans utiliser le protocole HTTPS. Activez-le au moment d’accepter des paiements en mode production.
Configurer Stripe Elements
Envoyer le paiement à StripeCôté client
Plutôt que d’envoyer la totalité de l’objet PaymentIntent au client, utilisez sa clé secrète. Cette clé est distincte de vos clés API qui authentifient les requêtes envoyées à l’API Stripe. La clé secrète du client doit être utilisée avec prudence, car elle peut servir à finaliser le paiement. Elle ne doit être ni enregistrée, ni intégrée dans des URL, ni dévoilée à d’autres personnes que votre client.
Lorsque votre client effectue un paiement, Stripe le redirige vers l’URL return_
et inclut les paramètres de requête d’URL suivants. La page de redirection peut utiliser ces paramètres pour récupérer l’état du PaymentIntent et ainsi afficher l’état du paiement pour le client.
Lorsque vous spécifiez une URL return_
, vous pouvez également ajouter vos propres paramètres de requête à utiliser sur la page de redirection.
Paramètre | Description |
---|---|
payment_ | Identifiant unique du PaymentIntent . |
payment_ | La clé secrète du client de l’objet PaymentIntent . Pour les intégrations d’abonnements, le client_secret est également exposé sur l’objet Invoice via confirmation_ |
Lorsque le client est redirigé vers votre site, vous pouvez utiliser le payment_
pour interroger le PaymentIntent et communiquer l’état de la transaction à votre client.
Vous trouverez des informations sur le compte bancaire utilisé par le client en consultant la propriété payment_method_details du paiement.
{ "charges": { "data": [ { "payment_method_details": { "eps": { "bank": "bank_austria", "verified_name": "JENNY ROSEN" }, "type": "eps" }, "id": "src_16xhynE8WzK49JbAs9M21jaR", "object": "source", "amount": 1099, "client_secret": "src_client_secret_UfwvW2WHpZ0s3QEn9g5x7waU",
Tester votre intégration
À l’aide de vos clés API de test, sélectionnez une banque dans la liste des banques compatibles avec EPS. Après avoir confirmé le paiement, vous serez redirigé vers une page de test proposant deux options : réussite ou échec du paiement. Vous pouvez tester la réussite de paiement en l’authentifiant sur la page de redirection. Le PaymentIntent passera alors de l’état requires_
à succeeded
.
Pour tester un échec d’authentification de l’utilisateur, sélectionnez une banque à l’aide de vos clés API de test. Puis, sur la page de redirection, cliquez sur Échec du paiement test. Votre PaymentIntent passera alors de l’état requires_
à requires_
.
Valeurs bancaires
Nom de la banque | Valeur |
---|---|
Ärzte- und Apothekerbank | arzte_und_apotheker_bank |
Austrian Anadi Bank AG | austrian_anadi_bank_ag |
Bank Austria | bank_austria |
Bankhaus Carl Spängler & Co.AG | bankhaus_carl_spangler |
Bankhaus Schelhammer & Schattera AG | bankhaus_schelhammer_und_schattera_ag |
BAWAG P.S.K. AG | bawag_psk_ag |
BKS Bank AG | bks_bank_ag |
Brüll Kallmus Bank AG | brull_kallmus_bank_ag |
BTV VIER LÄNDER BANK | btv_vier_lander_bank |
Capital Bank Grawe Gruppe AG | capital_bank_grawe_gruppe_ag |
Dolomitenbank | dolomitenbank |
Easybank AG | easybank_ag |
Erste Bank und Sparkassen | erste_bank_und_sparkassen |
Hypo Alpe-Adria-Bank International AG | hypo_alpeadriabank_international_ag |
HYPO NOE LB für Niederösterreich u. Wien | hypo_noe_lb_fur_niederosterreich_u_wien |
HYPO Oberösterreich, Salzburg, Steiermark | hypo_oberosterreich_salzburg_steiermark |
Hypo Tirol Bank AG | hypo_tirol_bank_ag |
Hypo Vorarlberg Bank AG | hypo_vorarlberg_bank_ag |
HYPO-BANK BURGENLAND Aktiengesellschaft | hypo_bank_burgenland_aktiengesellschaft |
Marchfelder Bank | marchfelder_bank |
Oberbank AG | oberbank_ag |
Raiffeisen Bankengruppe Österreich | raiffeisen_bankengruppe_osterreich |
Schoellerbank AG | schoellerbank_ag |
Sparda-Bank Wien | sparda_bank_wien |
Volksbank Gruppe | volksbank_gruppe |
Volkskreditbank AG | volkskreditbank_ag |
VR-Bank Braunau | vr_bank_braunau |