Virto Commerce

Virto Commerce Shopping Cart API

Shopping cart / checkout functionality

GitHub OpenAPI

Operations 24

GET /api/carts/{storeId}/{customerId}/{cartName}/{currency}/{cultureName}/current #
GET /api/carts/{cartId}/itemscount #
POST /api/carts/{cartId}/items #
PUT /api/carts/{cartId}/items #
DELETE /api/carts/{cartId}/items #
DELETE /api/carts/{cartId}/items/{lineItemId} #
PATCH /api/carts/{cartId} #
GET /api/carts/{cartId} Get shopping cart by id #
GET /api/carts/{cartId}/availshippingrates #
POST /api/carts/availshippingrates #
GET /api/carts/{cartId}/availpaymentmethods #
POST /api/carts/{cartId}/coupons/{couponCode} #
DELETE /api/carts/{cartId}/coupons/{couponCode} #
POST /api/carts/{cartId}/shipments #
POST /api/carts/{cartId}/payments #
POST /api/carts/search Search shopping carts by given criteria #
POST /api/carts Create shopping cart #
PUT /api/carts Update shopping cart #
DELETE /api/carts Delete shopping carts by ids #
POST /api/carts/recalculate Calculates totals for cart. #
PATCH /api/carts/patch/{id} Partial update for the specified ShoppingCart by id #
PATCH /api/carts/patch/{cartId}/items/{lineItemId} Partial update for the specified ShoppingCart LineItem by id #
PATCH /api/carts/patch/{cartId}/shipments/{shipmentId} Partial update for the specified ShoppingCart Shipment by id #
PATCH /api/carts/patch/{cartId}/payments/{paymentId} Partial update for the specified ShoppingCart Payment by id #

Documentation

📖
Documentation
https://docs.virtocommerce.org/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/virto-commerce/refs/heads/main/openapi/virto-commerce-shopping-cart-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-catalog
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-pricing
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-inventory
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-order
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-x-cart
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-customer
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-marketing
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-quote
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-module-store
📦
GitHubRepository
https://github.com/VirtoCommerce/vc-platform

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/virto-commerce/refs/heads/main/overlays/virto-commerce-shopping-cart-api-overlay.yaml
🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/virto-commerce/refs/heads/main/graphql/virto-commerce-graphql.md

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/virto-commerce-shopping-cart-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

virto-commerce-shopping-cart-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: VirtoCommerce.Cart Catalog Shopping Cart API
  version: v1
  description: Easily manage your products, categories, variations, and properties
servers:
- url: https://virtostart-demo-admin.govirto.com/api
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Shopping Cart
  description: Shopping cart / checkout functionality
paths:
  /api/carts/{storeId}/{customerId}/{cartName}/{currency}/{cultureName}/current:
    get:
      tags:
      - Shopping Cart
      operationId: CartModule_GetCart
      parameters:
      - name: storeId
        in: path
        required: true
        schema:
          type: string
      - name: customerId
        in: path
        required: true
        schema:
          type: string
      - name: cartName
        in: path
        required: true
        schema:
          type: string
      - name: currency
        in: path
        required: true
        schema:
          type: string
      - name: cultureName
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
            application/json:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
            text/json:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/{cartId}/itemscount:
    get:
      tags:
      - Shopping Cart
      operationId: CartModule_GetCartItemsCount
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: integer
                format: int32
            application/json:
              schema:
                type: integer
                format: int32
            text/json:
              schema:
                type: integer
                format: int32
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/{cartId}/items:
    post:
      tags:
      - Shopping Cart
      operationId: CartModule_AddItemToCart
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json-patch+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/CartLineItem'
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/CartLineItem'
          text/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/CartLineItem'
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
    put:
      tags:
      - Shopping Cart
      operationId: CartModule_ChangeCartItem
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      - name: lineItemId
        in: query
        schema:
          type: string
      - name: quantity
        in: query
        schema:
          type: integer
          format: int32
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
    delete:
      tags:
      - Shopping Cart
      operationId: CartModule_ClearCart
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/{cartId}/items/{lineItemId}:
    delete:
      tags:
      - Shopping Cart
      operationId: CartModule_RemoveCartItem
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      - name: lineItemId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: integer
                format: int32
            application/json:
              schema:
                type: integer
                format: int32
            text/json:
              schema:
                type: integer
                format: int32
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/{cartId}:
    patch:
      tags:
      - Shopping Cart
      operationId: CartModule_MergeWithCart
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json-patch+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
          text/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
    get:
      tags:
      - Shopping Cart
      summary: Get shopping cart by id
      operationId: CartModule_GetCartById
      parameters:
      - name: cartId
        in: path
        description: Shopping cart id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
            application/json:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
            text/json:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/{cartId}/availshippingrates:
    get:
      tags:
      - Shopping Cart
      operationId: CartModule_GetAvailableShippingRates
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ShippingRate'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ShippingRate'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ShippingRate'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/availshippingrates:
    post:
      tags:
      - Shopping Cart
      operationId: CartModule_GetAvailableShippingRatesByContext
      requestBody:
        content:
          application/json-patch+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShippingEvaluationContext'
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShippingEvaluationContext'
          text/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShippingEvaluationContext'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ShippingRate'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ShippingRate'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ShippingRate'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/{cartId}/availpaymentmethods:
    get:
      tags:
      - Shopping Cart
      operationId: CartModule_GetAvailablePaymentMethods
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PaymentMethod'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PaymentMethod'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PaymentMethod'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/{cartId}/coupons/{couponCode}:
    post:
      tags:
      - Shopping Cart
      operationId: CartModule_AddCartCoupon
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      - name: couponCode
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
    delete:
      tags:
      - Shopping Cart
      operationId: CartModule_RemoveCartCoupon
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      - name: couponCode
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/{cartId}/shipments:
    post:
      tags:
      - Shopping Cart
      operationId: CartModule_AddOrUpdateCartShipment
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json-patch+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/CartShipment'
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/CartShipment'
          text/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/CartShipment'
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/{cartId}/payments:
    post:
      tags:
      - Shopping Cart
      operationId: CartModule_AddOrUpdateCartPayment
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json-patch+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/Payment'
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/Payment'
          text/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/Payment'
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/search:
    post:
      tags:
      - Shopping Cart
      summary: Search shopping carts by given criteria
      operationId: CartModule_SearchShoppingCart
      requestBody:
        description: Shopping cart search criteria
        content:
          application/json-patch+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCartSearchCriteria'
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCartSearchCriteria'
          text/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCartSearchCriteria'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ShoppingCartSearchResult'
            application/json:
              schema:
                $ref: '#/components/schemas/ShoppingCartSearchResult'
            text/json:
              schema:
                $ref: '#/components/schemas/ShoppingCartSearchResult'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2:
        - cart:read
      - api_key:
        - cart:read
      - api_key_header:
        - cart:read
      - http-signature:
        - cart:read
      - basic:
        - cart:read
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts:
    post:
      tags:
      - Shopping Cart
      summary: Create shopping cart
      operationId: CartModule_Create
      requestBody:
        description: Shopping cart model
        content:
          application/json-patch+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
          text/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
            application/json:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
            text/json:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2:
        - cart:create
      - api_key:
        - cart:create
      - api_key_header:
        - cart:create
      - http-signature:
        - cart:create
      - basic:
        - cart:create
      x-virtocommerce-module-id: VirtoCommerce.Cart
    put:
      tags:
      - Shopping Cart
      summary: Update shopping cart
      operationId: CartModule_UpdateShoppingCart
      requestBody:
        description: Shopping cart model
        content:
          application/json-patch+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
          text/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
            application/json:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
            text/json:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2:
        - cart:update
      - api_key:
        - cart:update
      - api_key_header:
        - cart:update
      - http-signature:
        - cart:update
      - basic:
        - cart:update
      x-virtocommerce-module-id: VirtoCommerce.Cart
    delete:
      tags:
      - Shopping Cart
      summary: Delete shopping carts by ids
      operationId: CartModule_DeleteCarts
      parameters:
      - name: ids
        in: query
        description: Array of shopping cart ids
        schema:
          type: array
          items:
            type: string
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2:
        - cart:delete
      - api_key:
        - cart:delete
      - api_key_header:
        - cart:delete
      - http-signature:
        - cart:delete
      - basic:
        - cart:delete
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/recalculate:
    post:
      tags:
      - Shopping Cart
      summary: Calculates totals for cart.
      operationId: CartModule_RecalculateTotals
      requestBody:
        description: Shopping cart model
        content:
          application/json-patch+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
          text/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ShoppingCart'
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
            application/json:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
            text/json:
              schema:
                $ref: '#/components/schemas/ShoppingCart'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2: []
      - api_key: []
      - api_key_header: []
      - http-signature: []
      - basic: []
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/patch/{id}:
    patch:
      tags:
      - Shopping Cart
      summary: Partial update for the specified ShoppingCart by id
      operationId: CartModule_PatchCart
      parameters:
      - name: id
        in: path
        description: ShoppingCart id
        required: true
        schema:
          type: string
      requestBody:
        description: JsonPatchDocument object with fields to update
        content:
          application/json-patch+json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
          text/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2:
        - cart:update
      - api_key:
        - cart:update
      - api_key_header:
        - cart:update
      - http-signature:
        - cart:update
      - basic:
        - cart:update
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/patch/{cartId}/items/{lineItemId}:
    patch:
      tags:
      - Shopping Cart
      summary: Partial update for the specified ShoppingCart LineItem by id
      operationId: CartModule_PatchCartItem
      parameters:
      - name: cartId
        in: path
        description: ShoppingCart id
        required: true
        schema:
          type: string
      - name: lineItemId
        in: path
        description: LineItem id
        required: true
        schema:
          type: string
      requestBody:
        description: JsonPatchDocument object with fields to update
        content:
          application/json-patch+json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
          text/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2:
        - cart:update
      - api_key:
        - cart:update
      - api_key_header:
        - cart:update
      - http-signature:
        - cart:update
      - basic:
        - cart:update
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/patch/{cartId}/shipments/{shipmentId}:
    patch:
      tags:
      - Shopping Cart
      summary: Partial update for the specified ShoppingCart Shipment by id
      operationId: CartModule_PatchCartShipment
      parameters:
      - name: cartId
        in: path
        description: ShoppingCart id
        required: true
        schema:
          type: string
      - name: shipmentId
        in: path
        description: Shipment id
        required: true
        schema:
          type: string
      requestBody:
        description: JsonPatchDocument object with fields to update
        content:
          application/json-patch+json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
          text/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2:
        - cart:update
      - api_key:
        - cart:update
      - api_key_header:
        - cart:update
      - http-signature:
        - cart:update
      - basic:
        - cart:update
      x-virtocommerce-module-id: VirtoCommerce.Cart
  /api/carts/patch/{cartId}/payments/{paymentId}:
    patch:
      tags:
      - Shopping Cart
      summary: Partial update for the specified ShoppingCart Payment by id
      operationId: CartModule_PatchCartPayment
      parameters:
      - name: cartId
        in: path
        description: ShoppingCart id
        required: true
        schema:
          type: string
      - name: paymentId
        in: path
        description: Payment id
        required: true
        schema:
          type: string
      requestBody:
        description: JsonPatchDocument object with fields to update
        content:
          application/json-patch+json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
          text/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Operation'
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - oauth2:
        - cart:update
      - api_key:
        - cart:update
      - api_key_header:
        - cart:update
      - http-signature:
        - cart:update
      - basic:
        - cart:update
      x-virtocommerce-module-id: VirtoCommerce.Cart
components:
  schemas:
    AddressType:
      enum:
      - Undefined
      - Billing
      - Shipping
      - BillingAndShipping
      - Pickup
      type: string
    PaymentMethodGroupType:
      enum:
      - Paypal
      - BankCard
      - Alternative
      - Manual
      type: string
    ShippingMethod:
      type: object
      properties:
        code:
          type:
          - string
          - 'null'
        name:
          type:
          - string
          - 'null'
        description:
          type:
          - string
          - 'null'
        logoUrl:
          type:
          - string
          - 'null'
        isActive:
          type: boolean
        priority:
          type: integer
          format: int32
        taxType:
          type:
          - string
          - 'null'
        storeId:
          type:
          - string
          - 'null'
        settings:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ObjectSettingEntry'
        typeName:
          type:
          - string
          - 'null'
          readOnly: true
        id:
          type:
          - string
          - 'null'
      additionalProperties: false
    CartShipment:
      type: object
      properties:
        shipmentMethodCode:
          type:
          - string
          - 'null'
        shipmentMethodOption:
          type:
          - string
          - 'null'
        fulfillmentCenterId:
          type:
          - string
          - 'null'
        fulfillmentCenterName:
          type:
          - string
          - 'null'
        warehouseLocation:
          type:
          - string
          - 'null'
        currency:
          type:
          - string
          - 'null'
        volumetricWeight:
          type:
          - number
          - 'null'
          format: double
        weightUnit:
          type:
          - string
          - 'null'
        weight:
          type:
          - number
          - 'null'
          format: double
        measureUnit:
          type:
          - string
          - 'null'
        height:
          type:
          - number
          - 'null'
          format: double
        length:
          type:
          - number
          - 'null'
          format: double
        width:
          type:
          - number
          - 'null'
          format: double
        price:
          type: number
          format: double
        priceWithTax:
          type: number
          format: double
        total:
          type: number
          format: double
        totalWithTax:
          type: number
          format: double
        discountAmount:
          type: number
          format: double
        discountAmountWithTax:
          type: number
          format: double
        pickupLocationId:
          type:
          - string
          - 'null'
        fee:
          type: number
          format: double
        feeWithTax:
          type: number
          format: double
        vendorId:
          type:
          - string
          - 'null'
        comment:
          type:
          - string
          - 'null'
        taxType:
          type:
          - string
          - 'null'
        taxTotal:
          type: number
          format: double
        taxPercentRate:
          type: number
          format: double
        deliveryAddress:
          allOf:
          - $ref: '#/components/schemas/CartAddress'
        items:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/CartShipmentItem'
        discounts:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/Discount'
        taxDetails:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/TaxDetail'
        objectType:
          type:
          - string
          - 'null'
          readOnly: true
        dynamicProperties:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/DynamicObjectProperty'
        createdDate:
          type: string
          format: date-time
        modifiedDate:
          type:
          - string
          - 'null'
          format: date-time
        createdBy:
          maxLength: 64
          minLength: 0
          type:
          - string
          - 'null'
        modifiedBy:
          maxLength: 64
          minLength: 0
          type:
          - string
          - 'null'
        id:
          type:
          - string
          - 'null'
      additionalProperties: false
    CartConfigurationItem:
      type: object
      properties:
        lineItemId:
          type:
          - string
          - 'null'
        productId:
          type:
          - string
          - 'null'
        sectionId:
          type:
          - string
          - 'null'
        name:
          type:
          - string
          - 'null'
        sku:
          type:
          - string
          - 'null'
        quantity:
          type: integer
          format: int32
        listPrice:
          type: number
          format: double
        salePrice:
          type: number
          format: double
        extendedPrice:
          type: number
          format: double
          readOnly: true
        imageUrl:
          type:
          - string
          - 'null'
        catalogId:
          type:
          - string
          - 'null'
        categoryId:
          type:
          - string
          - 'null'
        type:
          type:
          - string
          - 'null'
        customText:
          type:
          - string
          - 'null'
        fi

# --- truncated at 32 KB (63 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/virto-commerce/refs/heads/main/openapi/virto-commerce-shopping-cart-api-openapi.yml