# Vue d'ensemble

> Ce qu'est Platform, comment on y entre avec son identité Noryo, ce que contient l'espace de travail créé à l'ouverture, et qui peut y faire quoi selon son rôle.

Platform, à l'adresse `https://platform.noryo.app`, est l'espace où vous gérez votre compte pour les API de Noryo : Merchant API et Transaction Intelligence. On y crée et révoque des clés, on y lit l'usage, on y remplit ce que chaque étape exige, et on y suit les demandes d'accès production et la facturation. Le fonctionnement des API est décrit dans ce portail ; Platform répond à une autre question : où en est votre compte.

> **Info** Les écrans de Platform sont en français. Ce guide cite leurs libellés tels qu'ils s'affichent.

## 1. Se connecter

Platform n'a pas de page de connexion à elle, et aucun mot de passe ne s'y saisit. Ouvrez `https://platform.noryo.app` et suivez **Continuer vers la connexion** : vous vous identifiez avec votre identité Noryo sur le portail d'authentification, `https://auth.noryo.app`, qui vous ramène ensuite à la page demandée.

## 2. Ouvrir Platform sur votre identité

Si votre identité Noryo n'a pas encore accès à Platform, la page le dit et propose **Ouvrir Developer Platform**. Il n'y a ni second compte à créer, ni second mot de passe : seulement un accès à ajouter à votre identité, sur le portail d'authentification.

## 3. Retrouver votre espace de travail

À l'ouverture de cet accès, si vous n'êtes encore membre d'aucune organisation, Platform en crée une pour vous, avec un espace de travail du même nom, et vous en fait **owner**. L'organisation reçoit un nom par défaut, « Mon organisation » : le vrai nom se donne dans le [profil développeur](https://developer.noryo.app/fr-FR/platform/developer-profile). Aucune clé n'est créée à ce moment-là ; une clé reste toujours un geste volontaire.

Si vous êtes déjà membre d'une organisation, rien de nouveau n'est créé. Un compte qui n'est membre d'aucune organisation voit la page « Aucun espace marchand » : ce n'est pas une panne.

## Organisation, espace de travail, membres

Une **organisation** est le client des API. Un **espace de travail** (workspace) appartient à une organisation : c'est lui qui porte les clés, l'usage, les profils, les demandes d'accès production, le contrat accepté et la facturation. La page Vue d'ensemble affiche en tête le nom de l'organisation, celui de l'espace de travail, l'environnement (Sandbox) et votre rôle.

Vous êtes membre d'une organisation avec un rôle, et ce rôle vaut pour ses espaces de travail. Platform ne propose pas d'écran pour inviter un membre ou changer un rôle.

## Qui peut faire quoi

Cinq rôles existent : owner, admin, developer, billing et viewer. Tout membre voit les pages, les clés, l'usage et les états ; les gestes, eux, dépendent du rôle.

| Geste | owner | admin | developer | billing | viewer |
|---|---|---|---|---|---|
| Créer ou révoquer une clé Merchant API Sandbox | oui | oui | oui | oui | oui |
| Activer le sandbox Transaction Intelligence | oui | oui | non | non | non |
| Créer ou révoquer une clé Transaction Intelligence Sandbox | oui | oui | oui | non | non |
| Renseigner le profil développeur | oui | oui | non | non | non |
| Renseigner l'identité juridique, répondre à un justificatif | oui | oui | non | non | non |
| Accepter le contrat Transaction Intelligence | oui | oui | non | non | non |
| Déposer, compléter ou retirer la demande d'accès production Transaction Intelligence | oui | oui | non | non | non |
| Créer une clé Transaction Intelligence de production | oui | oui | non | non | non |
| Déposer le dossier Mode Production de Merchant API | oui | oui | oui | oui | oui |
| Ajouter ou remplacer le moyen de paiement | oui | oui | oui | oui | oui |
| Transmettre un retour d'utilisateur final | oui | oui | oui | oui | oui |

Chaque geste est vérifié par le serveur, à partir de votre identité et de votre appartenance ; l'identifiant d'espace que porte une page ne sert qu'à choisir, jamais à autoriser. Une page ne propose un geste qu'à qui le serveur l'accorderait, et un refus éventuel s'affiche tel que le serveur l'écrit.

## Les pages de Platform

| Page | Ce qu'on y fait |
|---|---|
| [Vue d'ensemble](https://platform.noryo.app/) | L'organisation, l'espace, votre rôle, la dotation Sandbox de Merchant API, les appels récents et l'état du mode Production de Merchant API |
| [Clés d'API](https://platform.noryo.app/keys) | Activer le sandbox Transaction Intelligence, créer et révoquer des clés. Voir [Clés d'API](https://developer.noryo.app/fr-FR/platform/keys) |
| [Usage](https://platform.noryo.app/usage) | Lire l'usage de chaque produit. Voir [Usage](https://developer.noryo.app/fr-FR/platform/usage) |
| [Retours](https://platform.noryo.app/feedback) | Transmettre une correction signalée par un de vos utilisateurs. Voir [Retours et corrections](https://developer.noryo.app/fr-FR/platform/feedback) |
| [Facturation](https://platform.noryo.app/billing) | Tarif, identité de facturation, moyen de paiement, factures et sommes dues. Voir [Facturation](https://developer.noryo.app/fr-FR/platform/billing) |
| [Profil développeur](https://platform.noryo.app/profile) | Le profil qui ouvre le sandbox Transaction Intelligence. Voir [Profil développeur](https://developer.noryo.app/fr-FR/platform/developer-profile) |
| [Identité juridique](https://platform.noryo.app/legal-profile) | Qui accepte le contrat, depuis quelle adresse, et les justificatifs demandés. Voir [Identité juridique et contrat](https://developer.noryo.app/fr-FR/platform/legal-identity-and-contract) |
| [Contrat](https://platform.noryo.app/contract) | Le contrat Transaction Intelligence en vigueur et son acceptation |
| [Mode Production](https://platform.noryo.app/production) | Le dossier production de Merchant API. Voir [Accès production](https://developer.noryo.app/fr-FR/platform/production-access) |
| [Production Transaction Intelligence](https://platform.noryo.app/production-ti) | La demande d'accès production de Transaction Intelligence et ses conditions |

## Quand l'espace de travail n'est pas disponible

Si l'espace de travail, ou l'organisation dont il dépend, n'est pas actif, Platform le dit et nomme la cause, l'organisation d'abord : une organisation suspendue rend tous ses espaces indisponibles, et corriger l'espace n'y changerait rien. Les gestes sont alors refusés, les clés existantes restent listées, et une requête faite avec une clé intacte reçoit `403 account_inactive`. Ce n'est pas une révocation, et créer une nouvelle clé n'y change rien : cela se reprend avec Noryo. Voir [account_inactive](https://developer.noryo.app/fr-FR/errors/account_inactive).

## Pour aller plus loin

- [Profil développeur](https://developer.noryo.app/fr-FR/platform/developer-profile) : ce qu'il contient et ce qu'il ouvre.
- [Clés d'API](https://developer.noryo.app/fr-FR/platform/keys) : le cycle de vie d'une clé, pour les deux produits.
- [Quickstart Merchant API](https://developer.noryo.app/fr-FR/merchant/quickstart) et [Quickstart Transaction Intelligence](https://developer.noryo.app/fr-FR/transaction-intelligence/quickstart) : de la clé au premier appel.

---

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