Configuration
Configurez la destination et les abonnements de votre organisation via la Platform ou l’API.
Chaque organisation possède une destination de webhook et un signing secret (secret de signature) actif. Configurez-les dans la Platform ou depuis votre serveur.
| Détail | Valeur |
|---|---|
| URL de base | https://api.sandbox.tapaya.com pour la sandbox, https://api.tapaya.com pour la production |
| Authentification | Server Secret Token dans Authorization. Consultez Authentification. |
| Portée | Une destination par organisation |
| Guide associé | Vérifier et tester |
Configurer dans la Platform
Ouvrez API Keys pour votre organisation et recherchez Webhooks.
- Saisissez votre URL HTTPS publique.
- Choisissez les événements dont vous avez besoin, ou activez Subscribe to all webhook types.
- Activez Enable et cliquez sur Save.
- Copiez le signing secret et stockez-le sur votre serveur.
- Envoyez un webhook de test.
Le signing secret n’est affiché qu’une seule fois
Copiez-le lorsque vous créez la destination ou renouvelez son secret ; il ne pourra pas être récupéré ultérieurement. Il sert uniquement à vérifier les webhooks entrants. Votre Server Secret Token autorise les requêtes de configuration.
Toutes les opérations
| Opération | À utiliser pour |
|---|---|
| Enregistrer une destination | Créer ou remplacer l’abonnement actuel, ou renouveler son signing secret. |
| Lire une destination | Récupérer l’URL actuelle, le mode d’abonnement et l’état d’activation. |
| Supprimer une destination | Supprimer l’abonnement ainsi que sa file d’attente et son historique de livraison. |
Gérer la destination
Règles de la destination
Modifier les paramètres
| Lorsque vous | Ce qui se passe |
|---|---|
| Modifiez l’URL, les événements ou le secret | Les nouveaux événements utilisent les nouveaux paramètres. Les événements en attente conservent l’ancienne URL et l’ancien secret : gardez-les tous deux fonctionnels jusqu’à ce que la file d’attente soit vidée. |
| Désactivez les webhooks | Les livraisons en attente sont suspendues et aucun nouvel événement n’est enregistré. La réactivation reprend le traitement de la file, mais les changements manqués ne sont pas rattrapés. Les tests fonctionnent toujours. |
| Supprimez la destination | Les événements en attente et l’historique de livraison sont supprimés. Une requête déjà en cours peut encore arriver. La recréer génère un nouveau signing secret. |
Exigences relatives à l’URL
- HTTPS public sur le port 443. Localhost et les réseaux privés sont rejetés, et le DNS est vérifié à nouveau à chaque connexion.
- Aucun identifiant intégré, aucun fragment et aucune redirection.
- Aucun en-tête d’autorisation personnalisé. Vérifiez plutôt la signature Tapaya, ou placez un adaptateur côté serveur devant une URL qui exige sa propre clé.
Erreurs
Les requêtes de configuration échouent avec ces réponses. Un récepteur qui refuse ou manque une livraison est un problème différent ; consultez Gérer les erreurs.
| Réponse | Signification |
|---|---|
400 sur PUT | URL invalide, type d’événement non pris en charge, champ obligatoire manquant ou sélection explicite d’événements vide. |
401 | Le Server Secret Token est manquant ou invalide. |
404 sur GET | Aucune destination n’existe pour l’organisation authentifiée. |
Poursuivez avec la vérification des signatures et le test de livraison.
Il manque quelque chose sur cette page ?Demandez une fonctionnalité. Nous joignons cette page pour que l’équipe ait le contexte.