Accepter un paiement Sofort

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 application vers le portail de sa banque afin qu’il authentifie le paiement. Le client reçoit généralement la notification d’échec ou de réussite sous 2 à 14 jours.

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

yarn add @stripe/stripe-react-native

import { useState, useEffect } from 'react';
import { StripeProvider } from '@stripe/stripe-react-native';

function App() {
  const [publishableKey, setPublishableKey] = useState('');

  const fetchPublishableKey = async () => {
    const key = await fetchKey(); // fetch key from your server here
    setPublishableKey(key);
  };

  useEffect(() => {
    fetchPublishableKey();
  }, []);

  return (
    <StripeProvider
      publishableKey={publishableKey}
      merchantIdentifier="merchant.identifier" // required for Apple Pay
      urlScheme="your-url-scheme" // required for 3D Secure and bank redirects
    >
      {/* Your app code here */}
    </StripeProvider>
  );
}

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=sofort

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=sofort \
  -d "payment_method_options[sofort][preferred_language]"=de

const fetchPaymentIntentClientSecret = async () => {
  const response = await fetch(`${API_URL}/create-payment-intent`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      email,
      currency: 'eur',
      payment_method_types: ['sofort'],
    }),
  });
  const { clientSecret, error } = await response.json();

  return { clientSecret, error };
};

export default function SofortPaymentScreen() {
  const [email, setEmail] = useState();

  const handlePayPress = async () => {
    // ...
  };

  return (
    <Screen>
      <TextInput
        placeholder="E-mail"
        onChange={(value) => setEmail(value.nativeEvent.text)}
      />
    </Screen>
  );
}

export default function SofortPaymentScreen() {
  const [email, setEmail] = useState();

  const billingDetails: PaymentMethodCreateParams.BillingDetails = {
    name: 'John Doe',
  };

  const { error, paymentIntent } = await confirmPayment(clientSecret, {
    paymentMethodType: 'Sofort',
    paymentMethodData: {
      billingDetails,
      country: 'DE',
    }
  });

  if (error) {
    Alert.alert(`Error code: ${error.code}`, error.message);
  } else if (paymentIntent) {
    Alert.alert(
      'Success',
      `The payment was confirmed successfully! currency: ${paymentIntent.currency}`
    );
  }

  return (
    <Screen>
      <TextInput
        placeholder="E-mail"
        onChange={(value) => setEmail(value.nativeEvent.text)}
      />
    </Screen>
  );
}

Gérer les événements post-paiement

Sofort étant un moyen de paiement à notification différée, l’état du PaymentIntent demeure à l’état payment_intent.processing jusqu’à 14 jours après sa création (la « date limite »). En environnement de test, l’état du PaymentIntent reste indiqué comme en cours 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 à la CLI 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.

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.