Quickstart – sell to an agent in 5 minutes

API="https://merchants.veto-ai.com"
KEY="veto_test_..."   # veto_live_... for real money

# 1) Create your store → returns { "id": "mrch_..." }
curl -X POST "$API/v1/merchants" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "acme",
    "name": "Acme Corp",
    "domain": "shop.acme.example",
    "receiving": {
      "x402": {
        "chain": "base-sepolia",
        "address": "0x1111111111111111111111111111111111111111",
        "asset": "USDC"
      }
    }
  }'

# 2) Add a product (use the id from step 1)
curl -X POST "$API/v1/catalog?merchant_id=mrch_..." \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "rpt-001",
    "name": "Market Report",
    "description": "Q3 market intelligence.",
    "price": { "amount": "5.00", "currency": "USD" },
    "available": true
  }'

# 3) Publish – activates the config and rebuilds the discovery manifest
curl -X POST "$API/v1/publish?merchant_id=mrch_..." \
  -H "Authorization: Bearer $KEY"

const API = "https://merchants.veto-ai.com";
const KEY = process.env.VETO_API_KEY; // veto_test_... or veto_live_...

const headers = {
  Authorization: `Bearer ${KEY}`,
  "Content-Type": "application/json",
};

// 1) Create your store
const merchant = await fetch(`${API}/v1/merchants`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    slug: "acme",
    name: "Acme Corp",
    domain: "shop.acme.example",
    receiving: {
      x402: {
        chain: "base-sepolia", // "base" for real money
        address: "0x1111111111111111111111111111111111111111",
        asset: "USDC",
      },
    },
  }),
}).then((r) => r.json());

const merchantId = merchant.id; // mrch_...

// 2) Add a product
await fetch(`${API}/v1/catalog?merchant_id=${merchantId}`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    sku: "rpt-001",
    name: "Market Report",
    description: "Q3 market intelligence.",
    price: { amount: "5.00", currency: "USD" }, // exact decimal string
    available: true,
  }),
});

// 3) Publish
await fetch(`${API}/v1/publish?merchant_id=${merchantId}`, {
  method: "POST",
  headers,
});

console.log("Published:", merchantId);

import os
import requests

API = "https://merchants.veto-ai.com"
KEY = os.environ["VETO_API_KEY"]  # veto_test_... or veto_live_...
headers = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

# 1) Create your store
merchant = requests.post(
    f"{API}/v1/merchants",
    headers=headers,
    json={
        "slug": "acme",
        "name": "Acme Corp",
        "domain": "shop.acme.example",
        "receiving": {
            "x402": {
                "chain": "base-sepolia",  # "base" for real money
                "address": "0x1111111111111111111111111111111111111111",
                "asset": "USDC",
            }
        },
    },
).json()

merchant_id = merchant["id"]  # mrch_...

# 2) Add a product
requests.post(
    f"{API}/v1/catalog",
    params={"merchant_id": merchant_id},
    headers=headers,
    json={
        "sku": "rpt-001",
        "name": "Market Report",
        "description": "Q3 market intelligence.",
        "price": {"amount": "5.00", "currency": "USD"},  # exact decimal string
        "available": True,
    },
)

# 3) Publish
requests.post(f"{API}/v1/publish", params={"merchant_id": merchant_id}, headers=headers)

print("Published:", merchant_id)