Commission Tool

get_commission_rates

View the current commission rate structure for this store. Returns the default rate applied to all products, plus any per-category or per-product overrides.

Parameters

This tool takes no parameters.

Response

Returns an object with the store's commission rate configuration.

Field	Type	Description
`default_rate`	number	Default commission rate as a decimal (e.g., 0.08 = 8%). Applied to all products unless overridden.
`category_rates`	array \| null	Per-category rate overrides. Currently reserved for future use; typically `null`.
`product_rates`	array \| null	Per-product rate overrides. Currently reserved for future use; typically `null`.

Response

{
  "default_rate": 0.08,
  "category_rates": null,
  "product_rates": null
}

Default rate

If no commission configuration has been set by the merchant, the default rate is 0.08 (8%). Campaign bonuses stack on top of this rate. See Agent Commissions for how the effective rate is calculated.

Example with Rate Overrides

When a merchant configures per-category or per-product rates, the response includes those overrides. Product-level rates take priority over category-level rates, which take priority over the default rate.

Response with overrides

{
  "default_rate": 0.08,
  "category_rates": [
    { "category": "Electronics", "rate": 0.05 },
    { "category": "Apparel", "rate": 0.12 }
  ],
  "product_rates": [
    { "product_public_id": "prod_abc123", "rate": 0.15 }
  ]
}

Errors

Error	Cause
`{"error": "Store not found"}`	Internal store lookup failure. Retry the request; if persistent, the store may have been removed.