Handle partial captures and overcaptures for variable-amount transactions

domain: payments-general · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create an authorization for the maximum expected amount (e.g., a product estimate plus a buffer for overages), keeping the capture separate from the authorization.
  2. When the final amount is known, submit a capture request for the actual amount; if less than the authorized amount, the remaining hold is released to the cardholder.
  3. For overcaptures (final amount exceeds the authorized amount), check whether your gateway and acquirer support overcapture and up to what percentage above the original authorization.
  4. If overcapture is not supported, submit an incremental authorization for the additional amount before capturing the combined total.
  5. Reconcile captured amounts against your order management system; flag any mismatch between the captured amount and the order total for manual review.
  6. Void any unused authorizations promptly to release cardholder funds and reduce your authorization-to-capture ratio, which affects interchange rates.

Known gotchas

Related routes

Handle overcapture — capturing more than the originally authorized amount within card network tolerances
docs.stripe.com · 6 steps · unrated
Perform a Braintree partial capture on a previously authorized transaction and handle the remaining uncaptured balance
developer.paypal.com/braintree · 6 steps · unrated
Capture a Klarna order in multiple partial captures as line items ship, using the Order Management API
docs.klarna.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans