# Changelog

> The dated publications of the Noryo Merchant API documentation and the contract version each one contains.

Each documentation publication is dated and attached to a version of the OpenAPI contract. A new publication is added at the top of this page; the previous one stays listed.

## 2026-10-01: contract version 1.0.0

Current publication, and the first dated publication of Noryo Merchant API.

**Routes**, all under the `/merchant/v1` family:

- `POST /merchant/v1/enrichments`: enrich a raw bank descriptor;
- `GET /merchant/v1/enrichments/{enrichment_id}`: read a past result back, unbilled;
- `POST /merchant/v1/enrichments/{enrichment_id}/refresh`: recompute a known transaction and get a new `enrichment_id`.

**Behaviour described by this publication:**

- authentication by `Bearer` key shaped `nry_mer_sbx_…` or `nry_mer_live_…`, scopes `enrich:read` and `enrich:write`;
- at least one identifier per create call (`Idempotency-Key` or `external_transaction_id`), `Idempotency-Key` mandatory on refresh;
- idempotent replay over 24 hours, economic deduplication by `external_transaction_id` with no expiry;
- statuses `resolved`, `partial`, `not_found`, `refresh_recalculated`, public reasons from a closed list;
- errors in Problem Details format (RFC 9457), `code` as the machine contract;
- result content kept for 90 days, `410 result_content_expired` beyond;
- Sandbox with a lifetime allowance of 2,000 units per organisation, a rate limit of a 60-request burst and 5 per second per key.

The complete contract is available in the [API reference](https://developer.noryo.app/en-GB/merchant/reference).

---

Canonical page: https://developer.noryo.app/en-GB/merchant/governance/changelog