R??f??rence API

L’API REST Kadryza vous permet d’initier des paiements Mobile Money, de consulter le statut des transactions et de g??rer les webhooks de mani??re programmatique.

URL de base

https://api.kadryza.app

Toutes les requ??tes API utilisent cette URL comme pr??fixe. Les endpoints sont versionn??s :

https://api.kadryza.app/v1/transactions
https://api.kadryza.app/v1/transactions/:id

Authentification

Chaque requ??te doit inclure votre cl?? API dans le header Authorization :

Authorization: Bearer kadryza_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Consultez le guide d’authentification pour les d??tails complets.

Format des requ??tes

Format des r??ponses

Toutes les r??ponses sont en JSON. Les r??ponses r??ussies contiennent directement les donn??es :

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "reference": "order_2025_001",
  "status": "PENDING"
}

Les r??ponses d’erreur suivent un format uniforme :

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Description lisible de l'erreur",
    "status": 400,
    "fields": {
      "amount": "Le montant doit ??tre un entier positif"
    }
  }
}

Consultez la page codes d’erreur pour la liste exhaustive.

Pagination

Les endpoints qui retournent des listes utilisent une pagination par page :

{
  "data": [ /* ... r??sultats ... */ ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 142,
    "total_pages": 8
  }
}

Rate limiting

L’API applique des limites de requ??tes pour garantir la stabilit?? du service :

En cas de d??passement, l’API retourne 429 Too Many Requests avec un header Retry-After.

Endpoints disponibles