# Lucky Cart Core API

**Canonical:** https://apis.io/apis/lucky-cart/core-api/  
**Provider:** Lucky Cart — https://apis.io/providers/lucky-cart/  
**Base URL:** https://api.luckycart.com  
**Documentation:** https://github.com/lucky-cart/luckycart-js-sdk#send-the-current-transaction

Lucky Cart Core API is one of 6 APIs that [Lucky Cart](https://apis.io/providers/lucky-cart/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include Transactions, Promotions, and Gamification. The published artifact set on APIs.io includes authentication docs.

The core Lucky Cart API. POST /cart/ticket submits a validated shopping cart — cart identifier, shopper identifier, gross and net amounts, and product lines — and Lucky Cart determines whether a game can be generated, returning a ticket plus the device-specific intro image and game URL. This is the only signed endpoint: the request body carries auth_ts, auth_key, auth_v "2.0" and auth_sign, an HMAC-SHA256 digest of the timestamp keyed by the site secret. Game data is read back at /{siteKey}/game/{cartId} or /{siteKey}/game/cust/{shopperId}, optionally suffixed with the device. Cart ingestion is asynchronous, so the read returns the literal error "Cart not found" until it completes and clients poll on a bounded attempt budget.

## Machine-readable artifacts (4)

- **Authentication** — https://raw.githubusercontent.com/api-evangelist/lucky-cart/refs/heads/main/authentication/lucky-cart-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/lucky-cart/refs/heads/main/conventions/lucky-cart-conventions.yml
- **SourceCode** — https://github.com/lucky-cart/luckycart-js-sdk
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/lucky-cart/refs/heads/main/apis.yml

## Other Lucky Cart APIs (5)

- [Lucky Cart Shopper Events API](https://apis.io/apis/lucky-cart/shopper-events-api/)
- [Lucky Cart Shopper Experience API](https://apis.io/apis/lucky-cart/shopper-experience-api/)
- [Lucky Cart Game Experience API](https://apis.io/apis/lucky-cart/game-experience-api/)
- [Lucky Cart Displayer API](https://apis.io/apis/lucky-cart/displayer-api/)
- [Lucky Cart Promo Matching API](https://apis.io/apis/lucky-cart/promo-matching-api/)

## Tags

Transactions, Promotions, Gamification

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/lucky-cart/core-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/lucky-cart/.
