API ReferenceCart

Delete cart

Deletes a cart and releases all held inventory. Idempotent - returns 204 even if cart was already deleted.

Authentication

X-TT-API-Keystring
API key for authentication. Pass as X-TT-API-Key header. Key prefixes: - Production: sk_live_* - Test: sk_test_* Example: X-TT-API-Key: sk_live_abc123

Path parameters

cartIdstringRequired
Unique identifier of the cart.

Headers

X-Client-PlatformenumRequired
Client platform identifier. Required for all requests. - `ios` - iOS native app - `android` - Android native app - `web` - Web application (browser) - `server` - Server-to-server (internal services, API testing)
Allowed values:
X-Client-VersionstringOptionalformat: "^\d+\.\d+\.\d+$"

Client app version. Required for ios, android, and web platforms. Optional for server platform. Format: Semantic version (e.g., “3.1.0”, “2.5.1”)

Accept-LanguagestringOptional

Preferred language for error messages (defaults to en-US if not provided). Supported languages: en-US, en-GB, es-ES, fr-FR, de-DE, ja-JP. Format: RFC 9110 language tags with quality values.

X-Request-IDstringOptionalformat: "^req_[a-zA-Z0-9]+$"

Client-generated request identifier for distributed tracing. Server echoes this value in response headers. Format: req_ prefix + random string.

Response

Cart deleted successfully (or was already deleted).

Errors