Start fulfillment workflow (internal)

Starts a fulfillment workflow for a confirmed, paid order. Protected by AWS IAM — only
callable by authorised internal services.

Events fired

EventTriggerDescription
fulfillment.FulfillmentStartedsyncFired when the fulfillment workflow is successfully started.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Starts a fulfillment workflow for a confirmed order.

string
required
uuid
required
uuid
required

Campaign this fulfillment order belongs to.

string
^$|^[A-Za-z][A-Za-z0-9_-]*$

Human-readable slug of the campaign (e.g. "carrefour"), used for
ticket-PDF branding and reporting attribution. Optional.

string
^$|^[A-Za-z][A-Za-z0-9_-]*$

Slug used to scope Postmark template aliases for the ticket and
order-failed emails, independently of campaign_key. Lets a
white-label share another brand's email templates (e.g. "mrticket")
while campaign_key stays campaign-specific. Optional — falls back
to campaign_key, then locale-only scoping, when empty. Must start
with a letter when non-empty (Postmark alias constraint).

string
required

Identifier of the user this fulfillment order belongs to, in the
integrator's system. Same value supplied on POST /session. Stored
on the fulfillment order so integrators can later retrieve this
user's tickets via the admin fulfillment endpoints.

string

The customer's IP address, captured at checkout-confirm. Stored on
the fulfillment order for providers that require an end-consumer IP
at confirm time. Optional.

string

The value of the User-Agent header on the customer's checkout-confirm
request. Stored on the fulfillment order for providers that require
end-consumer browser details at confirm time. Optional.

string

The value of the Accept-Language header on the customer's
checkout-confirm request. Stored on the fulfillment order for
providers that require end-consumer browser details at confirm
time. Optional.

lines
array of objects
required
lines*
boolean
required

Whether the customer opted for a flexible visit date on this order.

flexible_ticket_costs
object
required

A monetary amount with currency.

discount_total
object
required

A monetary amount with currency.

Headers
string

RFC 7231 language preference. The best match against supported locales (nl-NL, en-GB, de-DE) is selected. Defaults to nl-NL when omitted.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json