Perform a Braintree partial capture on a previously authorized transaction and handle the remaining uncaptured balance
domain: developer.paypal.com/braintree · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Create an authorization-only transaction using submitForAuthorization set to false during transaction creation
After fulfillment of a partial shipment, call the Braintree Transaction submitForPartialSettlement API with the amount to capture for the shipped portion
Store the returned child transaction ID for the partial settlement alongside the parent authorization ID
When the remaining goods are shipped, call submitForPartialSettlement again for the residual amount before the authorization void window expires
If the remaining authorization is no longer needed, void it explicitly to release the hold on the cardholder's account
Reconcile child transactions back to the parent authorization in your order management system
Known gotchas
The authorization hold window varies by card brand and issuer, typically 7 days for most cards but shorter for some debit cards; plan shipment timelines accordingly
Not all Braintree gateway configurations enable partial settlement by default; confirm with Braintree support that the feature is active on your merchant account
Partial settlements each incur separate interchange and processing fees, which can erode margin on split shipments compared to a single full capture
Give your agent this knowledge — and 15,600+ 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?