Vérifier les paiements non capturés

Par défaut, vous créez des paiements en une seule étape. Vous n’avez rien d’autre à faire pour envoyer des fonds sur votre compte bancaire. Stripe prend également en charge les paiements en deux étapes, souvent appelés autorisation et capture. Si votre intégration utilise cette méthode, l’approbation d’une vérification et la capture d’un paiement sont des actions distinctes.

Votre fenêtre de capture pour les paiements approuvés varie selon la marque de la carte bancaire, la possibilité d’une prolongation de la période de rétention, et le type de moyen de paiement.

Vérifier les paiements non capturés dans le Dashboard

Lorsque nous plaçons un paiement non capturé en vérification, le Dashboard de Stripe affiche un bouton Capture à côté des boutons permettant d’approuver ou d’annuler la vérification. Les paiements non capturés affichent un bouton Annuler au lieu d’un bouton Rembourser, car l’annulation d’un paiement non capturé libère l’autorisation sans créer d’objet Rembourser.

Utilisez l’API pour capturer automatiquement les paiements approuvés

Via l’API, vous pouvez configurer votre intégration pour :

• Capturer immédiatement les paiements non placés en review.
• Laisser les paiements placés en review non capturés
• Une fois que la vérification est approuvée, capturez le paiement.

Capturer immédiatement les paiements non placés en vérification

Définissez l’attribut capture_method dans votre requête API pour créer un paiement non capturé. Après une requête réussie, vérifiez l’attribut vérifier sur le PaymentIntent. S’il est vide, capturez le paiement.

# 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'

# Get the credit card details submitted by the form
# Create a PaymentIntent with manual capture
payment_intent = Stripe::PaymentIntent.create({
  amount: 1000,
  currency: 'usd',
  payment_method: '{{PAYMENT_METHOD_ID}}',
  description: 'Example charge',
  confirm: true,
  capture_method: 'manual',
})

# Check if the payment is in review. If not, capture it.
if !payment_intent.review
  payment_intent.capture
end

Capturez un paiement après l’approbation d’une vérification

À l’étape précédente, vous avez laissé des paiements en review et non capturés. Utilisez les webhooks pour capturer automatiquement ces paiements après approbation.

Configurez vos webhooks pour écouter l’événement review.closed. L’événement comprend l’objet Review, et son attribut reason indique si la révision a été approuvée ou clôturée pour une autre raison (par exemple, si le paiement a été remboursé).

// Review object included in review.closed event webhook.
{
  "id": "prv_08voh1589O8KAxCGPcIQpmkz",
  "object": "review",
  "payment_intent": "pi_1D0CsEITpIrAk4QYdrWDnbRS",
  "created": 1474379631,
  "livemode": false,
  "open": false,
  "reason": "approved"
}

Si reason est approved, capturez le paiement.

# 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'

post "/my/webhook/url" do
  event_json = JSON.parse(request.body.read)
  event = Stripe::Event.retrieve(event_json["id"])

  if event.type == 'review.closed'
    review = event.object
    if review.reason == 'approved'
      pi = Stripe::PaymentIntent.retrieve(review.payment_intent)
      pi.capture
    end
  end

  status 200
end