Skip to main content
Chaque SDK couvre tous les endpoints de la référence et fait pour vous ce que la doc demande de faire à la main :
  • les nouvelles tentatives après une coupure, un 429 ou une erreur 5xx, avec la même Idempotency-Key à chaque tentative, générée si vous n’en donnez pas ;
  • la pagination : une boucle parcourt toutes les pages ;
  • des erreurs typées avec code, param et request_id ;
  • la vérification des webhooks (MercyPay-Signature, tolérance de 5 minutes, plusieurs v1 acceptés après une rotation du secret).
Le code est public, dans l’organisation mercy-pay sur GitHub.

SDK serveur

Envoyez ensuite le client sur session.checkout_url.

Vérifier un webhook

Une signature fausse ou trop ancienne lève une erreur : répondez 400. Voir Recevoir un webhook.

Par framework

Votre clé API reste sur votre serveur. Une app React, Flutter ou mobile ne l’appelle jamais directement : elle demande à votre serveur de créer la session, puis ouvre checkout_url, ou affiche le formulaire intégré avec le client_secret de la session.

En local

La ligne de commande relaie les webhooks vers votre ordinateur et déclenche des événements de test, quel que soit le SDK.

Versions

Chaque SDK suit SemVer et parle à l’API v1. Le journal de chaque version est dans le CHANGELOG.md de son dépôt, et une faille se signale à security@mercy-pay.com.
  • Les SDK sont en 0.x : une version mineure (0.2.0) peut encore changer une signature. Elle le dit alors dans son journal. Une version corrective (0.1.1) ne casse jamais rien.
  • Ils passeront en 1.0.0 une fois les paramètres typés en place. Ensuite, rien de cassant sans nouvelle version majeure, comme pour l’API.
  • Fixez la version mineure dans vos dépendances, par exemple ^0.1 en PHP ou ~0.1.0 en Node, et lisez le journal avant de monter.