> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluid.app/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> For new direct REST integrations, use the v2026-04 surfaces. The @fluid-app FairShare SDK continues to use its own published public-v2025-06 contract.
> Authenticate with the header Authorization: Bearer <token>; public storefront read endpoints require no auth.
> Lists use cursor pagination via the page[cursor] and page[limit] query params; follow meta.pagination.next_cursor until it is null.
> Never use /api/company/v1 or /api/v1 paths, page/per_page params, or offset pagination — they are legacy.
> The OpenAPI specs under api-reference/ are the authoritative contracts; prefer them over prose when in doubt. api-reference/storefront-v2026-04.yaml covers the v2026-04 storefront surface (/api/v202604/... paths); api-reference/auth-v0.yaml covers the unversioned auth surface (/api/... paths — authentication, MFA, social auth, and token exchange); api-reference/checkout-v2026-04.yaml covers the v2026-04 checkout surface (/api/checkout/v2026-04/... paths — carts, cart auth, discounts, items, subscriptions, orders, enrollments, and store config); api-reference/public-v2025-06.yaml covers the Public SDK surface used by the @fluid-app FairShare SDK, including its parallel cart lifecycle, browser integrations, versioned payment callbacks, unversioned public utilities, and the cart price-override operation; api-reference/payment-v2026-04.yaml covers the v2026-04 payment gateway admin surface (/api/payment/v2026-04/... paths, bearer-authenticated — gateway CRUD, gateway purchase/authorize/$0-verify, transaction list/show and capture/void/credit, and merchant payment configuration); api-reference/payments-v2026-04.yaml covers the v2026-04 cart payment surface (/api/payments/v2026-04/carts/{cart_token}/... paths, authenticated by the cart token in the path with no bearer — payment-method selection, VGS card tokenization, 3D Secure verification, and PayPal/Braintree/Klarna/Apple Pay flows); api-reference/commerce-v2026-04.yaml covers the v2026-04 commerce order-editing surface (/api/v202604/orders/{order_id}/edits paths, bearer-authenticated — post-checkout order edits that atomically insert items and add adjustments/discounts, with an optional dry-run preview); api-reference/webhooks-v0.yaml covers the unversioned webhooks surface (/api/... paths — webhook registration, delivery payloads, callback registrations, company events, and webhook/callback schemas).
> Successful responses wrap the resource payload alongside a top-level integer status and a meta object.

# Delete a gateway

> Deletes a gateway. Returns `204` with no body on success. Returns `404` when
the gateway does not exist for the authenticated merchant.




## OpenAPI

````yaml /api-reference/payment-v2026-04.yaml delete /api/payment/v2026-04/gateways/{id}
openapi: 3.1.0
info:
  title: Fluid Payment API
  version: v2026-04
  description: >-
    Payment gateway and transaction management API. Supports API key
    authentication (fp_live_*/fp_test_*) and JWT bearer tokens.
  contact:
    email: support@fluid.app
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
  - url: https://api.fluid.app
security:
  - bearer_auth: []
tags:
  - name: Gateways
    description: >-
      Manage payment gateways and run gateway-level transactions — purchase,
      authorize, and $0 verification.
  - name: Transactions
    description: >-
      Read transactions and run transaction lifecycle operations — capture,
      void, and credit/refund.
  - name: Merchant Configuration
    description: >-
      Root-admin-only access to a merchant's VGS, Kount, 3DS acquirer, payout,
      and platform-fee settings.
paths:
  /api/payment/v2026-04/gateways/{id}:
    parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: Gateway slug, UUID, or ID
    delete:
      tags:
        - Gateways
      summary: Delete a gateway
      description: >
        Deletes a gateway. Returns `204` with no body on success. Returns `404`
        when

        the gateway does not exist for the authenticated merchant.
      operationId: destroyGateway
      responses:
        '204':
          description: Gateway deleted
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    Unauthorized:
      description: Missing or invalid credentials.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/UnauthorizedResponse'
    Forbidden:
      description: Authenticated but not authorized for this action.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ForbiddenResponse'
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    UnauthorizedResponse:
      type: object
      required:
        - message
        - meta
      properties:
        message:
          type: string
          description: Human-readable reason the credentials were rejected.
        status:
          type: string
          description: Error status string, when present.
        meta:
          $ref: '#/components/schemas/Meta'
    ForbiddenResponse:
      description: |
        Authenticated but not authorized. Two body shapes occur:
        - a bare `message` when the credential lacks the required role/tier
          (e.g. a non-admin JWT calling an admin endpoint)
        - a `status` + `message` envelope from payment API endpoint gates
      anyOf:
        - type: object
          required:
            - message
            - meta
          properties:
            message:
              type: string
            meta:
              $ref: '#/components/schemas/Meta'
        - type: object
          required:
            - status
            - message
            - meta
          properties:
            status:
              type: string
              enum:
                - error
            message:
              type: string
            meta:
              $ref: '#/components/schemas/Meta'
    ErrorResponse:
      oneOf:
        - type: object
          required:
            - status
            - message
            - meta
          properties:
            status:
              type: string
              enum:
                - error
              description: Always `error` for this envelope.
            message:
              type: string
              description: Human-readable description of what went wrong.
            meta:
              $ref: '#/components/schemas/Meta'
        - type: object
          required:
            - error_message
            - errors
            - meta
          properties:
            error_message:
              type: string
              description: Human-readable summary of the failure.
            errors:
              $ref: '#/components/schemas/ErrorBag'
            meta:
              $ref: '#/components/schemas/Meta'
    Meta:
      type: object
      required:
        - request_id
        - timestamp
      properties:
        request_id:
          type:
            - string
            - 'null'
          description: |
            Unique identifier for this request, echoed on every response for log
            correlation and support; `null` when none was assigned.
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp (UTC) of when the response was generated.
    ErrorBag:
      description: >-
        Validation errors keyed by field, a list of errors, a single error
        message, or null when no structured error details are available.
      anyOf:
        - type: string
        - type: array
          items:
            $ref: '#/components/schemas/ErrorValue'
        - type: object
          additionalProperties:
            $ref: '#/components/schemas/ErrorValue'
        - type: 'null'
    ErrorValue:
      description: A validation or API error value.
      anyOf:
        - type: string
        - type: array
          items:
            type: string
        - type: object
          additionalProperties:
            $ref: '#/components/schemas/JsonValue'
    JsonValue:
      description: >-
        Any valid JSON value for provider, integration, theme, metadata, or
        other dynamic payloads whose keys are not fixed by the API contract.
      anyOf:
        - type: string
        - type: number
        - type: boolean
        - type: 'null'
        - type: array
          items:
            $ref: '#/components/schemas/JsonValue'
        - type: object
          additionalProperties:
            $ref: '#/components/schemas/JsonValue'
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      description: API key (fp_live_*/fp_test_*) or JWT bearer token

````