API · Checkout settings

The Checkout settings endpoint groups the account-wide options used during checkout: optional buyer fields, ticket price display, who pays the Usetix fee, and any additional fee. Events inherit these fee defaults unless they set a custom event policy.

Reading requires a token with Read or Read + Write permission. Updating requires Read + Write. See Authentication.

Custom checkout questions remain event-specific. Manage them through the Custom checkout fields API.

GET /admin/account_settings/checkout

curl \
  -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json" \
  https://app.usetix.io/admin/account_settings/checkout

Response:

{
  "data": {
    "collect_customer_phone": true,
    "offer_business_invoice": true,
    "offer_marketing_consent": true,
    "customer_email_help_text": "We send tickets and event updates here.",
    "show_price_on_ticket": true,
    "platform_fee_payer": "organizer",
    "custom_fee_fixed_amount": { "amount": "0.00", "currency": "EUR" },
    "custom_fee_percentage": "0.0"
  }
}

PATCH /admin/account_settings/checkout

Send only the fields you want to change, directly at the JSON top level. This example asks for a phone number, charges the Usetix fee to the buyer, and adds €2.50 plus 5%:

curl -X PATCH \
  -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"collect_customer_phone":true,"platform_fee_payer":"buyer","custom_fee_fixed_amount":"2.50","custom_fee_percentage":"5"}' \
  https://app.usetix.io/admin/account_settings/checkout

Writable fields:

Field	Type	Notes
collect_customer_phone	boolean	Whether checkout asks for a phone number.
offer_business_invoice	boolean	Whether checkout offers business-invoice fields.
offer_marketing_consent	boolean	Whether checkout offers email-marketing consent.
customer_email_help_text	string	Help text below the required checkout email field. Maximum 200 characters; send "" to clear.
show_price_on_ticket	boolean	Whether generated ticket PDFs show the paid price. Defaults to true.
platform_fee_payer	string	organizer absorbs the Usetix fee. buyer adds it to the buyer’s total.
custom_fee_fixed_amount	string	Optional extra fee charged once per order, in the account currency. Send "" or "0" to clear.
custom_fee_percentage	string	Optional extra percentage of the discounted ticket subtotal (5 for 5%). Range 0–100. Send "" or "0" to clear.

Response: 200 OK with the complete updated data object in the same shape as GET.

The update is atomic: if any field is invalid, none of the submitted settings are persisted. Validation failures return 422 Unprocessable Entity:

{
  "errors": {
    "custom_fee_fixed_amount": ["is not a number"]
  }
}

A Read token attempting PATCH receives 401 Unauthorized and no settings are changed.

The Shop settings and Checkout fees endpoints continue to expose and accept their existing checkout fields for backwards compatibility. New integrations should use this dedicated endpoint.