{
  "schema": "agentx-billing-guide-v0.1",
  "plan_version": "XAGENT-PRICING-20261007-v1",
  "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",
    "checkout_confirmation": "https://xagent.id/api/agent/checkout/confirmation",
    "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",
      "plan_version": "XAGENT-PRICING-20261007-v1",
      "sellable": true,
      "sales_status": "available",
      "checkout_plan": null,
      "price": 0.0,
      "unit": "monthly",
      "includes": [
        "Find why AI cannot read, discover or contact you"
      ],
      "billing_type": "free",
      "public": true
    }
  ],
  "paid_routes": [
    {
      "id": "identity",
      "plan_version": "XAGENT-PRICING-20261007-v1",
      "sellable": false,
      "sales_status": "coming_soon",
      "checkout_plan": "identity",
      "price": 29.99,
      "unit": "monthly",
      "includes": [
        "Find why AI cannot read, discover or contact you",
        "Company claim and domain control verification",
        "Company AI card and machine-readable data access",
        "Files and settings for AI discovery and reading",
        "Monthly Agent Visibility listing updates",
        "Product structured data: items, specifications and prices",
        "Agent visit evidence: when and what was read"
      ],
      "billing_type": "recurring",
      "public": true
    },
    {
      "id": "ainbox",
      "plan_version": "XAGENT-PRICING-20261007-v1",
      "sellable": false,
      "sales_status": "coming_soon",
      "checkout_plan": "ainbox",
      "price": 49.99,
      "unit": "monthly",
      "includes": [
        "Find why AI cannot read, discover or contact you",
        "Company claim and domain control verification",
        "Company AI card and machine-readable data access",
        "Files and settings for AI discovery and reading",
        "Monthly Agent Visibility listing updates",
        "Product structured data: items, specifications and prices",
        "Agent visit evidence: when and what was read",
        "A2A business inquiries from other agents",
        "AI Friendly inquiry guidance",
        "Email, Webhook and Slack forwarding",
        "Team assignment, human review and reply history"
      ],
      "billing_type": "recurring",
      "public": true
    },
    {
      "id": "agentic",
      "plan_version": "XAGENT-PRICING-20261007-v1",
      "sellable": false,
      "sales_status": "coming_soon",
      "checkout_plan": "agentic",
      "price": 99.99,
      "unit": "monthly",
      "includes": [
        "Find why AI cannot read, discover or contact you",
        "Company claim and domain control verification",
        "Company AI card and machine-readable data access",
        "Files and settings for AI discovery and reading",
        "Monthly Agent Visibility listing updates",
        "Product structured data: items, specifications and prices",
        "Agent visit evidence: when and what was read",
        "A2A business inquiries from other agents",
        "AI Friendly inquiry guidance",
        "Email, Webhook and Slack forwarding",
        "Team assignment, human review and reply history"
      ],
      "billing_type": "recurring",
      "public": true
    },
    {
      "id": "operate",
      "plan_version": "XAGENT-PRICING-20261007-v1",
      "sellable": false,
      "sales_status": "coming_soon",
      "checkout_plan": "operate",
      "price": 199.99,
      "unit": "monthly",
      "includes": [
        "Find why AI cannot read, discover or contact you",
        "Company claim and domain control verification",
        "Company AI card and machine-readable data access",
        "Files and settings for AI discovery and reading",
        "Monthly Agent Visibility listing updates",
        "Product structured data: items, specifications and prices",
        "Agent visit evidence: when and what was read",
        "A2A business inquiries from other agents",
        "AI Friendly inquiry guidance",
        "Email, Webhook and Slack forwarding",
        "Team assignment, human review and reply history",
        "Ongoing scheduling, progress and exception notifications",
        "Authorized AI file updates, verification and rollback",
        "Multiple domains and standard business connections"
      ],
      "billing_type": "recurring",
      "public": true
    }
  ],
  "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_confirmation",
      "action": "Poll the redacted Checkout return state; it never grants access."
    },
    {
      "step": 6,
      "tool": "checkout_status",
      "action": "Read the authenticated provider-confirmed entitlement after the signed webhook is applied."
    }
  ],
  "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": "Read an off-chain x402-style quote only; this is not an enabled payment request and does not move funds."
    },
    {
      "step": 3,
      "tool": "aeo_job_payment_proof",
      "action": "A redacted proof hash may be recorded for an operator-reviewed funding path; it is not x402 or AP2 settlement."
    }
  ],
  "payment_capabilities": {
    "human_checkout": {
      "status": "available_when_stripe_is_explicitly_configured",
      "enabled": false,
      "activation_rule": "live_environment_variables_plus_provider_signed_webhook"
    },
    "x402": {
      "status": "not_enabled_yet",
      "enabled": false,
      "planned": true,
      "planned_gate": "after_identity_and_payment_verification",
      "does_not": [
        "not_a_payment_request",
        "does_not_authorize_wallet_or_card_charge",
        "does_not_grant_entitlement"
      ]
    },
    "ap2": {
      "status": "not_enabled_yet",
      "enabled": false,
      "planned": true,
      "planned_gate": "after_x402_production_readiness",
      "does_not": [
        "not_a_payment_mandate",
        "does_not_delegate_purchase_authority",
        "does_not_process_cards"
      ]
    }
  },
  "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",
      "status": "off_chain_compatibility_only",
      "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",
      "status": "not_enabled_yet",
      "enabled": false
    }
  },
  "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",
    "x402_is_not_enabled_yet",
    "ap2_is_not_enabled_yet",
    "agent_payments_are_not_executable",
    "does_not_grant_paid_entitlement_without_payment_or_operator_approval"
  ]
}