Accepter un paiement Sofort

Découvrez comment accepter les paiements effectués à l'aide de Sofort, un moyen de paiement très répandu en Europe.

Avertissement

New businesses can’t accept SOFORT payments and our financial partners are in the process of discontinuing SOFORT. For more information, read our support page.

Web

Mobile

Sofort est un moyen de paiement à usage unique et à notification différée avec lequel le client doit authentifier son paiement. Le client paie avec Sofort en étant redirigé depuis votre site Web vers le portail de sa banque afin d’authentifier le paiement. Le client reçoit généralement la notification d’échec ou de réussite sous 2 à 14 jours.

Remarque

Pour accepter Sofort, vous devez respecter les Conditions d’utilisation du service Sofort.

Configurer Stripe
Cô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 PaymentIntent
Côté serveur

Un PaymentIntent est un objet qui représente votre intention d’encaisser un paiement auprès de votre client et suit le cycle de vie du processus de paiement. Créez un PaymentIntent sur votre serveur et précisez le amount à encaisser ainsi que la devise eur (Sofort ne prend pas en charge d’autres devises). Si vous avez une intégration Payment Intents existante, ajoutez sofort à la liste des types de moyens de paiement.

Modification de la langue préférée

Par défaut, Stripe affiche la page d’autorisation de Sofort dans la langue correspondant au code pays spécifié. Vous pouvez remplacer cette langue par la langue préférée de votre client en précisant ce choix dans la requête et en modifiant la valeur de la propriété preferred_language. Les valeurs prises en charge sont de, en, es, it, fr, nl et pl.

Au lieu de transmettre à l’application la totalité de l’objet PaymentIntent, renvoyez sa clé secrète du client. Il s’agit d’une clé unique qui vous permet de confirmer le paiement et d’actualiser les informations de paiement côté client, le tout sans autoriser la manipulation d’informations sensibles comme le montant du paiement.

Envoyer le paiement à Stripe
Côté client

Pour finaliser un paiement côté client, transmettez à l’application de votre client la clé secrète du client du PaymentIntent.

Lorsqu’un client clique pour payer avec Sofort, utilisez Stripe.js pour soumettre le paiement à Stripe. Stripe.js est la bibliothèque JavaScript de base pour créer les tunnels de paiement : elle gère automatiquement les opérations complexes telles que la redirection décrite ci-dessous, et facilite l’extension de votre intégration à d’autres moyens de paiement. Incluez le script Stripe.js sur votre page de paiement en l’ajoutant à la section head de votre fichier HTML.

checkout.html
<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/v3/"></script>
</head>

Créez une instance de Stripe.js avec le code JavaScript suivant sur votre page de paiement.

client.js
// Set your publishable key. Remember to change this to your live publishable key in production!
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx'
);

Utilisez stripe.confirmSofortPayment pour exécuter la redirection vers la banque et effectuer le paiement. Ajoutez une return_url à cette fonction pour indiquer à Stripe vers quelle page rediriger l’utilisateur une fois le paiement effectué sur le site Web ou l’application mobile de Sofort.

client.js
// Redirects away from the client
const {error} = await stripe.confirmSofortPayment(
  '{{PAYMENT_INTENT_CLIENT_SECRET}}',
  {
    payment_method: {
      sofort: {
        country: "DE"
      }
    },
    return_url: 'https://example.com/checkout/complete',
  }
);

Effectuer la redirection

Les paramètres de requête d’URL suivants sont fournis lorsque Stripe redirige le client vers l’URL return_url.

Paramètre	Description
`payment_intent`	L’identifiant unique du `PaymentIntent`.
`payment_intent_client_secret`	La clé secrète du client de l’objet `PaymentIntent`.

Vous pouvez également ajouter vos propres paramètres de requête lorsque vous fournissez l’url de retour return_url. Ceux-ci resteront activés pendant toute la durée du processus de redirection. Le paramètre return_url doit correspondre à une page de votre site Web sur laquelle l’état du paiement est fourni. Vous devez vérifier l’état du PaymentIntent lors de l’affichage de la page de retour. Vous pouvez le faire en utilisant la fonction retrievePaymentIntent de Stripe.js et en transmettant payment_intent_client_secret.

(async () => {
  const url = new URL(window.location);
  const clientSecret = url.searchParams.get('payment_intent_client_secret');

  const {paymentIntent, error} = await stripe.retrievePaymentIntent(clientSecret);
  if (error) {
    // Handle error
  } else if (paymentIntent && paymentIntent.status === 'succeeded') {
    // Handle successful payment
  }
})();

Vous pouvez consulter les informations concernant le compte bancaire qu’utilise le client pour effectuer le paiement sous payment_method_details.

"payment_method_details": {
  "sofort": {
    "bank_code": "VAPE",
    "bank_name": "VAN DE PUT & CO",
    "bics": "VAPEBE22",
    "country": "DE",
    "iban_last4": "7061",
    "preferred_language": "en",
    "verified_name": "Jenny Rosen",
  },
  "type": "sofort"
}

Tester le processus de redirection

Lors de la création d’un objet PaymentIntent à l’aide de vos clés API de test, vous serez redirigé(e) vers une page Stripe qui affiche des informations sur la requête à l’API et vous permet d’autoriser ou d’annuler le paiement. L’autorisation du paiement vous redirige vers l’URL précisée dans le champ return_url.

Gérer les événements post-paiement

Sofort étant un moyen de paiement à notification différée, l’état du PaymentIntent demeure à l’état de traitement, payment_intent.processing, jusqu’à 14 jours après sa création (également dénommée la « date limite »). En mode test, l’état du PaymentIntent restera à l’état de traitement pendant trois minutes afin de simuler ce processus.

Stripe recommande d’exécuter les achats pendant l’état de traitement. En moyenne, vous pouvez vous attendre à ce que 0,2 % des tentatives de paiement Sofort échouent après avoir atteint l’état de traitement. Cette recommandation s’applique uniquement aux paiements Sofort en raison de son faible taux d’échec et ne s’applique pas aux autres moyens de paiement avec notification différée.
Vous préférez peut-être n’exécuter les commandes qu’après avoir reçu l’événement payment_intent.succeeded. Stripe envoie cet événement après que la tentative de paiement a été confirmée et que les fonds sont garantis.
Si un client n’effectue pas le paiement, Stripe envoie l’événement payment_intent.failed et le PaymentIntent repasse à l’état requires_payment_method.

Utilisez le Dashboard, un webhook personnalisé ou une solution partenaire pour recevoir ces événements et exécuter des actions, comme envoyer une confirmation de commande par e-mail à votre client, enregistrer la vente dans une base de données ou lancer un workflow de livraison.

Manuellement

Utilisez le Dashboard Stripe pour consulter tous vos paiements Stripe, envoyer des reçus par e-mail, gérer les virements et réessayer d’effectuer les paiements ayant échoué.

Afficher vos paiements tests dans le Dashboard

Code personnalisé

Créez un gestionnaire de webhooks pour écouter des événements et créer des tunnels de paiement asynchrones personnalisés. Testez et déboguez votre intégration de webhooks en local, grâce à l’interface de ligne de commande Stripe.

Créer un webhook personnalisé

Applications préconfigurées

Intégrez une application partenaire pour gérer les événements métier courants, comme l’automatisation, le marketing ou les ventes.

FacultatifGérer la redirection de Sofort manuellement

Paiements contestés

Le risque de fraude ou de paiements non reconnus est faible, car le client doit authentifier son paiement auprès de sa banque. Par conséquent, vous n’aurez pas à gérer de litiges qui se transforment en contestations de paiement avec retrait des fonds de votre compte Stripe.

Tentatives ayant échoué

Si une tentative de paiement n’a pas été confirmée dans le temps imparti, l’état de l’objet PaymentIntent bascule automatiquement de processing à requires_payment_method. De plus si les fonds sont reçus après la date limite, le client reçoit automatiquement un remboursement.

En moyenne, environ 0,2 % des tentatives de paiement Sofort échouent. Ce chiffre varie en fonction de votre secteur ou de votre base de clients. En fonction du montant moyen de paiement que vous enregistrez, du type de produits ou de services que vous offrez et du risque associé à votre activité, il peut être plus judicieux de traiter les commandes uniquement après avoir reçu l’événement payment_intent.succeeded.

Remboursements

Sofort accepte uniquement les demandes de remboursement dans les 180 jours suivant la date du débit initial. Passé ce délai, le remboursement du paiement n’est plus possible.

Vous pouvez soumettre un remboursement pour les paiements en attente qui n’ont pas encore été confirmés. Si vous créez un remboursement partiel ou complet pour un PaymentIntent dont l’état est processing, le remboursement est exécuté uniquement une fois que l’état a basculé sur succeeded. Si l’état du PaymentIntent est requires_payment_method après l’échec d’une tentative de paiement, les remboursements partiels et complets sont marqués comme annulés, puisque les fonds n’ont jamais quitté le compte bancaire du client.