Référence API
Facturation
Endpoints de facturation côté vérificateur. Le registre de consommation fait foi. Les routes d’administration (clôture, règlement, plans) sont réservées au rôle admin.
Consommation courante
Réservé au rôle verifier, cadré par son propre identifiant. Renvoie la consommation de la période en cours pour l’environnement effectif (paramètre de requête, sinon environnement du jeton, sinon SANDBOX).
/billing/usagerôle : verifier| Champ | Type | Description |
|---|---|---|
environment | SANDBOX | PRODUCTION | Environnement ciblé (query). Défaut : celui du jeton, sinon SANDBOX. |
1curl "https://api.ayiid.example/billing/usage?environment=PRODUCTION" \2 -H "authorization: Bearer $ACCESS_TOKEN"
Factures du vérificateur
/billing/invoicesrôle : verifierRenvoie la liste des factures du vérificateur ({ "items": [...] }).
1curl https://api.ayiid.example/billing/invoices \2 -H "authorization: Bearer $ACCESS_TOKEN"
Administration
Les routes suivantes exigent le rôle admin. Elles gèrent la clôture des périodes, le règlement des factures et les plans tarifaires.
/admin/billing/closerôle : adminClôt une période et émet une facture (statut ISSUED).
/admin/billing/invoices/:id/settlerôle : adminRègle une facture via KryptaPay.
/admin/billing/plansrôle : admin/admin/billing/plans/:idrôle : admin/admin/billing/plansrôle : admin/admin/billing/plans/:idrôle : admin/admin/billing/verifiers/:id/planrôle : adminAssigne un plan à un vérificateur (null = retour au tier modèle).
/admin/billing/verifiers/:idrôle : adminFacturation courante d’un vérificateur (usage + plan résolu).