# Équipe et rôles
Invitez les personnes qui travaillent avec vous, donnez un rôle à chacune, et voyez ce que chaque rôle permet.
L’**équipe** de votre organisation, ce sont toutes les personnes qui peuvent se connecter à son
tableau de bord. Chaque personne a un **rôle** dans l’organisation, et ce rôle décide de ce qu’elle
voit et de ce qu’elle peut faire. Une personne peut appartenir à plusieurs organisations, avec un rôle
différent dans chacune, et passe de l’une à l’autre avec le sélecteur d’organisation.
## Les rôles
| Rôle | Pour | En bref |
| -------------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Propriétaire | La personne qui a créé l’organisation | Tout, y compris l’équipe et la cession de la propriété. Un seul par organisation. |
| Administrateur | Les personnes qui gèrent le compte avec le propriétaire | Tout, sauf la cession de la propriété. |
| Développeur | Les personnes qui construisent et font tourner votre intégration | Clés d’API, webhooks, journaux de requêtes et limites de l’API ; paiements et liens de paiement ; exports. Ni remboursements, ni soldes, ni équipe. |
| Finance | La comptabilité et la finance | Paiements, liens de paiement, remboursements, soldes et exports. |
| Support | Le service client | Paiements et clients, et remboursements jusqu’à un plafond par remboursement : 1 000,00 MAD par défaut. |
| Analyste | Le suivi et les rapports | Paiements, soldes et exports, en lecture seule. |
| Lecture seule | Toute personne qui doit seulement consulter | Paiements et clients, en lecture seule. |
## Ce que chaque rôle peut faire
Un ✓ signifie que le rôle peut le faire ; un tiret, qu’il ne le peut pas. Sous chaque ligne, en code, figurent
les permissions qui la portent. Le tableau de bord montre la même matrice sous **Paramètres → Équipe →
Rôles et permissions**, lue dans l’API.
| Quoi | Propriétaire | Administrateur | Développeur | Finance | Support | Analyste | Lecture seule |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | -------------- | ----------- | ------- | ------- | -------- | ------------- |
| Voir l’organisation et ses paramètres
`organizations:read` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Modifier les informations et l’image de marque de l’organisation, supprimer les données de test
`organizations:write` | ✓ | ✓ | — | — | — | — | — |
| Voir et gérer l’équipe
`team:read`
`team:write` | ✓ | ✓ | — | — | — | — | — |
| Voir, créer, renouveler et révoquer les clés d’API
`api-keys:read`
`api-keys:write` | ✓ | ✓ | ✓ | — | — | — | — |
| Lire les journaux de requêtes
`request-logs:read` | ✓ | ✓ | ✓ | — | — | — | — |
| Voir les limites de l’API
`rate-limits:read` | ✓ | ✓ | ✓ | — | — | — | — |
| Demander une limite plus élevée, et annuler la demande
`rate-limits:write` | ✓ | ✓ | ✓ | — | — | — | — |
| Voir, créer, modifier et supprimer les endpoints de webhook ; renvoyer des livraisons
`webhooks:read`
`webhooks:write`
`webhooks:delete` | ✓ | ✓ | ✓ | — | — | — | — |
| Voir les paiements, les remboursements et les clients
`payments:read` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Créer des liens de paiement, des bons espèces et des clients ; annuler des paiements
`payments:write` | ✓ | ✓ | ✓ | ✓ | — | — | — |
| Rembourser des paiements par carte
`refunds:write` | ✓ | ✓ | — | ✓ | ✓ | — | — |
| Voir les soldes
`balances:read` | ✓ | ✓ | — | ✓ | — | ✓ | — |
| Exporter des données
`exports:read` | ✓ | ✓ | ✓ | ✓ | — | ✓ | — |
* **Chaque rôle travaille en mode test.** La production s’ouvre à tous les rôles une fois votre
organisation active : voir [Liste de contrôle avant la production](https://pay-docs.adpromax.com/fr/get-started/go-live).
* **Un bouton que votre rôle ne peut pas utiliser reste sur la page**, désactivé, avec la raison :
« Votre rôle, Analyste, ne peut pas rembourser ». L’API refuse l’action de toute façon, quoi que
montre la page.
* **Le plafond du Support** s’applique à chaque remboursement. Le formulaire de remboursement
l’affiche avant la saisie du montant ; au-delà, le remboursement est refusé. Voir
[Remboursements](https://pay-docs.adpromax.com/fr/payments/refunds).
* **Les clés d’API ne sont pas des personnes.** Une clé secrète agit pour toute l’organisation, quel
que soit le rôle de la personne qui l’a créée : une clé créée par un Développeur peut rembourser par
l’API. Gardez les clés secrètes sur vos serveurs, et renouvelez celles qu’une personne a pu voir
quand cette personne s’en va. Voir [Sécurité](https://pay-docs.adpromax.com/fr/account/security).
## Inviter des personnes
1. Ouvrez **Paramètres → Équipe**, puis **Inviter des membres**.
2. Saisissez jusqu’à dix adresses e-mail et choisissez un rôle pour elles. La page montre ce que ce
rôle permet.
3. Chaque personne reçoit un e-mail avec un lien. Le lien fonctionne une seule fois, pendant sept
jours, pour cette adresse seulement.
La personne qui ouvre le lien y crée son compte. Si un compte utilise déjà cette adresse, elle se
connecte d’abord avec lui : une invitation ne fonctionne jamais pour un autre compte. Elle arrive
dans votre organisation avec le rôle choisi. D’ici là, l’invitation figure sous **Invitations**,
*En attente*, avec **Renvoyer** et **Révoquer**. **Renvoyer** envoie un nouveau lien, valable sept
jours à partir de là ; le lien envoyé avant cesse de fonctionner.
Les Propriétaires et les Administrateurs peuvent inviter, une fois leur propre adresse e-mail
vérifiée : les invitations partent en leur nom.
Une invitation est refusée quand :
* l’adresse est déjà dans l’équipe, ou a déjà une invitation en attente : renvoyez plutôt celle-là.
Une adresse refusée fait refuser toute la liste, et le message la nomme ;
* l’organisation a déjà 100 invitations en attente : révoquez-en d’abord ;
* trop d’e-mails sont partis : une organisation envoie au plus 100 e-mails d’invitation en 24 heures,
une personne 200 pour toutes ses organisations, une adresse en reçoit au plus 5, et une invitation
est renvoyée au plus une fois par minute.
Personne n’est invité comme Propriétaire : la propriété se cède (ci-dessous).
## Changer un rôle ou retirer quelqu’un
Ouvrez la page de la personne depuis **Paramètres → Équipe**. **Changer le rôle** lui donne un autre
rôle ; **Retirer le membre** la sort de l’équipe, après confirmation. La page Équipe montre aussi,
pour chaque personne, son rôle, si la vérification en deux étapes est activée, et sa dernière
activité.
* Personne ne reçoit le rôle de Propriétaire de cette façon : la propriété se cède (ci-dessous).
* Personne ne peut changer son propre rôle.
* Le Propriétaire ne peut pas être retiré.
Une personne retirée perd l’accès à l’organisation tout de suite : chaque requête est vérifiée auprès
de l’équipe, pas seulement la connexion. Les invitations qu’elle avait envoyées et qui attendent
encore sont révoquées avec elle, comme elles le sont quand un nouveau rôle ne lui permet plus de
gérer l’équipe.
## Quitter une organisation
Tout membre sauf le Propriétaire peut partir de lui-même, avec **Quitter l’organisation** sur le
tableau de bord. Vous perdez l’accès tout de suite, et il faudra vous inviter de nouveau pour
revenir. Le Propriétaire cède d’abord la propriété.
## Céder la propriété
Seul le Propriétaire peut le faire : **Paramètres → Équipe → Transférer la propriété**, choisissez un
membre de l’équipe et confirmez. Le nouveau Propriétaire doit être un membre actif, quelqu’un qui a
accepté son invitation, et ne pas posséder déjà 20 organisations. Il reçoit tous les droits, et vous
devenez Administrateur. Votre organisation a un seul Propriétaire à tout moment.
## Plus tard
* La vérification en deux étapes demandée de nouveau avant une modification de l’équipe.
* Des rôles sur mesure, au-delà des sept ci-dessus.
Nous annoncerons chacun dans le [journal des modifications](https://pay-docs.adpromax.com/fr/changelog).