Changelog

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.