Parcourir la documentation

Référence API

Authentification

Des clés gm_live_, un en-tête Bearer, et ce que le serveur conserve.

Toutes les routes /v1/* exigent une clé API, à l'exception du webhook de paiement, que ClicToPay appelle directement et que la passerelle vérifie de son côté.

L'en-tête#

Authorization: Bearer gm_live_...

Le format des clés#

Une clé est le préfixe gm_live_ suivi de 32 octets aléatoires encodés en base64url. Le serveur n'en stocke jamais la valeur : il conserve sha256(clé) et un préfixe de 11 caractères, uniquement pour que vous puissiez reconnaître vos clés dans la liste.

Révoquer#

Une clé se supprime depuis Clés API sur gamra.dev. La révocation prend effet immédiatement : la requête suivante reçoit un 401 avec le code invalid_api_key.

Suivre une requête#

Toute réponse de la route de proxy porte un en-tête x-gamra-request-id. Enregistrez-le. C'est le même identifiant que celui du registre de consommation, et c'est ce qui permet de retrouver une requête précise en cas de litige.