Switch a cart's currency | TTG Developer Portal

curl -X PATCH https://stg.ttix.io/api/v3/carts/cartId \
     -H "X-TT-Platform: android" \
     -H "X-TT-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "currency": "GBP"
}'

{
  "id": "6aac14d3-5826-4da8-98b6-9e68c28629d6",
  "expiresAt": "2026-03-15T19:40:00Z",
  "items": [
    {
      "id": "001",
      "event": {
        "id": "123",
        "name": "Hamilton"
      },
      "occurrence": {
        "id": "456",
        "startsAt": "2026-03-15T19:30:00-05:00"
      },
      "venue": {
        "id": "UmljaGFyZCBSb2RnZXJzIFRoZWF0cmU",
        "name": "Richard Rodgers Theatre",
        "address": {
          "line1": "226 W 46th St",
          "line2": "Suite 200",
          "city": "New York",
          "state": "NY",
          "postalCode": "10036",
          "country": "US",
          "latitude": 40.759,
          "longitude": -73.9845
        },
        "timezone": "America/New_York"
      },
      "inventoryVariant": {
        "_type": "AssignedSeat",
        "attributes": [
          {
            "name": "Limited Legroom",
            "category": "NEGATIVE",
            "description": "Seats in this row have reduced legroom due to a safety barrier."
          }
        ],
        "id": "Orchestra-A-101",
        "name": "Orchestra A 101",
        "row": "A",
        "seat": "101",
        "section": "Orchestra"
      },
      "priceOption": {
        "category": {
          "name": "Adult"
        },
        "sellPrice": {
          "amount": 18500,
          "currency": "USD"
        },
        "id": "eyJjIjoiRlVMTCJ9",
        "listPrice": {
          "amount": 18500,
          "currency": "USD"
        },
        "maxQuantityPerOrder": 4,
        "promotion": {
          "id": "promo-opening-week",
          "name": "Opening Week Special",
          "description": "40% off Orchestra seats for opening week performances."
        }
      },
      "quantity": 1,
      "delivery": {
        "method": {
          "name": "E-ticket"
        },
        "instructions": "Your e-tickets will be emailed to you before the performance."
      }
    }
  ],
  "receiptLines": [
    {
      "label": "Subtotal",
      "total": {
        "amount": 18500,
        "currency": "USD"
      },
      "sign": "positive",
      "_type": "SubtotalLine"
    }
  ],
  "total": {
    "amount": 18500,
    "currency": "USD"
  },
  "protection": {
    "id": "prot_001",
    "pricePerItem": {
      "amount": 18500,
      "currency": "USD"
    },
    "total": {
      "amount": 18500,
      "currency": "USD"
    },
    "status": "ELIGIBLE"
  },
  "options": {
    "currencies": [
      "USD",
      "GBP",
      "EUR"
    ],
    "paymentMethods": [
      {
        "method": "CARD",
        "gateway": "ADYEN",
        "merchantAccount": "EncoreTicketsOwnBrand"
      }
    ],
    "extras": [
      {
        "id": "v1_AQAAAAPoAAAABk9yY2hlc3RyYS1BLTEwMQ",
        "inventoryVariant": {
          "_type": "AssignedSeat",
          "attributes": [
            {
              "name": "Limited Legroom",
              "category": "NEGATIVE",
              "description": "Seats in this row have reduced legroom due to a safety barrier."
            }
          ],
          "id": "Orchestra-A-101",
          "name": "Orchestra A 101",
          "row": "A",
          "seat": "101",
          "section": "Orchestra"
        },
        "priceOptions": [
          {
            "category": {
              "name": "Adult"
            },
            "sellPrice": {
              "amount": 18500,
              "currency": "USD"
            },
            "id": "eyJjIjoiRlVMTCJ9",
            "listPrice": {
              "amount": 18500,
              "currency": "USD"
            },
            "maxQuantityPerOrder": 4,
            "promotion": {
              "id": "promo-opening-week",
              "name": "Opening Week Special",
              "description": "40% off Orchestra seats for opening week performances."
            }
          }
        ],
        "quantityAvailable": 1,
        "maxQuantityPerOrder": 6
      }
    ]
  },
  "voucher": {
    "code": "SUMMER20",
    "discount": {
      "amount": 18500,
      "currency": "USD"
    }
  },
  "totalTaxes": {
    "amount": 18500,
    "currency": "USD"
  }
}

Send the event’s base currency to go back to base-currency prices.

Amounts are always worked out from the current exchange rate, so a quote can move while the cart is open. Read the cart again just before checkout to get the amount that will be charged.

Changes the currency a cart is priced and settled in, and returns the cart with every amount converted to it. The cart keeps this currency on later reads and the order settles in it, so no header is needed after this call. Send the event's base currency to go back to base-currency prices. Amounts are always worked out from the current exchange rate, so a quote can move while the cart is open. Read the cart again just before checkout to get the amount that will be charged.

Authentication

X-TT-API-Keystring

API Key authentication via header

Path parameters

cartIdstringRequired

Cart ID (UUID)

Request

This endpoint expects an object.

currencystringRequiredformat: "^[A-Z]{3}$">=1 character

ISO 4217 currency to price and settle this cart in. Send the event’s base currency to go back to base-currency prices.

Response

Cart priced in its new currency.

idstring

Cart ID

expiresAtstring

UTC timestamp when the cart hold expires and inventory is released. Clients should display a countdown timer and warn users before expiration.

itemslist of objects

Items currently in the cart (held inventory). Does NOT include fees, protection, or credits — see receiptLines for those.

receiptLineslist of objects

Server-ordered display lines for receipt rendering. Iterate in sequence. Always includes SubtotalLine. Conditionally: VoucherLine, ProtectionLine.

totalobject

Monetary amount in minor units (cents for USD). Never uses floating point to avoid precision errors.

protectionobjectOptional

Protection covering all items. Null if not added.

optionsobjectOptional

Options that can be applied to this cart. Each key is present only when that option is available.

voucherobjectOptional

A promo code applied to a cart.

totalTaxesobjectOptional

Monetary amount in minor units (cents for USD). Never uses floating point to avoid precision errors.

Authentication

Path parameters

Headers

Request

Response