End-to-end auction payment processing — bidder deposits, escrow holds, buyer premium calculation, and consignor settlement payouts through Stripe.
How data moves between Stripe and AuctionFlow in real time.
External System
Stripe
Platform
AuctionFlow
Bidder Deposits
Deposit hold requests sent to Stripe when bidders register for an auction, creating Payment Intents with capture_method=manual for pre-authorization
Hammer Price Charges
Payment capture requests sent to Stripe when lots close, converting deposit holds to charges or creating new charges for the hammer price plus buyer premium
Buyer Premium Invoices
Buyer premium calculated as a percentage of hammer price and included in the payment capture sent to Stripe at settlement
Consignor Payouts
Settlement disbursements to consignor Stripe Connect accounts after hold period, deducting commission and fees
Payment Status Webhooks
Real-time payment status updates from Stripe webhooks — successful charges, failed payments, disputes, and refund confirmations
Chargeback & Dispute Events
Dispute notifications from Stripe that trigger AuctionFlow settlement hold workflows and flag affected lots for review
What this integration enables within your auction workflow.
AuctionFlow uses Stripe Payment Intents with manual capture to place deposit holds on bidder payment methods at auction registration. The hold amount is configurable per auction — typically 10-20% of the estimated lot value or a flat deposit amount set by the auction house. When a bidder wins a lot, the hold converts to a charge for the hammer price plus buyer premium. When a bidder does not win any lots, the hold is released automatically within the configurable release window (default: 24 hours after auction close). This eliminates the manual deposit management that auction houses currently handle through spreadsheets and manual card charges, and reduces bidder complaints about held funds by providing clear hold and release timing through the bidder portal.
The buyer premium — the surcharge above hammer price that represents the auction house's primary revenue — is calculated automatically at the moment the lot closes. AuctionFlow supports configurable buyer premium structures: flat percentage (e.g., 20% of hammer price), tiered percentage (e.g., 25% on first $100K, 20% on the next $400K, 12% above $500K), and flat fee plus percentage combinations. The calculated premium is itemized on the winning bidder's invoice and collected in the same Stripe payment capture as the hammer price. For auction houses running multiple auction formats with different premium structures, the premium configuration is set at the auction level, not globally, allowing different rates for estate sales versus fine art versus vehicle auctions.
After the settlement hold period — typically 7-14 days to allow for lot delivery confirmation and dispute resolution — AuctionFlow disburses consignor proceeds through Stripe Connect. Each consignor is onboarded to Stripe Connect during the consignment intake process, with identity verification and bank account setup handled by Stripe's hosted onboarding flow. Settlement payouts deduct the auction house commission, buyer premium allocation, and any applicable fees (photography, cataloging, insurance) before disbursing the net proceeds. The consignor portal displays a detailed settlement statement showing each lot's hammer price, commission, fees, and net payout, with the Stripe transfer ID for bank reconciliation.
For auction houses with international bidders — common in fine art, jewelry, and collectibles — Stripe's multi-currency support allows AuctionFlow to present lot prices and accept payments in the bidder's local currency while settling to the auction house in their base currency. Currency conversion is handled at the Stripe level with transparent exchange rates displayed to the bidder before payment confirmation. This removes the friction of international wire transfers and reduces the payment abandonment rate for cross-border auction transactions.
Scenarios to be aware of and how AuctionFlow handles them.
When a bidder wins lots that close at different times within the same auction event (common in timed auctions with staggered or soft-close endings), AuctionFlow batches the charges into a single consolidated invoice rather than charging separately for each lot. The consolidated charge is initiated after all lots in the auction have closed and the settlement window opens, preventing multiple small charges that would trigger fraud detection flags on the bidder's card and reducing Stripe per-transaction fees for the auction house.
Stripe authorization holds expire after 7 days for most card types. For auctions with registration periods longer than 7 days before the auction close date, AuctionFlow automatically re-authorizes the deposit hold before expiration, ensuring the hold remains valid through auction close. The bidder is notified if re-authorization fails, and their bidding privileges are suspended until a valid payment method is confirmed.
When a winning bidder files a chargeback after the consignor payout has already been disbursed, AuctionFlow flags the affected settlement, notifies the auction house, and creates a recovery case in the consignor portal. The auction house can initiate a debit against the consignor's Stripe Connect balance for the disputed amount, or handle the recovery through their consignment agreement terms. The dispute evidence — bid history, lot condition report, delivery confirmation — is compiled automatically for Stripe's dispute response process.
How AuctionFlow's AI assistant enhances this integration.
The AI copilot analyzes historical auction payment data to recommend optimal deposit hold amounts by auction category, identifying the deposit level that maximizes bidder registration while minimizing non-payment risk. It monitors payment failure patterns across auctions and flags bidders with elevated non-payment risk before they register for new events. During settlement, the copilot reviews each payout for anomalies — lots with unusually high hammer-to-estimate ratios, first-time bidders winning high-value lots, or consignors with previous dispute history — and flags settlements that warrant manual review before payout release.
Get up and running with the Stripe integration.
Create a Stripe account and enable Stripe Connect for consignor payouts
Generate Stripe API keys (publishable and secret) and configure webhook endpoint in AuctionFlow integration settings
Configure deposit hold amounts, buyer premium structures, and settlement hold periods for each auction format
Set up Stripe Connect onboarding flow for consignor bank account verification
Run test auction cycle in Stripe test mode — deposit hold, bid, hammer, invoice, payout — verifying each payment stage
Switch to Stripe live mode and process a pilot auction to confirm production payment flow
Book an Auction Blueprint session and our team will walk you through the Stripe integration setup, data mapping, and go-live timeline.
Ready to transform your auctions?
Book Auction BlueprintReady to transform your auctions?
Book Auction Blueprint