Transformations

​

Cas d’usage

• Modifier les payloads pour qu’ils correspondent au format attendu par votre système
• Rediriger les webhooks vers différentes URL en fonction du contenu du payload
• Ajouter des en-têtes personnalisés pour l’authentification ou le routage
• Filtrer les webhooks en annulant ceux dont vous n’avez pas besoin
• Transformer les données (par ex. convertir des formats de devise, renommer des champs)

​

Accéder aux transformations

1. Accédez aux paramètres Webhooks dans votre tableau de bord
2. Cliquez sur un endpoint pour en afficher les détails
3. Accédez à l’onglet Advanced
4. Faites défiler jusqu’à la carte Transformations
5. Activez le switch pour activer les transformations

​

Écrire une transformation

​

Propriétés d’entrée

​

Propriétés de retour

​

Exemples

​

Modifier le payload

function handler(webhook) {
  // Add a custom field
  webhook.payload.source = "storekit";
  
  // Rename a field
  webhook.payload.orderId = webhook.payload.order_id;
  delete webhook.payload.order_id;
  
  return webhook;
}

​

Rediriger en fonction du payload

function handler(webhook) {
  if (webhook.payload.priority === "high") {
    webhook.url = "https://example.com/webhooks/priority";
  }
  return webhook;
}

​

Ajouter des en-têtes personnalisés

function handler(webhook) {
  webhook.headers = {
    "X-Custom-Header": "my-value",
    "X-Store-ID": webhook.payload.store_id
  };
  return webhook;
}

​

Annuler certains webhooks

function handler(webhook) {
  // Don't send webhooks for test orders
  if (webhook.payload.test_mode === true) {
    webhook.cancel = true;
  }
  return webhook;
}

​

Changer la méthode HTTP

function handler(webhook) {
  webhook.method = "PUT";
  return webhook;
}

​

Tester les transformations

1. Cliquez sur Test dans l’éditeur de transformation
2. Sélectionnez un type d’événement ou saisissez un payload personnalisé
3. Vérifiez la sortie transformée
4. Assurez-vous que les modifications sont correctes avant d’enregistrer