Confiance webhook

Verifiez l'evenement avant de mettre a jour la commande.

XPayr signe les charges utiles des webhooks avec votre secret. Conservez le corps brut, verifiez X-XPayr-Signature, puis traitez l'evenement de maniere idempotente.

En-tetes a lire

  • X-XPayr-Signature: Signature HMAC SHA-256 prefixee par sha256=.
  • X-XPayr-Event: type d'evenement tel que payment.completed.
  • X-XPayr-Delivery: identifiant de livraison/evenement lorsqu'il est disponible.

Extraits de Vérification Multilangages

import crypto from "node:crypto";

export function verifyXPayrWebhook(rawBody, signatureHeader, secret) {
  const received = String(signatureHeader || "").replace(/^sha256=/, "");
  const expected = crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");

  return crypto.timingSafeEqual(
    Buffer.from(received, "hex"),
    Buffer.from(expected, "hex")
  );
}

Evenements a traiter

Traitez au minimum payment.completed, payment.failed, payment.expired, test.webhook. Utilisez l'ID de session et votre propre ID de commande dans les metadonnees pour le rapprochement.

SDK NPM Officiels (v0.2.0) et Serveur MCP Distant

Intégrez Plus Vite avec les Paquets Officiels XPayr et MCP sans Installation

Installez @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)ou @xpayr/mcp-server (v1.0.0) depuis NPM, ou exécutez des appels d'outils JSON-RPC 2.0 en direct via POST https://xpayr.com/api/mcp.

Playground MCP en Direct (/tools/mcp-playground) Vérificateur de licences ES256 Simulateur de politiques d'agents IA Testeur de Webhook HMAC-SHA256 mcp.xpayr.com docs.xpayr.com api-docs.xpayr.com