Express checkout (create + confirm)

post

https://api.acc.funtrips.io/{stage}/checkouts/express

Supports guest users.

Places a reservation and confirms it in a single call, returning a PSP
payment URL directly. Use this when the client submits the basket and
customer details together and does not render an intermediate review
step — it is leaner than POST /checkouts followed by
POST /checkouts/{checkout_id}/confirm because it skips building the
priced review the two-step flow returns from Create.

The request body is the union of the create-checkout basket fields and
the confirm-checkout customer/payment fields. The response carries the
checkout_id (so the client can poll GET /checkouts/{checkout_id} for
status) alongside the order identifiers and payment URL. Supports
idempotency via the Idempotency-Key header.

Events fired

Event	Trigger	Description
`checkouts.CheckoutStarted`	sync	Fired when the reservation is placed.
`checkouts.CheckoutFulfillmentRegistered`	sync	Fired when the checkout is confirmed and a fulfillment workflow has been registered.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Single-call create + confirm. The union of the create-checkout basket fields and the confirm-checkout customer/payment fields.

date

date-time

required

Desired visit date (including timeslot when the product requires one).

flexible_date

boolean

required

Defaults to false

When true the reservation is not tied to a specific date.

external_reference

string

Caller-supplied reference (e.g. cart ID).

lines

array of objects

required

length ≥ 1

lines*

voucher_codes

array of strings

length ≤ 50

Optional unlock-voucher codes applied at checkout (max 50). Each valid code unlocks one product unit's campaign-defined discount; invalid codes are ignored.

voucher_codes

string

required

first_name

string

required

last_name

string

required

street

string

Shipping street name. Required when the basket contains a physical product; ignored otherwise.

house_number

string

Shipping house number. Required when the basket contains a physical product; ignored otherwise.

house_number_suffix

string

Optional house-number addition (e.g. "A", "bis").

postal_code

string

Shipping postal code. Required when the basket contains a physical product; ignored otherwise.

city

string

Shipping city. Required when the basket contains a physical product; ignored otherwise.

country_code

string

ISO 3166-1 alpha-2 country code of the shipping address (e.g. "NL"). Required when the basket contains a physical product; ignored otherwise.

return_url

uri

required

URL the PSP redirects to after payment.

newsletters

array of strings

List of newsletter IDs the customer opted into.

newsletters

Headers

x-campaign-id

uuid

required

Campaign scope for this request. Filters content to the specified campaign.

Idempotency-Key

uuid

required

Client-generated UUID. Identical keys within the TTL window return the cached response.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Checkout confirmed. Redirect the customer to payment_url.

208The request was already processed. The original response body is returned unchanged. Treat this identically to the normal success response for this endpoint.

400The request body or parameters are invalid.

401Missing or invalid authentication credentials.

404The campaign for this checkout is not configured.

422Reservation could not be placed or fulfilled for the selected products or date.

500An unexpected server error occurred.