Skip to main content
POST
/
api
/
storefront
/
cart
/
{cart_id}
/
buyer-identity
Attach Buyer Identity
curl --request POST \
  --url https://api.example.com/api/storefront/cart/{cart_id}/buyer-identity \
  --header 'Content-Type: application/json' \
  --header 'X-Site-ID: <x-site-id>' \
  --data '
{
  "email": "jsmith@example.com",
  "phone": "<string>"
}
'
{
  "cart_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "email": "jsmith@example.com",
  "phone": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.stella-commerce.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
authorization
string | null
​
X-Site-ID
string
required
​
X-Stella-Token
string | null
​
Idempotency-Key
string | null

Path Parameters

​
cart_id
string<uuid>
required

Body

application/json

Attach a buyer to an in-flight cart. At least one of email, phone, or an authenticated customer token must be present — enforced in the route, not the schema, since the customer token arrives in a header rather than the body.

​
email
string<email> | null
​
phone
string | null
Maximum string length: 50

Response

Successful Response

​
cart_id
string<uuid>
required
​
customer_id
string<uuid> | null
required
​
email
string<email> | null
required
​
phone
string | null
required