# Rye Checkout Intent Creator (x402)

> Rye Checkout Intent Creator (x402) is a paid API for AI agents from x402.rye.com, paid per call via x402, $0.02/call, status down (last checked 2026-10-13).

Initiates a wallet-native checkout intent for purchasing products from 15k+ merchants, returning an intent ID after satisfying a $0.02 USDC x402 payment challenge.

## Facts

- Endpoint: POST https://x402.rye.com/v1/checkout-intents?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-10-13
- Activations on Zero: 0
- Canonical page: https://www.zero.xyz/c/rye-checkout-intent-creator-x402-6b505d54
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jmA91RvBh18VYJ0xkmGaW

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 rye-checkout-intent-creator-x402-6b505d54 -d '<json body>'
```

Example prompt: I want to buy this product — https://www.amazon.com/dp/B08N5WRWNW — using my crypto wallet. Can you start a checkout intent for me using my wallet address 0xAbc123...?

## When to prefer this

Use this endpoint when you need to purchase a physical or digital product from a major retailer (Shopify, Amazon, Best Buy, etc.) using a crypto wallet and USDC, specifically via the x402 micropayment protocol. It is the entry point for Rye's 3-step wallet-native checkout flow and is ideal for AI agents automating purchases on behalf of users with Web3 wallets.

## Known failure modes

- 402 Payment Required on first call — expected; must sign the x402 authorization and retry with PAYMENT-SIGNATURE header
- Invalid or missing product URL — returns 400 or error state
- Invalid wallet address or missing wallet header — authentication failure
- x402 payment signature invalid or expired — retry with fresh signature
- Merchant not supported in Rye network — offer retrieval may fail downstream

## How this service works

Create a checkout intent. The first call returns 402 with an x402 payment challenge. After signing the authorization, retry with the PAYMENT-SIGNATURE header to complete the request.

This is step 1 of 3 for purchasing a product:
(1) POST /v1/checkout-intents with productUrl → returns intent id ($0.02 USDC).
(2) GET /v1/checkout-intents?id={id} (free, wallet-scoped — requires X-Wallet-Address matching the buyer wallet) → poll until state="awaiting_confirmation" and review priced offer.
(3) POST /v1/checkout-intents/confirm → finalize purchase (dynamic cost = order total + $0.03 API fee + ~1.5% Stripe surcharge).
Wallet-native checkout for 15k+ merchants — Shopify, Amazon, Best Buy, and others.

## Output

Returns a JSON object with a checkout intent ID (e.g. 'ci_abc123') and an initial state string (e.g. 'retrieving_offer'). This ID is used in subsequent polling (GET /v1/checkout-intents?id={id}) and confirmation (POST /v1/checkout-intents/confirm) steps to complete the purchase.

## Example request

```json
{
 "buyer": {
  "city": "San Francisco",
  "email": "zero-qa@agentmail.to",
  "phone": "+15555555555",
  "country": "US",
  "address1": "123 Main St",
  "lastName": "QA",
  "province": "CA",
  "firstName": "Zero",
  "postalCode": "94105"
 },
 "quantity": 1,
 "productUrl": "https://www.amazon.com/dp/B08N5WRWNW",
 "paymentMethod": {
  "type": "x402",
  "network": "base"
 },
 "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f42bE",
 "notificationEmail": "zero-qa@agentmail.to"
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id",
  "state"
 ],
 "properties": {
  "id": {
   "type": "string",
   "example": "ci_abc123"
  },
  "state": {
   "type": "string",
   "example": "retrieving_offer"
  }
 },
 "additionalProperties": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rye-checkout-intent-creator-x402-6b505d54/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.rye.com](https://www.zero.xyz/host/x402.rye.com/llms.txt)