---
title: "Create cart fees"
method: POST
path: "/v3/checkout/shoppingCarts/{shoppingCartId}/fees"
tags: ["ShoppingCart"]
---

# Create cart fees

`POST /v3/checkout/shoppingCarts/{shoppingCartId}/fees`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/v3/checkout/shoppingCarts/{shoppingCartId}/fees`
- Auth: none declared. Required headers: `AD-ShoppingCart-Partner`
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/v3/checkout/shoppingCarts/:shoppingCartId/fees/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a fee and applies it to the specified cart

## Path parameters

- `shoppingCartId` string, required

## Headers

- `AD-ShoppingCart-Partner` string, required

## Request body

- Fee: The fee associated with a shopping cart
  - `id` string: Fee ID
  - `externalId` string: External ID assigned by the fee provider service
  - `createdOn` string: Fee creation date and time
  - `key` string: Key used to identify fee type
  - `currency` string: Currency code (ISO 4217) of the fee
  - `amount` number: Fee amount
  - `description` Description: Description of the fee
    - `defaultDescription` string: Description of the fee
    - `localizedDescriptions` object: Localized description texts. The default is determined by the marketplace's default locale setting.
    - `params` object: Dynamic parameters to populate within descriptions. Reserved for values whose formats need to be localized, such as dates.
  - `revenueShare` RevenueShare: Revenue shares of the fee sent to AppDirect, the marketplace owner, and the product vendor. The total of all three revenue shares must be 1.00.
    - `appdirect` number: Revenue share sent to AppDirect, as a fraction of 1.00
    - `channel` number: Revenue share sent to the marketplace owner, as a fraction of 1.00
    - `vendor` number: Revenue share sent to the product vendor, as a fraction of 1.00
  - `itemIds` string[]: List of item IDs
  - `metadata` object: Metadata

## Response `200`

OK

- Fee: The fee associated with a shopping cart
  - `id` string: Fee ID
  - `externalId` string: External ID assigned by the fee provider service
  - `createdOn` string: Fee creation date and time
  - `key` string: Key used to identify fee type
  - `currency` string: Currency code (ISO 4217) of the fee
  - `amount` number: Fee amount
  - `description` Description: Description of the fee
    - `defaultDescription` string: Description of the fee
    - `localizedDescriptions` object: Localized description texts. The default is determined by the marketplace's default locale setting.
    - `params` object: Dynamic parameters to populate within descriptions. Reserved for values whose formats need to be localized, such as dates.
  - `revenueShare` RevenueShare: Revenue shares of the fee sent to AppDirect, the marketplace owner, and the product vendor. The total of all three revenue shares must be 1.00.
    - `appdirect` number: Revenue share sent to AppDirect, as a fraction of 1.00
    - `channel` number: Revenue share sent to the marketplace owner, as a fraction of 1.00
    - `vendor` number: Revenue share sent to the product vendor, as a fraction of 1.00
  - `itemIds` string[]: List of item IDs
  - `metadata` object: Metadata

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/v3/checkout/shoppingCarts/:shoppingCartId/fees/post.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)