{
  "schema": "agentx-billing-guide-v0.1",
  "currency": "USD",
  "endpoints": {
    "pricing": "https://xagent.id/api/agent/pricing",
    "billing_guide": "https://xagent.id/api/agent/billing_guide",
    "checkout": "https://xagent.id/api/agent/checkout",
    "provider_checkout": "https://xagent.id/api/agent/checkout/session",
    "entitlement_status": "https://xagent.id/api/agent/checkout/status",
    "subscription_management": "https://xagent.id/api/agent/billing/portal",
    "job_payment_quote": "https://xagent.id/api/agent/jobs/payment_quote",
    "job_fund_with_proof": "https://xagent.id/api/agent/jobs/fund_with_proof"
  },
  "free_routes": [
    {
      "id": "free_audit",
      "checkout_plan": null,
      "price": 0,
      "unit": "per audit",
      "includes": [
        "AI readiness report",
        "public evidence links",
        "upgrade recommendations"
      ],
      "billing_type": "free",
      "public": true
    }
  ],
  "paid_routes": [
    {
      "id": "starter",
      "checkout_plan": "starter",
      "price": 9.99,
      "unit": "monthly per verified domain",
      "includes": [
        "verifiable website identity on your own domain",
        "machine-readable site profile",
        "management console and change history",
        "quarterly AI visibility snapshot"
      ],
      "billing_type": "recurring",
      "public": true
    },
    {
      "id": "professional",
      "checkout_plan": "professional",
      "price": 24.99,
      "unit": "monthly per verified domain",
      "includes": [
        "Starter",
        "dedicated website agent with Google-issued identity",
        "cross-ecosystem identity verification",
        "monthly AI visibility report"
      ],
      "billing_type": "recurring",
      "public": true
    },
    {
      "id": "growth",
      "checkout_plan": "growth",
      "price": 79,
      "unit": "monthly per verified domain",
      "includes": [
        "Professional",
        "competitor benchmark",
        "managed optimizations with owner approval and instant restore",
        "priority support"
      ],
      "billing_type": "recurring",
      "public": true
    },
    {
      "id": "chain_identity",
      "checkout_plan": "chain_identity",
      "price": 4.99,
      "unit": "monthly add-on per verified domain",
      "includes": [
        "on-chain identity registered to your own wallet (ERC-8004)"
      ],
      "billing_type": "recurring",
      "public": true
    },
    {
      "id": "agent_credits",
      "checkout_plan": "agent_credits",
      "price": 10,
      "unit": "prepaid credit pack",
      "includes": [
        "scoped agent job credits",
        "job quote",
        "redacted payment proof",
        "provider-confirmed entitlement"
      ],
      "billing_type": "one_time",
      "public": true
    },
    {
      "id": "generated_files",
      "checkout_plan": "discover",
      "price": 250,
      "unit": "one time",
      "includes": [
        "robots policy",
        "llms.txt",
        "schema starter",
        "installation checklist"
      ],
      "billing_type": "one_time",
      "public": false
    },
    {
      "id": "site_agent_setup",
      "checkout_plan": "agent",
      "price": 5600,
      "unit": "project",
      "includes": [
        "Site Agent Key",
        "agent-card",
        "MCP/A2A readiness",
        "deployment verification"
      ],
      "billing_type": "one_time",
      "public": false
    },
    {
      "id": "continuous_optimization",
      "checkout_plan": "convert",
      "price": 250,
      "unit": "monthly add-on",
      "includes": [
        "A1/A2/B1 monitoring",
        "monthly optimization queue",
        "new agent-channel updates"
      ],
      "billing_type": "recurring",
      "public": false
    }
  ],
  "checkout_flow": [
    {
      "step": 1,
      "tool": "get_pricing",
      "action": "Read current plans and choose a checkout_plan."
    },
    {
      "step": 2,
      "tool": "agent_checkout",
      "action": "Create a redacted compatibility checkout intent without granting access."
    },
    {
      "step": 3,
      "tool": "checkout_session",
      "action": "Create a provider checkout session bound to the verified website and Agent ID."
    },
    {
      "step": 4,
      "tool": "external_checkout",
      "action": "Complete payment through the configured checkout provider."
    },
    {
      "step": 5,
      "tool": "checkout_status",
      "action": "Wait for a signed provider webhook before treating the entitlement as active."
    }
  ],
  "subscription_management_flow": [
    {
      "step": 1,
      "tool": "checkout_status",
      "action": "Read the authenticated website's provider-confirmed plan, renewal state, and access end date."
    },
    {
      "step": 2,
      "tool": "billing_portal",
      "action": "Create a short-lived Stripe-hosted management session from the server-side customer binding."
    },
    {
      "step": 3,
      "tool": "external_provider",
      "action": "Change, resume, or cancel the subscription with the provider; Google Marketplace plans remain in Google Cloud Billing."
    },
    {
      "step": 4,
      "tool": "checkout_status",
      "action": "Wait for the signed provider event before treating cancellation or resumption as final."
    }
  ],
  "management_boundaries": {
    "stripe": "provider_hosted_portal",
    "google_marketplace": "google_cloud_billing",
    "disconnect": "separate_customer_controlled_action",
    "browser_return": "not_provider_confirmation"
  },
  "job_payment_flow": [
    {
      "step": 1,
      "tool": "aeo_job_accept_draft",
      "action": "Open one explicit AEO job draft without funding it."
    },
    {
      "step": 2,
      "tool": "aeo_job_payment_quote",
      "action": "Request an x402-style payment requirement for the open job."
    },
    {
      "step": 3,
      "tool": "aeo_job_payment_proof",
      "action": "Submit a redacted payment proof hash; raw payment secrets are not stored."
    }
  ],
  "payment_rails": {
    "human_checkout": {
      "provider": "Stripe Checkout",
      "supports": [
        "credit_card",
        "subscription",
        "one_time_credit_pack"
      ],
      "activation_rule": "provider_signed_webhook_required"
    },
    "agent_checkout": {
      "current": "prepaid_scoped_credits_and_job_quote",
      "compatibility": [
        "A2A payment extension",
        "x402-style payment proof"
      ],
      "activation_rule": "no_job_execution_without_confirmed_entitlement_or_operator_approval"
    },
    "delegated_authorization": {
      "protocol": "Google AP2",
      "role": "authorization_evidence_not_card_processor"
    }
  },
  "non_claims": [
    "checkout_intent_is_not_payment_confirmation",
    "does_not_charge_without_external_checkout_completion",
    "x402_style_payment_proof_is_off_chain_until_provider_is_configured",
    "does_not_grant_paid_entitlement_without_payment_or_operator_approval"
  ]
}