Boutiko

Développeurs

API Boutiko

Reliez votre boutique à vos outils : facturation, tableur, automatisations. Les montants sont des entiers dans la monnaie de la boutique. L'API ne montre jamais la commission, le taux, le solde ni les retraits : seulement le prix payé et ce que vous recevez (seller_net).

Fichier OpenAPI (openapi.json)

Authentification

Créez une clé dans Réglages > Développeurs en choisissant ses permissions. Elle n'est affichée qu'une fois ; vous pouvez la révoquer à tout moment.

Exemple d'appel
curl https://getboutiko.com/api/v1/produits \
  -H "Authorization: Bearer bk_live_VOTRE_CLE"

Routes

Créer un produit

Créer un produit
curl -X POST https://getboutiko.com/api/v1/produits \
  -H "Authorization: Bearer bk_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: creation-guide-2026-11-10" \
  -d '{"title":"Guide Excel","kind":"files","price":5000}'

Le produit est créé en brouillon. Les règles du site s'appliquent : prix minimum, et pour publier un fichier, une leçon publiée ou les détails de la prestation. Même Idempotency-Key + même corps = même réponse (24 h).

Pagination, limites et erreurs

Webhooks

Événements : order.paid, order.refunded, product.published. Adresse https obligatoire. Chaque envoi porte l'en-tête Boutiko-Signature: t=HORODATAGE,v1=SIGNATURE : HMAC-SHA256 de HORODATAGE.CORPS avec votre secret whsec_…. Refusez les messages de plus de 5 minutes. En cas d'échec, nouveaux essais après 1 min, 5 min, 30 min, 2 h et 12 h.

Vérifier la signature (Node.js)
// Node.js : vérifier la signature
import { createHmac, timingSafeEqual } from "node:crypto";
function verifier(corps, entete, secret) {
  const { t, v1 } = Object.fromEntries(entete.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const attendu = createHmac("sha256", secret).update(`${t}.${corps}`).digest("hex");
  return timingSafeEqual(Buffer.from(attendu), Buffer.from(v1));
}
Exemple de message reçu
{
  "id": "…", "type": "order.paid", "created_at": "2026-11-10T10:00:00Z",
  "data": { "reference": "BK-7CCFF34E", "amount_paid": 5000, "seller_net": 4500, "currency": "XOF", … }
}