Référence API

L’API publique Kadryza permet aux merchants d’initier des transactions Mobile Money, de consulter leurs transactions et de gérer leurs endpoints webhook.

ℹ️

Les endpoints dashboard JWT, balance, settlements, rapports et API keys ne font pas partie de l’API publique documentée ici.

URLs

Environnement	URL
Production API	`https://api.kadryza.app` — domaine officiel prévu
Staging/Test temporaire	`https://api-kadryza.spencerai.tech`

Authentification

Chaque requête API publique doit inclure :

X-API-Key: kadryza_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Le mécanisme JWT du dashboard est réservé aux sessions web Kadryza. Ne l’utilisez pas pour les clés API publiques.

Format

Aspect	Convention
Content-Type	`application/json`
Dates	ISO 8601 ou `YYYY-MM-DD` pour les filtres de dates
Montants	Entiers en XAF
IDs	UUID

Pagination

Les listings publics utilisent limit et offset.

Paramètre	Défaut	Maximum	Description
`limit`	`20`	`1000`	Nombre de résultats retournés
`offset`	`0`	-	Nombre de résultats ignorés

Réponse type :

{
  "transactions": [],
  "total": 0,
  "limit": 20,
  "offset": 0
}

Endpoints publics confirmés

Transactions

Initier, récupérer et lister des transactions avec filtres serveur.

Explorer

Webhooks

Créer, lister, tester et supprimer des endpoints webhook.

Configurer

Méthode	Endpoint	Description
`POST`	`/v1/transactions`	Initier une transaction
`GET`	`/v1/transactions/:id`	Récupérer une transaction
`GET`	`/v1/transactions`	Lister les transactions
`POST`	`/v1/webhooks`	Créer un endpoint webhook
`GET`	`/v1/webhooks`	Lister les endpoints webhook
`DELETE`	`/v1/webhooks/:id`	Supprimer un endpoint webhook
`POST`	`/v1/webhooks/:id/test`	Envoyer un webhook de test

Test et production Transactions