ontoramp-com Commerce API

openapi: 3.2.0
info:
  title: Ontoramp Com Commerce API
  version: 2.0.0
  contact:
    email: m@ontoramp.com
    url: https://ontoramp.com/mcp
  license:
    name: Proprietary
    url: https://ontoramp.com/docs
  description: 'Operations tagged Commerce across 2 of this provider''s published API definitions: ontoramp-com-openapi.yaml, ontoramp-com.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://mcp.ontoramp.com
  description: Production MCP server
security:
- BearerAuth: []
- ApiKeyAuth: []
tags:
- name: Commerce
  description: Agent-initiated purchase. Mint a Stripe Checkout link for a self-serve plan; payment completes on Stripe's hosted page (no API key required).
paths:
  /api/checkout:
    servers:
    - url: https://ontoramp.com
      description: OntoRamp storefront (checkout is hosted on the site, not the MCP server)
    post:
      operationId: createCheckoutLink
      summary: Mint a Stripe Checkout link for a plan (agent-initiated purchase)
      description: 'Programmatically create a Stripe Checkout session for one of the self-serve plans and receive a hosted payment URL. This is the agent-transactable purchase leg: an agent assembles the order and the human (or the agent''s principal) completes payment on Stripe''s hosted page — no card data passes through the agent. Optional lead-join metadata (lead_id, utm) threads the purchase back to an assessment lead; an optional idempotency_key collapses a double-submit into one session. No API key required. The architecture_pack SKU additionally requires confirm_manual_intake: true — it is a one-time engagement fulfilled through a human intake process (the seller contacts the checkout email to begin), not an instant-provisioned subscription; minting its link without that acknowledgment returns 400.'
      tags:
      - Commerce
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckoutRequest'
      responses:
        '200':
          description: Stripe Checkout session created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutLink'
        '400':
          description: 'Invalid or missing lookup_key, or architecture_pack requested without confirm_manual_intake: true.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutError'
        '404':
          description: Price not found (products not seeded for this lookup_key)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutError'
components:
  schemas:
    CheckoutRequest:
      type: object
      required:
      - lookup_key
      properties:
        lookup_key:
          type: string
          description: The plan to purchase (Stripe price lookup key).
          enum:
          - knowledge_graph_org
          - governance_evaluator_org
          - projection_engine_org
          - governance_intelligence_bundle
          - architecture_pack
        lead_id:
          type: string
          maxLength: 255
          description: Optional assessment-lead id to join the purchase back to a lead.
        idempotency_key:
          type: string
          maxLength: 255
          description: Optional client key; collapses a double-submit into one session.
        confirm_manual_intake:
          type: boolean
          description: 'Required (must be exactly true) when lookup_key is architecture_pack. Acknowledges that the Architecture Pack is a one-time engagement fulfilled through a human intake process after purchase — the seller contacts the checkout email to begin intake; it is not instant-provisioned like the subscription plans. Ignored for other SKUs.

            '
        utm:
          type: object
          description: Optional UTM attribution bundle threaded onto the session.
          properties:
            source:
              type: string
            medium:
              type: string
            campaign:
              type: string
    CheckoutError:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          description: Human-readable error reason.
    CheckoutLink:
      type: object
      required:
      - url
      properties:
        url:
          type: string
          format: uri
          description: Stripe-hosted Checkout URL — direct the buyer here to complete payment.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key as Bearer token
    ApiKeyAuth:
      type: apiKey
      in: query
      name: api_key
      description: API key as query parameter
x-refined-from:
- ontoramp-com-openapi.yaml
- ontoramp-com.yaml