Module · Promotion

Promotion: auctions

Instead of selling a place at a fixed price, you can sell its paid seats by auction. Specialists bid for a display period (for example one week); when bidding closes, the highest bidders win the seats and each pays a price set by the next-highest bid. Auctions run on their own once a place is configured. All options are described in Settings → Auction settings.

When to use an auction

  • Demand for a place is higher than its seats, and you want the price to follow demand.
  • You want seats to rotate by periods rather than be booked far ahead.

Keep Fixed price when you have few specialists or want simple, predictable prices. You can use both: for example an auction above the specialists directory and fixed-price plans for services.

Setting up an auctioned place

  1. Consider pressing Pause sales while you switch, so no purchase lands in the middle of the change.
  2. In Promotion → Placements, make sure the place is On and has Paid slots and Max concurrent paid (M). The number of seats an auction sells is the smaller of the two.
  3. In Promotion → Auction settings, set the place's Mode to Auction and enter a minimum price for the type it shows. No auction is opened while the minimum price is 0.
  4. Set the period (Period length (days), Period start (weekday) and hour), Close bidding (hours before start), the step settings and the strike rules. Click Save auction settings.
  5. Resume sales. Within the next scheduled run the module opens auctions for the next two upcoming periods of the place.

The mode cannot be changed while campaigns occupy seats that would no longer belong to the place, or while unpaid won seats or open bids depend on it. Wait until they end, are paid or released, or cancel the auction.

How an auction runs

Periods

Periods follow a fixed grid in the site time zone: they start on the chosen weekday and hour and repeat every period length. For each auctioned place and type there is one auction per period. Bidding for a period closes Close bidding (hours before start) hours before the period begins. If you change the period length, a new period that would overlap a running one waits until that one ends.

Entry price and step

  • While there are fewer bids than seats, the entry price is the minimum price.
  • When all seats are covered by bids, the entry price is the lowest winning bid plus one step.
  • The step is the larger of Step percent of the entry price and Minimum step, rounded up to the Step grid.

Example: minimum price 100, 3 seats, step 5% with a minimum step of 10 and a grid of 5. With bids of 300, 250 and 200, the entry price is 200 + 10 = 210.

Bidding (specialist)

On the Promotion tab of the cabinet, the Auction section lists open periods with the place, Period, "bidding closes …", Entry price, the step and Your bid. The specialist chooses Pay with:

  • Card (Картка): the won seat is charged to a saved card (or invoiced).
  • Balance (Баланс): the full bid is held on the specialist's available balance while the bid is active.
  • Balance + card (Баланс + картка): as much as possible is held on the balance; the rest is charged to the card.

Balance options appear only when the payment module allows paying for purchases from the balance. Card and Balance + card require accepting the auto-charge consent text first ("Confirm consent for automatic card charges.").

They then click +1 step · …, +2 steps · … (the resulting amount is shown on the button) or Bid own amount (Ставка своєю сумою). Rules:

  • A bid must be at least the entry price ("The bid must be at least the entry price (…).").
  • A specialist can only raise their bid ("You can only raise your bid."); bids cannot be withdrawn.
  • Two specialists cannot hold the same amount ("Another specialist already has this amount. Raise higher.").
  • A specialist banned for unpaid wins cannot bid on that place and type ("You are temporarily banned from this auction.").
  • The same purchase conditions as for fixed-price plans apply (published profile, verified details, no restriction, if required).
  • With Soft close on late bid on, a bid in the last Window (minutes) before closing extends bidding by Extend by (minutes), never past the period start.

Each period shows the specialist's state: leading (лідирує), outbid, won, won, awaiting payment, participation paused or bidding closed. An outbid specialist receives "Your promotion auction bid was outbid" (once per new entry price). The section also shows "Held under bids: … · available balance: …".

Automatic charge card

Under Automatic charge card (Картка автосписання) the specialist can Link a card (or Link another card), turn on automatic charges after accepting the consent text, and Unlink. Only a card linked here can be charged for wins; cards saved for booking payments are not used. If the card is unlinked or replaced, or the consent text changes, automatic charges stop until the specialist confirms again; wins are then paid by invoice or from the balance. Linking a card uses the payment provider configured in the payment module, which must support saved cards.

Closing and winners

When bidding closes (or a manager closes the auction early), the module:

  1. Ranks the current bids. The highest bidders win the seats, up to the number of seats.
  2. Sets each winner's clearing price: the next bid below the winners plus one step, at least the minimum price and never more than the winner's own bid. With fewer bids than seats, winners pay the minimum price.
  3. Collects the payment: first from the balance hold (for balance bids), then from the automatic charge card if it is on. If neither covers the price, the winner receives an invoice ("You won a promotion seat — pay the invoice by …") and sees it under Open invoices with "Amount due: … · pay by …" and a pay button.
  4. Releases the balance holds of specialists who did not win.
  5. Creates a campaign for every paid seat, bound to this place and to the period. It shows during the period like any other campaign.

Unpaid seats, cascade and strikes

  • A winner who does not pay by the invoice deadline (Invoice payment deadline (hours), never later than the period start) loses the seat. The seat passes to the next bidder in line (the cascade), who is charged or invoiced in the same way.
  • The winner who did not pay gets a strike. After Strikes before ban strikes, they cannot bid on that place and type for Ban length (periods) periods.
  • The cabinet warns about this next to the bid buttons: "If a charge fails: an invoice for 24 hours; unpaid in time — the place goes to the next bidder and you get a strike."

Unsold seats

Seats nobody won (or that no one in the cascade paid for) are handled by Unsold seats:

  • Minimum price queue, then organic: specialists can buy the seat at the minimum price for the rest of the period ("Display until … (auction period remainder)"); until someone does, free cards fill it.
  • Organic immediately: free cards fill the seat for the whole period.

Cancelling and refunds

  • A specialist can cancel an auction seat from the cabinet like any campaign; the refund follows the cancellation rules (unused part, withdrawal fee).
  • For auction seats money is settled only by cancellation or termination; the Place funds on hold pause decision is not available.
  • The team can cancel a whole auction with Cancel with refunds (see below).

Auctions in the admin

Where: ExpertPress → Promotion → Auctions (Аукціони).

Auction list

"Bidding rounds by placement, subject type, and period." Filter by place and Status: All, Open, Closing, Closed, Cancelling, Cancelled. Each row shows the place, Type, Period, Status and a Stalled transition mark when an auction has stayed closing or cancelling longer than Stall threshold (hours). Open a row for details, or Diagnostics.

Auction details

The Auction #… page shows Placement, Type, Status, Period, Bids close, Slots, Min. price and Closed at, and two tables:

  • Bids: Seq, Subject, Amount, Pay method, When and whether the bid is Current.
  • Outcomes and cascade: Seat, Subject, Status, Clearing price, Pay deadline, Campaign, Strike.

Bid amounts, holds and sale details are shown only to staff with money access.

Actions:

  • Close auction (Закрити аукціон): closes bidding now, before the scheduled time. Confirmation: "Close this auction now? Winners will be charged or invoiced." Needs the End campaign permission.
  • Cancel with refunds (Скасувати з поверненнями): cancels the auction, refunds paid seats and releases balance holds. Confirmation: "Cancel this auction with refunds and hold releases? This cannot be undone." Needs both the Refunds and the End campaign permissions. A large auction is cancelled in parts by scheduled tasks; it shows Cancelling until it is done.

Diagnostics

A read-only snapshot of one auction's internal state for troubleshooting: what is pending, what has already been processed and what would run next. Nothing is retried or changed from this page. If a read fails, the page says the evidence is partial; empty sections then do not prove that nothing is there.

Auction report

The classic Promotion page offers CSV: auctions with closed auctions, seats, fill rate, revenue and refunds by currency, and attributed requests for the chosen dates. See Statistics, requests and revenue.