Skip to main content
POST
Start winning auction bid checkout

Path Parameters

clientSlugOrId
string
required

Public organization slug or numeric ID.

Example:

"example-foundation"

eventSlug
string
required

Event slug within the organization.

Example:

"annual-gala"

bidId
integer
required

Record ID in the authenticated organization.

Example:

42

Body

application/json
checkout_token
string
required

Secret checkout token issued for this bid.

Maximum string length: 120
Example:

"issued-bid-token"

purchaser
object | null
payment_method
string | null

Selected payment method; public checkout verifies payment separately. Check is available only when enabled.

Maximum string length: 80
Example:

"card"

gateway
string | null

Configured processor selection, such as stripe or paypal.

Maximum string length: 80
Example:

"stripe"

donation_amount
number | null

Optional donation add-on, suppressed when event settings disable it.

Required range: x >= 0
Example:

25

fees_covered_amount
number | null

Legacy explicit fee coverage; prohibited for V2 or when submitting a quote fingerprint.

Required range: x >= 0
Example:

25

answers
object[] | null
idempotency_key
string | null

Retry key; required for public V2 and staff registrations. Reuse the same key for the same cart.

Maximum string length: 120
Example:

"registration-request-1"

Response

Bid already has an order.

message
string

Registration/payment outcome.

Example:

"Registration complete."

data
object
manage_url
string

Frontend secret order-management URL.

Example:

"/events/42/annual-gala/orders/issued-token"