API Reference

L'API ToonaPay est une API REST/JSON montée sous /api/v1. La spécification complète (OpenAPI) est exposée par le backend :

• UI interactive : https://api.toonapay.io/docs
• JSON : https://api.toonapay.io/docs/json

Référence toujours synchronisée

La référence détaillée est générée automatiquement depuis le Swagger du backend (node scripts/gen-api-docs.mjs). Elle reflète le contrat réel — jamais de documentation obsolète.

Conventions

• Base URL : https://api.toonapay.io/api/v1
• Réponses : { "data": ... } ou { "error": { "code", "message" } }
• Authentification : Authorization: Bearer <accessToken> (JWT 15 min)
• Idempotence : clé idempotencyKey sur les créations de paiement
• Montants : entiers en unités minimales (jamais de flottants)
• Pagination : ?page=&limit=

Modules

Module	Description
Authentification	Register, login, 2FA, sessions, refresh
Paiements	Créer, consulter, annuler, simuler, rembourser
Webhooks	Callbacks providers (signature HMAC)
Marchand	Boutiques, QR, employés, rapports, intégration
Personnel	Moyens, transactions, reçus, dépenses, support
Staff	Transactions, marchands, KYC, commissions, audit

Environnements

Environnement	Base URL
Sandbox	https://api.toonapay.io/api/v1 (clés sk_test_)
Live	https://api.toonapay.io/api/v1 (clés sk_live_)