Mises à jour de l'état des paiements

Les PaymentIntents sont mis à jour en fonction des actions effectuées par vos clients ou par les moyens de paiement. Votre intégration peut examiner un PaymentIntent pour déterminer l’état du processus de paiement et ainsi vous permettre d’entreprendre les actions commerciales appropriées ou de répondre aux états nécessitant une intervention supplémentaire.

Vous pouvez aussi utiliser le Dashboard Stripe pour configurer votre compte afin de recevoir des courriels lors des changements d’état des paiements, par exemple à la réussite d’un paiement. Modifiez vos notifications par courriel dans les paramètres de l’utilisateur.

Vérifier l’état du PaymentIntent côté client

Lorsqu’un paiement est effectué côté client avec la fonction confirmCardPayment, vous pouvez examiner le PaymentIntent renvoyé pour déterminer son état actuel :

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

Voici les résultats possibles lorsque la fonction confirmCardPayment est utilisée :

La promesse renvoyée par confirmCardPayment aboutit lorsque le processus de paiement réussit ou échoue en renvoyant une erreur. Si le paiement réussit et renvoie un PaymentIntent, son état est toujours succeeded (ou requires_capture en cas de capture ultérieure). Lorsque le paiement nécessite une étape supplémentaire, par exemple une authentification, la promesse n’aboutit qu’une fois que cette étape est effectuée ou après expiration du délai.

Vérifier l’état du PaymentIntent côté client sans utiliser confirmCardPayment

Pour vérifier l’état d’un PaymentIntent sans utiliser la fonction confirmCardPayment, récupérez-le séparément à l’aide de la fonction retrievePaymentIntent en transmettant la clé secrète du client.

Voici quelques états possibles d’un PaymentIntent après confirmation :

En savoir plus sur les états des Paymentintents.

(async () => {
  const {paymentIntent} = await stripe.retrievePaymentIntent(clientSecret);
  if (paymentIntent && paymentIntent.status === 'succeeded') {
    // Handle successful payment here
  } else {
    // Handle unsuccessful, processing, or canceled payments and API errors here
  }
})();

Suivre un PaymentIntent avec des webhooks

Stripe peut envoyer des événements webhook à votre serveur pour vous informer du changement d’état d’un PaymentIntent, ce qui est notamment utile pour déterminer quand fournir les biens ou les services.

Ne tentez pas de gérer le traitement d’une commande côté client, car vos clients peuvent quitter la page après la finalisation du règlement, mais avant le début du processus de traitement de la commande. Utilisez donc plutôt des webhooks pour surveiller l’événement payment_intent.succeeded et gérer son exécution de manière asynchrone au lieu de tenter de traiter la commande côté client.

Pour gérer un événement webhook, ajoutez un chemin sur votre serveur et configurez un point de terminaison d’un webhook correspondant dans le Dashboard. Stripe envoie l’événement payment_intent.succeeded lorsque le paiement réussit et l’événement payment_intent.payment_failed lorsque le paiement échoue.

La charge utile du webhook inclut l’objet PaymentIntent. L’exemple suivant montre comment gérer les deux événements :

require 'sinatra'
require 'stripe'

post '/webhook' do
    payload = request.body.read
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    event = nil

    begin
        event = Stripe::Webhook.construct_event(
            payload, sig_header, endpoint_secret
        )
    rescue JSON::ParserError => e
        # Invalid payload
        status 400
        return
    rescue Stripe::SignatureVerificationError => e
        # Invalid signature
        status 400
        return
    end

    case event['type']
    when 'payment_intent.succeeded'
        intent = event['data']['object']
        puts "Succeeded:", intent['id']
        # Fulfill the customer's purchase
    when 'payment_intent.payment_failed'
        intent = event['data']['object']
        error_message = intent['last_payment_error'] && intent['last_payment_error']['message']
        puts "Failed:", intent['id'], error_message
        # Notify the customer that payment failed
    end

    status 200
end

Lorsque le paiement échoue, vous pouvez trouver des informations en examinant la propriété last_payment_error du PaymentIntent. Vous pouvez informer votre client de l’échec du paiement et l’inviter à réessayer avec un autre moyen de paiement. Réutilisez ensuite le même PaymentIntent pour continuer à suivre l’achat de votre client.

Gérer des événements de webhook spécifiques

La liste suivante décrit comment gérer différents événements de webhook :

Pour tester des webhooks localement, vous pouvez utiliser l’interface de ligne de commande Stripe. Après l’avoir installée, vous pouvez transférer les événements à votre serveur :

stripe listen --forward-to localhost:4242/webhook
Ready! Your webhook signing secret is '{{WEBHOOK_SIGNING_SECRET}}' (^C to quit)

En savoir plus sur la configuration des webhooks.

Identifier les paiements d’un PaymentIntent

Lorsque vous tentez d’encaisser le paiement d’un client, le PaymentIntent crée un API Charge. Pour accéder à l’identifiant du dernier paiement, inspectez la propriété latest_charge du PaymentIntent :

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

intent = Stripe::PaymentIntent.retrieve('{{PAYMENT_INTENT_ID}}')
latest_charge = intent.latest_charge

Pour voir tous les paiements associés à un PaymentIntent, y compris ceux qui n’ont pas abouti, affichez la liste de tous les paiements et spécifiez le paramètre payment_intent​.

curl -G https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent=
{{PAYMENT_INTENT_ID}}

Gérer les actions suivantes

Certains moyens de paiement nécessitent des actions supplémentaires, comme l’authentification, pour finaliser le processus de paiement. Stripe.js les gère automatiquement lors de la confirmation du PaymentIntent, mais si vous disposez d’une intégration avancée, il peut s’avérer préférable de les gérer manuellement.

La propriété next_action du PaymentIntent indique l’étape suivante à effectuer par votre intégration pour finaliser le paiement. Le type d’actions suivantes possibles peut varier selon le moyen de paiement. Vous trouverez une liste complète des actions suivantes possibles dans la documentation relative à l’API.

Pour en savoir plus sur la gestion des actions suivantes requises par différents moyens de paiement, consultez la documentation relative aux moyens de paiement.