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.