Passage en production
Comment s'ouvre la Production : moyen de paiement, dossier déposé sur Platform, examen par Noryo, et les conditions d'une clé live. Et ce qui change, ou non, dans votre code.
La Production n'est pas en libre-service. Vous déposez un dossier, une personne chez Noryo l'examine, et la décision lui appartient. Cette page décrit le parcours et ce qui change dans votre intégration une fois la Production ouverte.
1. Terminer l'intégration en Sandbox
Le Sandbox sert le même contrat et le même moteur que la Production. Avant de déposer un dossier, vérifiez la liste de contrôle en bas de cette page : une intégration correcte en Sandbox l'est en Production.
2. Enregistrer un moyen de paiement
Avant l'examen, vous devez avoir enregistré un moyen de paiement : Noryo n'ouvre pas une Production qu'il ne pourrait pas encaisser.
3. Déposer le dossier
Le dossier se dépose dans la page Mode Production de Platform. Il demande :
| Champ | Contenu attendu |
|---|---|
| Identité légale | La raison sociale exacte, telle qu'immatriculée |
| Courriel de contact | Obligatoire |
| Téléphone de contact | Obligatoire |
| URL du produit | Ou, à défaut, au moins une capture d'écran (une URL par ligne) : l'un des deux est exigé |
| Volumétrie estimée | Par exemple : 50 000 transactions par mois |
| Cas d'usage | Ce que vous faites de l'enrichissement |
4. L'examen
Déposer un dossier ne l'approuve pas. Vous suivez son état et son historique dans la même page, sans pouvoir le faire avancer vous-même : la mise en revue, l'approbation, le rejet, la suspension et la reprise sont des gestes internes à Noryo.
| État | Signification |
|---|---|
| Déposé | En attente de prise en charge |
| En revue | Examiné par Noryo |
| Approuvé | La Production est ouverte |
| Rejeté | La Production n'est pas ouverte ; un motif est affiché |
| Suspendu | La Production a été suspendue ; un motif est affiché |
Les motifs appartiennent à une liste fermée : identité non vérifiable, produit absent ou inaccessible, usage hors contrat, volumétrie incohérente, soupçon de fraude, conformité insuffisante, dossier incomplet, prélèvement refusé, autre.
5. Une fois approuvé
L'usage est compté au fil de vos appels, chaque mois civil est clôturé automatiquement, et la facture est prélevée sur le moyen de paiement enregistré. Voir Facturation.
Une clé de Production (nry_mer_live_…) ne peut exister que pour un espace de travail dont le dossier est approuvé et qui détient un abonnement actif. Platform n'en crée pas : elle n'émet que des clés Sandbox.
Ce qui change dans votre code
| Élément | Sandbox | Production |
|---|---|---|
| URL de base | identique | identique |
| Clé | nry_mer_sbx_… | nry_mer_live_… |
enrichment.environment | sandbox | production |
usage.billable | toujours false | true pour resolved et refresh_recalculated |
| Limites de débit | publiées | non publiées : lisez Noryo-RateLimit-Limit |
Rien d'autre ne change : même contrat, mêmes champs, mêmes codes d'erreur. Les données ne passent pas d'un environnement à l'autre : un enrichment_id Sandbox n'est pas lisible avec la clé de Production, et vos external_transaction_id repartent de zéro.
Erreurs propres à la Production
| Code | Statut | Signification |
|---|---|---|
production_not_enabled | 403 | La clé n'est pas autorisée à appeler l'environnement de Production |
no_active_subscription | 402 | Aucun abonnement actif ne couvre l'opération |
pricing_not_activated | 503 | La facturation n'est pas encore activée pour cette opération ; réessayez après Retry-After. Le Sandbox peut aussi le rendre |
Liste de contrôle avant de basculer
- Chaque création porte une
Idempotency-Keyet unexternal_transaction_id. Voir Les deux identifiants. - Les reprises gardent la même
Idempotency-Keyet respectentRetry-After. Voir Reprises. - Votre logique lit
enrichment.statusavantmerchant, et traitenot_foundcomme un résultat. Voir Lire une réponse. - Votre comptabilité ignore
usagesur les réponses portantNoryo-Idempotency-Replayed: true. Voir Facturation. - Vous stockez ce dont vous avez besoin : le contenu d'un résultat expire au bout de 90 jours. Voir Rétention et 410.
- Vous journalisez
Noryo-Request-Idpour chaque appel. Voir Identifiants de requête. - La clé live vit côté serveur, jamais dans un navigateur ou une application mobile. Voir Sécurité des secrets.
Publié le 2026-10-08 21:04 UTC (version 1).