Bring the truffle counter to your application.

Generate a temporary sandbox token without an account. The shared public token is catalog-read only; generated tokens receive the scopes requested for simulated cart and checkout testing and expire after 24 hours.

curl -X POST https://api.papatartufi.com/sandbox/v1/keys

curl -X POST https://api.papatartufi.com/sandbox/v1/carts \
  -H "Authorization: Bearer YOUR_GENERATED_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"currency":"EUR"}'

The shared catalog key is pt_test_public_sandbox_key and can read sandbox catalog tools, but cannot create or modify carts. Simulated checkout returns checkout_url: null; customer payment remains on the Papa Tartufi storefront in the future production flow.

Sandbox responses include environment: "sandbox" and simulated: true. REST and MCP clients use the same cart contract; the MCP endpoint is https://api.papatartufi.com/mcp/sandbox.

Locale defaults to en, country to IT, and currency to EUR. Every response echoes the resolved market, including region_id.

Each variant carries its own calculated_price for the resolved Medusa region. Option combinations select the variant; the product price_range is a summary only.

Availability describes purchasability: in_stock andbackorder are purchasable, while out_of_stock is not. Exact quantities are never exposed, and weighted products are excluded.