Changelog

2026-09 — v1

La première version de l’API publique de Kivoo.

Clés API

Des clés par boutique, préfixées kv_live_, montrées une seule fois, avec une expiration facultative et dix clés actives au plus par boutique.
Des portées par ressource : Boutique et Commandes en lecture, Produits, Acheteurs et Liens de paiement en lecture et écriture.
Une limite de débit de 120 requêtes par minute et par clé.

API publique (https://api.kivoo.africa/v1)

Boutique : GET /v1/store.
Produits : lister, lire, modifier et publier (GET /v1/products, GET /v1/products/{id}, PATCH /v1/products/{id}).
Commandes : lister et lire (GET /v1/orders, GET /v1/orders/{id}).
Acheteurs : lister, lire, créer, modifier (GET et POST /v1/customers, GET et PATCH /v1/customers/{id}).
Liens de paiement : lister, lire, créer, modifier, suspendre et réactiver (/v1/payment-links).

Webhooks

Jusqu’à cinq webhooks HTTPS par boutique et six événements webhook : order.paid, order.failed, customer.created, product.published, product.archived, payment_link.paid, plus ping pour les tests.
Une signature Kivoo-Signature (HMAC-SHA256) et un identifiant d’événement stable pour l’idempotence.
Huit tentatives sur un peu plus de vingt-deux heures, un journal des livraisons de trente jours, le renvoi manuel et la désactivation automatique après trois jours d’échecs.