# Martin Estate Winery - Purchase Wine

> Martin Estate Winery - Purchase Wine is a paid API for AI agents from Martin Estate Winery at agents.martinestate.com, paid per call via MPP or x402, $1/call, status unknown (last checked 2026-10-10).

Purchase age-verified, estate-grown Napa Valley wine with KYC identity verification and crypto or card payment via AgentScore.

## Facts

- Endpoint: POST https://agents.martinestate.com/purchase?utm_source=zero.xyz
- Price: $1/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: Martin Estate Winery
- Docs: https://www.martinestate.com
- Website: https://www.martinestate.com
- Tags: wine, commerce, alcohol, age-restricted, physical-goods, napa-valley, web, x402
- Canonical page: https://www.zero.xyz/c/martin-estate-winery-purchase-af57f699
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uhtY5tQp2tjal5wIXRnVT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability martin-estate-winery-purchase-af57f699 -d '<json body>'
```

Example prompt: Order 2 bottles of the Martin Estate 2021 Cabernet Sauvignon (product ID abc123) for me — ship them to Jane Smith at 45 Vine Street, St. Helena, CA 94574, and use my email jane@example.com. It's a gift, so include a note: 'Happy birthday, Alex! Cheers to many more. — Jane'.

## When to prefer this

Use this endpoint when the user explicitly wants to purchase wine from Martin Estate Winery and has a product_id from the Catalog endpoint. Requires identity verification (KYC, 21+, US only) via AgentScore. Supports crypto wallets (Tempo MPP, x402) and traditional payment rails (Stripe SPT, card). Use the Catalog endpoint first if the user has not yet selected a specific wine.

## Known failure modes

- 403 returned when neither X-Wallet-Address nor X-Operator-Token header is present — agent must follow verify_url to complete KYC/age verification
- Payment signing mismatch: wallet address claimed does not match the signing wallet, causing payment rejection
- Age verification failure: buyer does not meet 21+ requirement
- Shipping to unsupported state or country (US only)
- Invalid product_id UUID results in 404 or validation error
- Quantity exceeds maximum of 12 — order rejected
- Malformed email or missing required shipping fields cause 400 validation error
- Resuming a pending order with an expired or invalid order_id UUID

## How this service works

Agent-commerce API for Martin Estate — estate-grown Napa Valley wine. Identity verification required via AgentScore.

## Output

Returns an order confirmation with order details, payment status, and shipment information, or a 403 with a verify_url and session token if identity verification is required before completing the purchase.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "email",
  "quantity",
  "shipping",
  "product_id"
 ],
 "properties": {
  "email": {
   "type": "string"
  },
  "order_id": {
   "type": "string",
   "description": "Resume a pending order after identity verification"
  },
  "quantity": {
   "type": "integer"
  },
  "shipping": {
   "type": "object"
  },
  "gift_note": {
   "type": "string",
   "description": "Optional personal note to print on a card. Plain text only (no HTML/markdown). Newlines (\\n) are preserved. If the buyer is sending as a gift, ASK them first and include an opening + signature in the note text. Omit for non-gift orders."
  },
  "product_id": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/martin-estate-winery-purchase-af57f699/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.martinestate.com](https://www.zero.xyz/host/agents.martinestate.com/llms.txt)