Transformaties

​

Toepassingen

• Payloads aanpassen aan het verwachte formaat van je systeem
• Webhooks omleiden naar andere URL’s op basis van de inhoud van de payload
• Eigen headers toevoegen voor authenticatie of routing
• Webhooks filteren door ongewenste te annuleren
• Data transformeren (bv. valutaformaten converteren, velden hernoemen)

​

Transformaties openen

1. Ga naar de Webhooks-instellingen in je dashboard
2. Klik op een endpoint om de details te openen
3. Ga naar het tabblad Advanced
4. Scrol naar de kaart Transformations
5. Zet de schakelaar aan om transformaties in te schakelen

​

Een transformatie schrijven

​

Inputproperties

​

Return-properties

​

Voorbeelden

​

De payload aanpassen

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;
}

​

Omleiden op basis van de payload

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

​

Eigen headers toevoegen

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

​

Specifieke webhooks annuleren

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

​

HTTP-methode wijzigen

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

​

Transformaties testen

1. Klik op Test in de transformatie-editor
2. Kies een eventtype of voer een eigen payload in
3. Bekijk de getransformeerde output
4. Verifieer dat de wijzigingen kloppen voordat je opslaat