{
    "schema_version": "1.2.0",
    "protocol": "eurovdc-agent-commerce-v1",
    "enabled": true,
    "phase": "browser_handoff",
    "merchant": {
        "name": "EuroVDC",
        "url": "https://www.eurovdc.eu",
        "logo": "https://www.eurovdc.eu/public/images/logo.png",
        "support": "support@eurovdc.eu"
    },
    "currency": "EUR",
    "capabilities": {
        "product_discovery": true,
        "price_quotes": true,
        "locked_quotes": true,
        "cart_mutations": true,
        "browser_checkout": true,
        "in_agent_payment": false,
        "whmcs_order_fulfill": false,
        "shared_payment_token": false
    },
    "endpoints": {
        "list_products": "https://www.eurovdc.eu/en/api/list_products",
        "agent_domain_fields": "https://www.eurovdc.eu/en/api/agent_domain_fields",
        "agent_cart_add": "https://www.eurovdc.eu/en/api/agent_cart_add",
        "agent_cart_get": "https://www.eurovdc.eu/en/api/agent_cart/{cart_id}",
        "agent_checkout_quote": "https://www.eurovdc.eu/en/api/agent_checkout_quote",
        "agent_checkout_prepare": "https://www.eurovdc.eu/en/api/agent_checkout_prepare",
        "agent_checkout_status": "https://www.eurovdc.eu/en/api/agent_checkout_status/{quote_id}",
        "agent_checkout_fulfill": "https://www.eurovdc.eu/en/api/agent_checkout_fulfill",
        "stripe_webhook": "https://www.eurovdc.eu/agent-stripe-webhook.php",
        "agent_checkout_pay": "https://www.eurovdc.eu/en/api/agent_checkout_pay",
        "product_feed": "https://www.eurovdc.eu/feeds/product-feed.json",
        "openapi": "https://www.eurovdc.eu/.well-known/openapi.json",
        "mcp": "https://www.eurovdc.eu/mcp",
        "acp_checkout_sessions": "https://www.eurovdc.eu/acp/checkout_sessions"
    },
    "checkout_flow": [
        "1 POST agent_cart_add with product_id or domain",
        "2 POST agent_checkout_quote with cart_id → locked quote (15 min)",
        "3 Receive commerce.checkout_url and commerce.line_items",
        "4 Open checkout_url in user browser (24h cart TTL) — Phase 1",
        "5 Phase 2: POST agent_checkout_prepare → stripe_checkout_url (Stripe Checkout Session)",
        "6 GET agent_checkout_status/{quote_id} → payment_status",
        "7 POST agent_checkout_fulfill after login if WHMCS order pending",
        "8 Phase 3: POST agent_checkout_pay { quote_id, shared_payment_granted_token } when enabled"
    ],
    "phase2": {
        "quote_ttl_seconds": 900,
        "enabled": false,
        "endpoints": {
            "agent_checkout_quote": "https://www.eurovdc.eu/en/api/agent_checkout_quote",
            "agent_checkout_quote_get": "https://www.eurovdc.eu/en/api/agent_checkout_quote/{quote_id}",
            "agent_checkout_prepare": "https://www.eurovdc.eu/en/api/agent_checkout_prepare",
            "agent_checkout_status": "https://www.eurovdc.eu/en/api/agent_checkout_status/{quote_id}",
            "agent_checkout_fulfill": "https://www.eurovdc.eu/en/api/agent_checkout_fulfill",
            "stripe_webhook": "https://www.eurovdc.eu/agent-stripe-webhook.php"
        },
        "flow": [
            "1 POST agent_cart_add → cart_id",
            "2 POST agent_checkout_quote { cart_id } → quote_id (15 min locked price)",
            "3 Phase 1: open commerce.checkout_url (browser basket)",
            "4 Phase 2: POST agent_checkout_prepare { quote_id } → stripe_checkout_url",
            "5 Stripe webhook + GET agent_checkout_status → paid + WHMCS order when client known",
            "6 POST agent_checkout_fulfill { quote_id } after login if fulfillment pending"
        ],
        "payment_rails": {
            "stripe_checkout_session": true,
            "stripe_webhook": true,
            "shared_payment_granted_token": false,
            "shared_payment_token": false
        },
        "note": "Phase 2 flag off — quotes lock prices; payment remains browser handoff."
    },
    "phase3": {
        "enabled": false,
        "payment_modes": [
            "browser_handoff"
        ],
        "endpoints": {
            "agent_checkout_pay": "https://www.eurovdc.eu/en/api/agent_checkout_pay"
        },
        "flow": [
            "1 POST agent_checkout_quote → quote_id",
            "2 POST agent_checkout_pay { quote_id, shared_payment_granted_token } → instant in-agent payment",
            "3 GET agent_checkout_status → paid + fulfillment_status"
        ],
        "stripe": {
            "parameter": "payment_method_data.shared_payment_granted_token",
            "token_prefix": "spt_",
            "reference": "https://docs.stripe.com/agentic-commerce/acp"
        },
        "note": "Enable AGENT_COMMERCE_PHASE3 after Stripe enables Shared Payment Token on your account."
    },
    "acp_compatibility": {
        "note": "Phase 1 browser handoff; Phase 2 Stripe Checkout Session + webhook fulfillment; Phase 3 Shared Payment Granted Token (ACP delegated payment).",
        "reference": "https://developers.openai.com/commerce/"
    },
    "partner_api_keys": {
        "contact": "support@eurovdc.eu",
        "auth_headers": [
            "Authorization: Bearer evdc_...",
            "X-Agent-Api-Key: evdc_..."
        ],
        "verify": "https://www.eurovdc.eu/en/api/ping",
        "tiers": [
            {
                "id": "public",
                "label": "Public (no key)",
                "whois_60s": 30,
                "ai_burst": 5,
                "ai_hour": 15,
                "cart_hour": 10,
                "multiplier": 1
            },
            {
                "id": "partner",
                "label": "Partner agent",
                "whois_60s": 90,
                "ai_burst": 15,
                "ai_hour": 45,
                "cart_hour": 30,
                "multiplier": 3
            },
            {
                "id": "enterprise",
                "label": "Enterprise agent",
                "whois_60s": 300,
                "ai_burst": 50,
                "ai_hour": 150,
                "cart_hour": 100,
                "multiplier": 10
            }
        ]
    },
    "openai_acp": {
        "checkout_sessions_url": "https://www.eurovdc.eu/acp/checkout_sessions",
        "api_version": "2026-04-17",
        "required_headers": [
            "Idempotency-Key",
            "API-Version"
        ],
        "payment_mode": "browser_handoff",
        "onboarding": "Contact support@eurovdc.eu for ChatGPT Instant Checkout merchant registration."
    }
}