Manual/automatic capture using Stripe

This article will guide you on how to flexibly control the timing of payment capture in Stripe. You can either set up automatic capture or use manual capture so that the transaction is actually completed at a specific point in time or when specific conditions are met.

How to capture PaymentIntent

Stripe provides two main methods of capturing PaymentIntent: automatic capture and manual capture. By default, the authorization amount is automatically captured when a PaymentIntent is created. If you need more fine-grained control over capture timing, you can choose manual capture.

Implementation steps for manual capture

1. Create PaymentIntent and set capture_method to manual:

   When creating the PaymentIntent, set the capture_method parameter to manual. This will instruct Stripe to only pre-authorize the payment rather than capture it immediately. Pre-authorization is valid for up to 7 days.

    import stripe
   
   stripe.api_key = "YOUR_STRIPE_SECRET_KEY"
   
   payment_intent = stripe.PaymentIntent.create(
       amount=1000, # Amount in cents currency="usd",
       capture_method="manual",
       payment_method_types=["card"],
   )
   
   print(payment_intent.id)

   NOTE: Replace YOUR_STRIPE_SECRET_KEY with your Stripe Secret Key.

2. Capture PaymentIntent after scheduled time:

   Manually capture the PaymentIntent using the capture endpoint of the Stripe API. You can use the payment_intent.capture() method or the stripe.PaymentIntent.capture() method.

    import stripe
   import time
   
   stripe.api_key = "YOUR_STRIPE_SECRET_KEY"
   
   payment_intent_id = "YOUR_PAYMENT_INTENT_ID" # Replace with the actual PaymentIntent ID
   
   # Wait for 5 minutes time.sleep(300)
   
   try:
       payment_intent = stripe.PaymentIntent.capture(payment_intent_id)
       print("Payment captured successfully!")
       print(payment_intent)
   
   except stripe.error.StripeError as e:
       print(f"Error capturing payment: {e}")

   NOTE: Replace YOUR_STRIPE_SECRET_KEY with your Stripe Secret Key and YOUR_PAYMENT_INTENT_ID with your actual PaymentIntent ID. In the above code example, we use time.sleep(300) to simulate waiting for 5 minutes. In practical applications, you can adjust the waiting time as needed.

Things to note

• Validity period: Please note that pre-authorization is valid for up to 7 days. If payment is not captured within this period, the pre-authorization will expire.
• Partial capture: When capturing using the capture() method, only the pre-authorized amount can be captured in full. Stripe does not support partial capture. If you need a partial refund, you can use Stripe's refund feature.
• Error handling: When capturing PaymentIntent, be sure to perform error handling to deal with possible abnormal situations, such as insufficient balance, invalid card, etc.
• Time Zone Issues: When scheduling delayed capture, be aware of time zone issues to ensure payments are captured at the correct time.

Summarize

By setting capture_method to manual and combining it with capture endpoint, you can flexibly control the capture timing of Stripe PaymentIntent to meet the needs of various business scenarios. This approach is particularly useful in scenarios where payment needs to be captured with a delay, such as after an order has been shipped or after a service has been completed. Be sure to read the official Stripe documentation carefully and adjust and test it based on your specific needs.

The above is the detailed content of Manual/automatic capture using Stripe. For more information, please follow other related articles on the PHP Chinese website!