TItickitto
Basket

Apply Basket Promocode

Changed on

Applies a promotional code to a basket.

put/api/basket/promocode

Request

  • Base URL
    https://tickitto.tech (the document declares no server; this is the origin it was published from)
  • URL
    https://tickitto.tech/api/basket/promocode
  • Auth
    API key in header key

Query parameters

basket_idstring required
promocodestring required
currencystring

Currency to display event prices.

user_idstring
domainstring

Domain to validate promocode against. If not included then profile domains will be used

profile_namestring

Profile name

hostnamestring

Associated hostname

Headers

originstring
X-Correlation-IDstring

Optional transaction reference provided by the client. Used to correlate API requests and responses with client flow in logs, errors etc.

Response

Successful Response

_idstring required
external_referencestring

Distributor reference for this basket

checkout_status'not_checked_out' | 'checkout_pending' | 'payment_failed' | 'checked_out' | 'checked_out_with_errors'
  • not_checked_out: the basket has neither been, nor is being checked out
  • checkout_pending: the basket is currently in the process of checking out
  • payment_failed: the basket payment failed, and thus wasn't checked out
  • checked_out: the basket has already been checked out
  • checked_out_with_errors: the basket has been checked out but 1 or more items errored
created_onstring date-time
distributor_idstring

User ID of the event distributor which created this basket

profile_external_user_idstring

External user ID used in handle_profile_post_checkout

total_local_price_ttlstring date-time

Expiry datetime for the total_local_price_currency value/exchange rate, set by Stripe.

total_local_price_exchange_ratenumber
    Exchange rate used to convert the total price to the local currency, set by Stripe. An average of exchange rates for all items in the basket.
    This only differs from total_local_price_base_exchange_rate when the basket contains items with their own exchange rate, such as vivid USD
total_local_price_base_exchange_ratenumber

Exchange rate set by Stripe.

Changes

  • 22e674e2f052Revision changes
    • info

      the response's property default value changed from 2026-11-02T01:51:23.495618+00:00 to 2026-11-02T00:14:07.237071+00:00 for the status

    • info

      the response's property default value changed from 2026-11-02T01:51:23.517383+00:00 to 2026-11-02T00:14:07.261514+00:00 for the status

  • add82d040056Revision changes
    • info

      the response's property default value changed from 2026-11-01T10:08:40.779256+00:00 to 2026-11-02T01:51:23.495618+00:00 for the status

    • info

      the response's property default value changed from 2026-11-01T10:08:40.798176+00:00 to 2026-11-02T01:51:23.517383+00:00 for the status