webhook_subscription_duplicate

Statut HTTP : 409 · Rejouable : non — la subscription existe déjà.

Cause

Vous avez tenté de créer une subscription webhook pour une URL d'endpoint qui en a déjà une dans le même environnement. L'unicité porte sur le couple (URL, environnement) : la même URL peut donc être enregistrée une fois en sandbox et une fois en production.

Ce cas arrive typiquement lors d'un rejeu de provisioning, ou quand deux déploiements enregistrent le même endpoint.

Réponse

HTTP/1.1 409 Conflict
Content-Type: application/problem+json

{
  "type": "https://docs.pesia.fr/partner/errors/webhook_subscription_duplicate",
  "title": "Webhook Subscription Duplicate",
  "status": 409,
  "detail": "A webhook subscription already exists for this endpoint URL in this environment.",
  "code": "webhook_subscription_duplicate",
  "instance": "/partner/v1/webhooks/subscriptions",
  "timestamp": "2026-08-14T09:12:44.318Z"
}

Extensions

Aucune — seuls les champs standard ci-dessus.

Que faire

• Lister vos subscriptions existantes avant de recréer :

  curl -s https://api.pesia.fr/partner/v1/webhooks/subscriptions \
    -H "Authorization: Bearer $TOKEN" \
  | jq -r '.data.items[] | "\(.id) \(.endpointUrl)"'

• Pour changer les événements écoutés ou réactiver un endpoint, mettre à jour la subscription existante plutôt que d'en créer une seconde.

• Rendre votre provisioning idempotent : chercher d'abord, créer seulement si absent. Un 409 ici n'est pas une panne — c'est le signe que l'état voulu est déjà en place.

Voir aussi : Webhooks · Tous les codes d'erreur