Administrateurs JRMV
Préparer les paiements, puis vérifier les notifications.
Cette fiche explique la configuration de la plateforme. Un propriétaire utilise le parcours d’activation de son compte bénéficiaire : il n’a pas à fournir de clé API. L’installateur conserve son rôle de configuration technique des bornes.
1. Renseigner la clé du bon environnement
Dans l’administration, ouvrez Paramètres, puis Paiements Stripe. Choisissez l’onglet Stripe test ou Stripe réel avant toute saisie. Dans le tableau de bord du prestataire, ouvrez la rubrique Clés API du même compte et du même environnement. Préférez une clé restreinte aux permissions nécessaires à l’intégration.
Le champ « Clé API serveur » accepte une clé restreinte de type rk_test_ ou rk_live_, ou une clé secrète de type sk_test_ ou sk_live_. Une clé publique commençant par pk_ ne convient pas. Ne copiez ces secrets que dans les champs protégés prévus à cet effet, jamais dans un document, une capture publique ou un message de support.
JRMV masque les secrets enregistrés. Laissez un champ vide pour conserver sa valeur. Enregistrez avec la vérification d’identité demandée par votre espace administrateur. Les réglages sont ensuite contrôlés avant leur utilisation ; le passage au paiement réel reste une action distincte.
- Une permission manquante doit être corrigée sur la clé concernée ; ne cochez pas toutes les permissions par défaut.
- Le contrôle JRMV consulte notamment le compte, le solde et la configuration des notifications. Sa réussite ne teste pas toutes les opérations de paiement.
- Après remplacement d’une clé ou d’un secret, enregistrez et vérifiez à nouveau le mode concerné.
| Valeur | Où la renseigner | À retenir |
|---|---|---|
| Clé serveur rk_ ou sk_ | Clé API serveur du mode choisi | Strictement privée |
| Secret de signature whsec_ | Secret des notifications de la destination concernée | Un secret par destination et environnement |
| Clé publique pk_ | Aucun des champs serveur de cette page | Ce n’est pas un secret de notification |
2. Créer les deux destinations de notification
Une notification, ou webhook, informe JRMV d’un changement de paiement, d’abonnement ou de compte bénéficiaire. Dans la rubrique Webhooks de Workbench, créez une destination vers un endpoint webhook. Choisissez les événements complets dits snapshot pour le parcours actuel de JRMV.
La section « Configurer les notifications dans Stripe » de votre administration fournit les deux adresses exactes et leurs listes d’événements à activer. Copiez ces valeurs depuis votre espace : une adresse de test ne doit pas être utilisée pour le mode réel. La destination « Votre compte » et celle des « Comptes connectés » sont distinctes.
Pour chaque destination, récupérez son secret de signature whsec_ et renseignez le champ correspondant dans JRMV. Les deux secrets ne s’échangent pas. Enregistrez, puis lancez « Vérifier Stripe test » ou « Vérifier Stripe réel » selon le mode choisi.
- Destination manquante : vérifier son adresse, son environnement, son activation et les événements cochés.
- Signature refusée : vérifier que le secret provient de cette destination et du même environnement.
- Aucune notification signée reçue : la vérification de connexion seule ne valide pas le secret. Contrôlez une livraison issue d’un scénario de test et son apparition dans le suivi JRMV.
- Un paiement confirmé et un virement au bénéficiaire sont deux étapes différentes. Consultez leurs états séparément.
| Source choisie | Événements concernés dans JRMV | Champ du secret |
|---|---|---|
| Votre compte | Paiements plateforme, abonnements, commissions, remboursements et litiges | Secret des notifications de votre compte |
| Comptes connectés | Comptes bénéficiaires, virements et paiements réalisés dans leur périmètre | Secret des notifications des comptes connectés |
3. Réaliser un parcours en mode test
Utilisez un environnement et des moyens de paiement de test. Pour saisir une carte de test dans le formulaire prévu à cet effet, le numéro officiel 4242 4242 4242 4242 simule un paiement accepté. Indiquez une date future et un CVC de trois chiffres. N’utilisez aucune carte réelle pour cette recette.
Dans JRMV, vérifiez le libellé du mode et le contexte de la session avant de lancer le Centre de Tests. Un essai sur borne physique peut réellement démarrer la recharge et demande une confirmation. La simulation complète et les équipements virtuels doivent suivre le parcours de test prévu, sans créer de transaction commerciale.
- Contrôler la préautorisation, puis la réception de sa notification signée.
- Vérifier le départ réel de la recharge, les mesures et la fin de transaction confirmée.
- Comparer le montant calculé, la capture finale et l’état du paiement ; une puissance nulle ne clôture pas la session.
- Vérifier les cas d’annulation et d’échec dans la recette de test, puis consulter les rapports et alertes.
- Ne pas utiliser une notification de test pour fabriquer une opération réelle ni envoyer une facture fictive dans le circuit de facturation de production.
Périmètre de ce guide
Instructions adaptées aux écrans et aux contrôles de JRMV. Les types de clés, destinations de notification et données de test ont été vérifiés le 29 septembre 2026 dans les guides publics Stripe « API keys », « Webhooks » et « Testing ». Les listes d’événements affichées dans votre administration restent la référence pour votre version du logiciel.
Cette page publique ne contient ni vos paramètres enregistrés, ni vos identifiants de compte, ni aucun secret. L’accès aux actions de configuration reste protégé dans l’administration.