Webhooks — Vue d'ensemble

Recevez des notifications en temps réel sur le statut de vos commandes.

Configuration

L'URL et le secret HMAC se gèrent par clé API depuis Clés API. Un bouton "ping de test" est disponible pour valider votre endpoint.

Événements

order.created — commande créée et envoyée au serveur de traitement
order.updated — le statut a changé (ex : in_progress → partial)
order.completed — commande terminée

Payload

{
  "id": "evt_uuid",
  "event": "order.completed",
  "created_at": "2026-05-09T12:34:56.000Z",
  "data": {
    "id": "order_uuid",
    "status": "completed",
    "previous_status": "in_progress",
    "service_id": "uuid",
    "link": "https://instagram.com/votreprofil",
    "quantity": 1000,
    "charge_usd": 1.25,
    "start_count": 5230,
    "remains": 0,
    "provider_order_id": "12345"
  }
}

Headers

X-SocialBoost-Event: order.completed
X-SocialBoost-Timestamp: 1746792896
X-SocialBoost-Signature: t=1746792896,v1=<hex_hmac_sha256>

Retry & timeout

Timeout : 10 secondes. Si votre endpoint répond avec un code non-2xx, l'erreur est consignée dans la console Clés API. Pas de retry automatique pour le moment — vous pouvez interroger GET /orders/{id} pour récupérer le statut courant.

← GET /balance

Vérifier la signature →