mercypay est la ligne de commande de Mercy Pay. Elle sert pendant le développement : tester un gestionnaire de webhooks en local sans l’exposer sur Internet, provoquer un événement précis, suivre vos appels à l’API.
Installer
.zip de la dernière version. Le code est sur GitHub.
Se connecter
- Votre navigateur s’ouvre sur Mercy Pay. Connectez-vous si besoin.
- Vérifiez que le code affiché est celui de votre terminal.
- Choisissez la boutique, puis Autoriser la CLI.
CLI <nom de votre ordinateur>, rangée dans le trousseau de votre système. Seuls les propriétaires, administrateurs et développeurs d’une boutique peuvent l’autoriser. La clé se révoque dans Développeurs, onglet Clés API, comme les autres.
Pour travailler avec une autre clé, live comprise, passez-la vous-même : mercypay login --api-key mp_live_…, l’option --api-key sur n’importe quelle commande, ou la variable MERCYPAY_API_KEY. mercypay status affiche le compte et l’environnement de la clé utilisée.
Recevoir vos webhooks en local
POST à cette adresse, avec le même corps et les mêmes en-têtes qu’un vrai webhook, signé avec MercyPay-Signature. Votre code de vérification n’a rien à changer.
Le secret de signature s’affiche au démarrage. Il reste le même d’un lancement à l’autre : mettez-le dans la configuration de votre application locale à la place du secret de votre endpoint. mercypay listen --print-secret l’affiche seul.
- La CLI lit les nouveaux événements toutes les 2 secondes. Rien n’a besoin d’être ouvert sur votre réseau.
--events payment.succeeded,payment.failedne relaie que ces types.- Sans
--forward-to, les événements s’affichent seulement. - Vos endpoints enregistrés continuent de recevoir les événements comme d’habitude.
Déclencher un événement de test
mercypay listen. Rien d’autre n’est créé : pas de paiement, pas de mouvement de solde. Les identifiants ne renvoient à aucun objet, et metadata.test_helper vaut true quand l’objet a des métadonnées.
Pour tester un parcours complet, avec un vrai paiement en sandbox, utilisez plutôt les numéros de test.
Vous pouvez aussi déclencher un événement sans la CLI, avec POST /api/v1/test_helpers/events.
Suivre vos appels à l’API
Request-Id. Les corps des requêtes restent dans la console développeurs.
Appeler l’API
mercypay <ressource> <action>. mercypay get, post, patch et delete appellent n’importe quel chemin.
Un
POST porte toujours une Idempotency-Key : si la CLI relance la requête après une coupure ou une erreur 5xx, rien n’est créé en double. -i ma-cle choisit la clé. La réponse s’affiche en JSON ; en cas d’erreur, la commande se termine avec le code 1 et affiche le Request-Id.
Plusieurs boutiques
--profile garde une connexion séparée par boutique :
~/.config/mercypay/config.json. Les clés sont dans le trousseau du système, ou dans ce fichier, lisible par vous seul, quand il n’y en a pas.