Webhooks
Recevoir les événements de collecte signés.
Enregistrez une URL HTTPS avec PUT /v1/merchant/webhook et le corps {"url":"https://votre.exemple/webhooks/etulip"}. Conservez immédiatement le secret retourné ; un nouvel enregistrement le remplace.
Nous envoyons un événement JSON avec X-eTulip-Event et X-eTulip-Signature: sha256=<hex>. Vérifiez le HMAC SHA-256 sur les octets bruts du corps avec votre secret webhook avant de traiter l’événement. Utilisez event_id pour éviter les doublons. Répondez rapidement avec un statut 2xx ; les échecs sont réessayés jusqu’à huit fois.
Un événement de collecte réussie contient l’identifiant, le montant, les frais, le net et les soldes opérateur avant/après. Vérifiez toujours que la transaction vous appartient ; consultez GET /v1/transactions/{id}/status si un rapprochement est nécessaire.
Le callback entrant de Qosic reste désactivé jusqu’à confirmation du contrat réel de signature et de contenu. La consultation du statut offre un autre moyen d’actualisation.