Aller au contenu principal

API Webhooks

Gérez les endpoints webhook de manière programmatique.

Famille de routes actuellement implémentée : webhook_endpoints

Objet Webhook Endpoint

{
"id": "we_abc123",
"object": "webhook_endpoint",
"url": "https://yoursite.com/webhooks/ikawaari",
"events": ["payment_intent.succeeded", "payment_intent.payment_failed"],
"enabled": true,
"secret": "whsec_...xxxx",
"created": 1708300800
}

Endpoints

MéthodeEndpointDescription
POST/webhook_endpointsCréer un endpoint webhook
GET/webhook_endpoints/{id}Récupérer un endpoint webhook
GET/webhook_endpointsLister les endpoints webhook
POST/webhook_endpoints/{id}Mettre à jour un endpoint webhook
POST/webhook_endpoints/{id}/rotate_secretFaire tourner un secret de signature webhook

Les API du dashboard marchand exposent aussi des opérations supplémentaires de gestion des webhooks sous les familles de routes marchandes, notamment pour les tests, les replays et l’inspection des tentatives.

Créer un endpoint webhook

POST /webhook_endpoints
ParamètreTypeRequisDescription
urlstringURL recevant les événements webhook
eventsstring[]Liste des types d’événements auxquels s’abonner
enabledbooleanIndique si l’endpoint est actif (par défaut : true)