How Manual Payment Capture Works in Production: Buffers, Splits, and Hold Limits
Manual payment capture in production involves authorizing an estimated amount and capturing the final amount later, with the gap between the two being a common source of bugs. Developers are advised to authorize a buffered amount above the estimate to absorb minor variances and avoid triggering a second payment step at fulfillment. When store credit and card payments are split, the card portion must meet Stripe's per-currency minimum or the transaction fails, so the split should be rebalanced before the API call is made. On capture day, three outcomes are possible: void if no card charge is needed, partial or full capture if the final amount is within the authorized limit, or a fallback flow if the final total exceeds the buffer. Card authorization holds expire automatically after roughly seven days, making timely capture essential to avoid failed settlements.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.
Discussion (0)
Log in to join the discussion and vote.
Log in