Créer un abonnement webhook pour une entreprise marchande (API Fournisseur de services)
Crée un abonnement webhook au niveau entreprise pour une entreprise marchande intégrée (maximum 1 par marchand).
Prérequis :
- Le fournisseur de services doit avoir intégré l’entreprise marchande (via
/business_onboarding) - L’URL doit être HTTPS
Cas d’usage :
- Recevoir
TRANSACTION_COMPLETEDpour les paiements des sous-marchands - Configurer la réconciliation après l’onboarding, comme pour
/business_api_keys
Notes importantes :
- Le secret HMAC est retourné une seule fois à la création — stockez-le de manière sécurisée
- Un second abonnement actif pour le même marchand renvoie
409
Authentification : Nécessite les en-têtes de clé API. L’entreprise authentifiée doit être un fournisseur de services.
Authorizations
Clé API pour les requêtes de l'API Partenaire
Body
Schéma de requête pour créer un abonnement webhook pour une entreprise marchande
Identifiant de l'entreprise marchande (doit être une entreprise intégrée par le fournisseur de services)
"59ae202a-f583-4a15-970f-9e99bd1e0baa"
URL HTTPS du webhook
"https://partner.example.com/webhooks/jeko"
Nom optionnel pour identifier l'abonnement
255"Webhook production"
Événements à recevoir (optionnel — tous les événements si omis)
Événement d'abonnement webhook
TRANSACTION_COMPLETED Response
Abonnement webhook créé avec succès
Abonnement webhook créé — le secret HMAC est retourné une seule fois
"b7e2c1a0-4f3d-4a8e-9c1b-2d5e6f7a8b9c"
"https://partner.example.com/webhooks/jeko"
"59ae202a-f583-4a15-970f-9e99bd1e0baa"
"2024-01-15T14:30:25.000Z"
"2024-01-15T14:30:25.000Z"
Secret de signature HMAC. Retourné une seule fois à la création. Stockez-le de manière sécurisée car il ne peut pas être récupéré plus tard.
"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"
"Webhook production"
Événement d'abonnement webhook
TRANSACTION_COMPLETED