payments-ai Pages API

openapi: 3.2.0
info:
  title: Payments AI website Pages API
  version: 1.0.0
  summary: Read-only JSON, Markdown, and content-negotiation surface of www.payments.ai.
  description: 'Machine-readable surface of the Payments AI website: company and pricing facts as JSON, a Markdown representation of every page, and `Accept: text/markdown` content negotiation per acceptmarkdown.com. No authentication is required and every endpoint is a GET.


    ## Versioning and deprecation


    JSON endpoints are versioned in the URL under `/api/v1`, currently stable. Nothing on this host is deprecated.


    - Additive changes ship in place: a response may gain a field, and never loses or renames one.

    - A breaking change ships under a new version prefix (/api/v2). The previous prefix keeps responding.

    - A deprecated version keeps responding for at least 12 months from the day it is announced.

    - Deprecation is announced with the Deprecation (RFC 9745) and Sunset (RFC 8594) response headers on the affected endpoints, and restated in this document, /llms.txt, and /api/v1/site.json.


    In short: an integration against `/api/v1` has at least 12 months'' warning before anything stops answering, and the warning arrives as a response header rather than only as a blog post.


    Product and integration APIs (checkout, subscriptions, webhooks, MCP) are not part of this description; they are documented at https://docs.payments.ai.'
  contact:
    name: Payments AI support
    email: support@payments.ai
    url: https://docs.payments.ai
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
- url: https://www.payments.ai
  description: Production website
tags:
- name: Pages
  description: HTML pages that also serve Markdown via Accept negotiation
paths:
  /:
    get:
      operationId: getPageRoot
      summary: Payments AI
      description: 'Comparison hub for the two products: Merchant of Record for AI apps and creators, and payment orchestration for platforms.'
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /mor/:
    get:
      operationId: getPageMor
      summary: Merchant of Record for AI apps & creators
      description: 'Merchant-of-record checkouts: you are not the merchant of record, sales tax and VAT are collected at checkout and remitted for you, and agents build the checkout via MCP.'
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /mor/mcp/:
    get:
      operationId: getPageMorMcp
      summary: MCP for Merchant of Record
      description: The nine setup steps an AI agent performs over the Payments AI MCP server, from the first sign-in to switching on live payments.
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /mor/pricing/:
    get:
      operationId: getPageMorPricing
      summary: Merchant of Record pricing
      description: Itemized Merchant of Record rates for payments, payouts, fraud, and optimization.
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /platforms/:
    get:
      operationId: getPagePlatforms
      summary: Payment orchestration for platforms
      description: Embedded orchestration that routes across gateways to recover failed sales and retain payment revenue.
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /platforms/pricing/:
    get:
      operationId: getPagePlatformsPricing
      summary: Payment orchestration pricing
      description: Pricing model and terms for payment orchestration. Itemized rates are quoted by sales.
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /roadmap/:
    get:
      operationId: getPageRoadmap
      summary: Product roadmap
      description: What Payments AI is building across payment orchestration and Merchant of Record, grouped as now, next, and later.
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /mor/terms-of-service/:
    get:
      operationId: getPageMorTermsOfService
      summary: MoR Terms of Service
      description: Terms of Service for Merchant of Record checkout, billing, and payment infrastructure.
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /mor/privacy-policy/:
    get:
      operationId: getPageMorPrivacyPolicy
      summary: MoR Privacy Policy
      description: How Payments.Ai LLC collects, uses, and protects personal information for MoR services.
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /mor/prohibited-products-and-services/:
    get:
      operationId: getPageMorProhibitedProductsAndServices
      summary: Prohibited Products and Services
      description: Products and services that may not be sold through the Payments AI Merchant of Record.
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /platforms/terms-of-service/:
    get:
      operationId: getPagePlatformsTermsOfService
      summary: Terms of Service
      description: Website and service terms (Payments.Ai LLC, Delaware).
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /platforms/merchanting-terms/:
    get:
      operationId: getPagePlatformsMerchantingTerms
      summary: Merchanting Terms
      description: Payment processing and merchanting terms and conditions.
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
  /platforms/tos-privacy/:
    get:
      operationId: getPagePlatformsTosPrivacy
      summary: Privacy Statement
      description: How Payments.Ai LLC collects, uses, and protects personal information.
      tags:
      - Pages
      parameters:
      - name: Accept
        in: header
        required: false
        description: 'Send `text/markdown` to get the Markdown representation of this page instead of HTML. Quality values are honoured; responses set `Vary: Accept, Accept-Encoding`.'
        schema:
          type: string
          examples:
          - text/markdown
          - text/html
      responses:
        '200':
          description: The page, as HTML for browsers or Markdown for agents.
          headers:
            Vary:
              description: Always includes `Accept`, so caches keep the two representations apart.
              schema:
                type: string
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
            text/markdown:
              schema:
                type: string
                contentMediaType: text/markdown
        '406':
          description: No representation of this resource matches the Accept header (for example `text/markdown;q=0` on a Markdown-only resource). The body lists the media types that are available.
          content:
            text/plain:
              schema:
                type: string
                contentMediaType: text/plain
externalDocs:
  url: https://docs.payments.ai
  description: Product and integration documentation