Checkout API
Added
- Added the get-checkout endpoint for retrieving a checkout session by ID.
Yoco API
Added
- You can discount a single line item when you create an order, with
line_items[].discountas a fixed amount or a percentage. The order’sdiscountapplies 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_modesupplied. Send the order’stotal_amountand each line item’staxes, naming each tax by its id fromGET /v1/taxes.
Yoco API
Added
- Added
tenderto thePaymentschema, so you can see which of your custom payment methods a payment was recorded against.
Fixed
- Payments and refunds that were reversed, or whose reversal failed, have
statusfailed, and filtering payments or refunds bystatus=failedreturns them. Fetching them, or an order that includes them, returns200 OKinstead of500 Internal Server ErrorfromGET /v1/payments/,GET /v1/payments/{payment_id},GET /v1/refunds/,GET /v1/refunds/{refund_id},GET /v1/orders/andGET /v1/orders/{order_id}.
Yoco API
Added
- Added
service_charge_amountto thePaymentschema. - You can link a line item to a product variant in your catalogue with
variant_idwhen creating an order. The line takes its name and price from the catalogue.
Changed
- Corrected the
Orderresponse schema.
Yoco API
Added
- You can send an
Idempotency-Keyheader when creating an order. See Idempotency.
Yoco API
Added
- Added creating an order to the Orders API, with an optional
payment you’ve already collected. Requires the
business/orders:readandbusiness/orders:writescopes.
Yoco MCP server
Added
- Added
create_orderfor recording a sale as an order, with an optional payment you’ve already collected. Requires thebusiness/orders:readandbusiness/orders:writescopes. list_ordersacceptschannelandexternal_idfilters.
Checkout API
Added
- Added
eventsto 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
eventswithout registering it again.
Yoco API
Added
- Added the
service_unavailableerror code.
Yoco API
Fixed
- Fixed tax rates in the
Orderschema to report each sales tax’s configured rate instead of a default15.00. - List endpoints, such as
GET /v1/staff/, return200 OKinstead of500 Internal Server Errorwhen a request sends one bound of a date filter, such ascreated_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 Requestinstead of200 OKwith an empty list when a date filter’s__ltebound, such ascreated_at__lte, is earlier than its__gtebound.
Yoco API
Added
- Added
stocked_atandallocationto theCardMachineschema.allocationholds when the card machine was allocated to the business and its condition.
Yoco API
Added
- Added
statusto theLocationschema. You can filterGET /v1/locations/bystatus.
Yoco MCP server
Added
Yoco API
Added
- Added
staff_idto each line item in theOrderschema. - Added
durationto each line item in theOrderschema. - Added
default_durationand the variantdurationto theItemschema. You can set them when you create an item. - Added
default_cost_priceand the variantcost_priceto theItemschema. You can set them when you create an item. - You can set each variant’s
location_availabilitywhen you create or update an item. Sendnullto sell the variant at every location.
Yoco API
Added
- Each item variant has a
location_availability.GET /v1/itemsandGET /v1/items/{item_id}return it withexpand=location_availability, and create and update responses always include it.
Yoco MCP server
Added
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_groupanddelete_modifier_group. They require thebusiness/catalogue:writescope. - Added the
upload_mediacatalogue tool for uploading an image to attach to an item, item brand or item category. Send an image attached to the conversation or a publichttpslink. Requires thebusiness/catalogue:writescope.