Changelog

Every dated version of the API and what changed in it. The current version is 2026-10-11. A version is served for at least 12 months after the next one is published.

2026-10-11

The first version of the Orrerie Merchant API.

126 endpoints across 21 resources, under https://api.orrerie.com/v1. The API reference has a page for each.
115 webhook event types, each with a complete example payload. See every event.
180 error codes, each with its own entry on the errors page, which is where every doc_url points.
Test mode with simulated payments, and helper endpoints that drive the same states as live mode. See test mode.
Refunds, payouts, conversions and saved addresses can be requested by the API and are approved by a person in the dashboard with a passkey. See money out.

How versions work

A key is pinned to the newest version at the moment it is created. Send Orrerie-Version to use another for one request. What counts as a breaking change is on conventions.