Skip to navigation

Yoco API

Changed

  • Breaking change: a request for a business that hasn’t finished onboarding with Yoco returns 403 with the forbidden error code. Complete onboarding in the Yoco app to use the API.

Yoco MCP server

Changed

yoco-apimcp-serverbreaking-change

Checkout API

Added

  • Added the get-checkout endpoint for retrieving a checkout session by ID.
checkout-apinew-feature

Yoco API

Added

  • You can discount a single line item when you create an order, with line_items[].discount as a fixed amount or a percentage. The order’s discount applies on top of the line items’ own discounts.
  • You can record an order’s total and taxes as your channel charged them when creating an order, with pricing_mode supplied. Send the order’s total_amount and each line item’s taxes, naming each tax by its id from GET /v1/taxes.
yoco-apinew-featurebreaking-change

Yoco API

Added

  • Added tender to the Payment schema, so you can see which of your custom payment methods a payment was recorded against.

Fixed

yoco-apinew-featurebug-fix

Yoco API

Fixed

  • A line item’s applied_discounts[].percentage in the Order response reports the discount as a percent; a 10% line discount returns 10.00, not 1000.00.

Checkout API

Added

yoco-apicheckout-apinew-featurebug-fixbreaking-change

Yoco API

Added

  • Added service_charge_amount to the Payment schema.
  • You can link a line item to a product variant in your catalogue with variant_id when creating an order. The line takes its name and price from the catalogue.

Changed

  • Corrected the Order response schema.
yoco-apinew-featureimprovementbug-fix

Yoco API

Added

yoco-apinew-feature

Yoco API

Added

  • Added creating an order to the Orders API, with an optional payment you’ve already collected. Requires the business/orders:read and business/orders:write scopes.
yoco-apinew-feature

Yoco MCP server

Added

  • Added create_order for recording a sale as an order, with an optional payment you’ve already collected. Requires the business/orders:read and business/orders:write scopes.
  • list_orders accepts channel and external_id filters.
mcp-servernew-feature

Yoco API

Changed

  • A line item’s quantity on an order has at least three decimal places.

Fixed

  • A line item’s total_price on an order is rounded half up to the nearest cent, as the order’s amounts are. A line with a decimal quantity could report a total_price and net_amount one cent lower.
  • A discount’s percentage on an order has two decimal places, as a tax’s percentage has.
yoco-apiimprovementbug-fix

Checkout API

Added

  • Added events to the register webhook request and to webhook responses, letting you choose which events a webhook receives. Existing webhooks keep receiving the same events.
  • Added update webhook to change a webhook’s events without registering it again.
checkout-apinew-feature

Yoco API

Added

yoco-apinew-feature

Yoco API

Fixed

  • Fixed tax rates in the Order schema to report each sales tax’s configured rate instead of a default 15.00.
  • List endpoints, such as GET /v1/staff/, return 200 OK instead of 500 Internal Server Error when a request sends one bound of a date filter, such as created_at__gte, and the other bound, 31 days away, falls outside the supported date range. The other bound stops at the edge of the supported date range.
  • List endpoints return 400 Bad Request instead of 200 OK with an empty list when a date filter’s __lte bound, such as created_at__lte, is earlier than its __gte bound.
yoco-apibug-fix

Yoco API

Added

  • Added stocked_at and allocation to the CardMachine schema. allocation holds when the card machine was allocated to the business and its condition.
yoco-apinew-feature

Yoco API

Added

  • Added amounts.service_charge_amount and service_charges to the Order schema.

Changed

  • amounts.net_amount in the Order schema includes service charges.
yoco-apinew-featureimprovement

Yoco API

Added

Yoco MCP server

Added

yoco-apimcp-servernew-feature

Yoco API

Added

  • You can link a modifier to an item variant with variant_id when you create or update a modifier group, and price it with the product pricing strategy. You can also update a modifier group that holds a linked modifier.

Yoco MCP server

Added

yoco-apimcp-servernew-featurebreaking-change

Yoco API

Added

  • Added staff_id to each line item in the Order schema.
  • Added duration to each line item in the Order schema.
  • Added default_duration and the variant duration to the Item schema. You can set them when you create an item.
  • Added default_cost_price and the variant cost_price to the Item schema. You can set them when you create an item.
  • You can set each variant’s location_availability when you create or update an item. Send null to sell the variant at every location.
yoco-apimcp-servernew-featureimprovementbug-fixbreaking-change

Yoco API

Added

  • Each item variant has a location_availability. GET /v1/items and GET /v1/items/{item_id} return it with expand=location_availability, and create and update responses always include it.

Yoco MCP server

Added

yoco-apimcp-servernew-feature

Yoco MCP server

Added

  • Added catalogue tools for creating, updating and deleting items, item brands, item categories and modifier groups: create_item, update_item, delete_item, create_item_brand, update_item_brand, delete_item_brand, create_item_category, update_item_category, delete_item_category, create_modifier_group, update_modifier_group and delete_modifier_group. They require the business/catalogue:write scope.
  • Added the upload_media catalogue tool for uploading an image to attach to an item, item brand or item category. Send an image attached to the conversation or a public https link. Requires the business/catalogue:write scope.
mcp-servernew-feature