# Référence API — Merchant API

Noryo Merchant API · Version `2026-10-01` · Serveur `https://api.noryo.app`

Enrichir un descripteur de transaction bancaire en une identité de marchand.

Trois routes, pas de lot. La version appartient à la **famille** — `/merchant/v1` —
pour que `merchant/v2` puisse vivre à côté de `merchant/v1` au lieu de le remplacer.

**L'hôte ne fait pas partie du contrat.** Noryo peut servir cette API depuis plus d'un
domaine. Aucun nom d'hôte n'entre dans une identité, dans une empreinte ni dans une
signature ; n'en codez aucun en dur ailleurs que dans la configuration de votre URL de base.

## Authentification

- `bearerCredential` — http bearer. `Authorization: Bearer nry_mer_sbx_<key_id>.<secret>` Le préfixe porte l'environnement : `nry_mer_sbx_` pour le Bac à sable, `nry_mer_live_` pour la Production. Le secret est affiché **une seule fois**, à la création, et n'est jamais récupérable. Il n'existe pas d'opération de rotation : pour remplacer une clé, créez-en une nouvelle, déployez-la, puis révoquez l'ancienne.

## Opérations

| Méthode | Chemin | Résumé |
| --- | --- | --- |
| `POST` | [`/merchant/v1/enrichments`](https://developer.noryo.app/fr-FR/merchant/reference/create-enrichment) | Enrichir un descripteur de transaction |
| `GET` | [`/merchant/v1/enrichments/{enrichment_id}`](https://developer.noryo.app/fr-FR/merchant/reference/get-enrichment) | Relire un enrichissement passé |
| `POST` | [`/merchant/v1/enrichments/{enrichment_id}/refresh`](https://developer.noryo.app/fr-FR/merchant/reference/refresh-enrichment) | Recalculer un enrichissement |

## Erreurs

[Erreurs — Merchant API](https://developer.noryo.app/fr-FR/errors)

## Spécification OpenAPI

[noryo-merchant-v1.yaml](https://developer.noryo.app/openapi) (YAML)

---

Page canonique : https://developer.noryo.app/fr-FR/merchant/reference