Stripe Integration for Auction Payment Processing — AuctionFlow
native

Stripe Stripe Payments

End-to-end auction payment processing — bidder deposits, escrow holds, buyer premium calculation, and consignor settlement payouts through Stripe.

Data Flows

How data moves between Stripe and AuctionFlow in real time.

Live Data Integration

External System

Stripe

Live Sync

Platform

AuctionFlow

Bidder Deposits

Outbound

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

Outbound

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

Outbound

Buyer premium calculated as a percentage of hammer price and included in the payment capture sent to Stripe at settlement

Consignor Payouts

Outbound

Settlement disbursements to consignor Stripe Connect accounts after hold period, deducting commission and fees

Payment Status Webhooks

Inbound

Real-time payment status updates from Stripe webhooks — successful charges, failed payments, disputes, and refund confirmations

Chargeback & Dispute Events

Inbound

Dispute notifications from Stripe that trigger AuctionFlow settlement hold workflows and flag affected lots for review

Capabilities

What this integration enables within your auction workflow.

Bidder Deposit Holds with Automatic Release

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.

Buyer Premium Calculation and Collection

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.

Consignor Settlement via Stripe Connect

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.

Multi-Currency and International Bidder Support

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.

Edge Cases

Scenarios to be aware of and how AuctionFlow handles them.

Bidder wins multiple lots across staggered close times

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.

Deposit hold expiration before auction close

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.

Chargeback filed after consignor payout has been disbursed

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.

AI Copilot

How AuctionFlow's AI assistant enhances this integration.

AI-Powered

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.

Setup Steps

Get up and running with the Stripe integration.

Setup time: 1-2 days for standard configuration; 3-5 days for tiered buyer premium and multi-currency setups
Prerequisites: 4

Prerequisites

  • Stripe account with Stripe Connect enabled
  • Business verification completed in Stripe dashboard
  • SSL certificate on AuctionFlow domain (required for Stripe.js)
  • Webhook endpoint accessible from Stripe servers (HTTPS, port 443)
  1. 1

    Create a Stripe account and enable Stripe Connect for consignor payouts

  2. 2

    Generate Stripe API keys (publishable and secret) and configure webhook endpoint in AuctionFlow integration settings

  3. 3

    Configure deposit hold amounts, buyer premium structures, and settlement hold periods for each auction format

  4. 4

    Set up Stripe Connect onboarding flow for consignor bank account verification

  5. 5

    Run test auction cycle in Stripe test mode — deposit hold, bid, hammer, invoice, payout — verifying each payment stage

  6. 6

    Switch to Stripe live mode and process a pilot auction to confirm production payment flow

Stripe Integration — Common Questions

Ready to Connect Stripe?

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 Blueprint