Trasformazioni

​

Casi d’uso

• Modificare i payload per adattarli al formato atteso dal tuo sistema
• Reindirizzare i webhook a URL diversi in base al contenuto del payload
• Aggiungere header personalizzati per autenticazione o instradamento
• Filtrare i webhook annullando quelli che non ti servono
• Trasformare i dati (ad es. convertire formati di valuta, rinominare campi)

​

Accedere alle trasformazioni

1. Vai alle impostazioni Webhook nella tua dashboard
2. Clicca su un endpoint per visualizzarne i dettagli
3. Naviga nella scheda Advanced
4. Scorri fino alla scheda Transformations
5. Attiva l’interruttore per abilitare le trasformazioni

​

Scrivere una trasformazione

​

Proprietà di input

​

Proprietà di ritorno

​

Esempi

​

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

​

Reindirizzare in base al payload

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

​

Aggiungere header personalizzati

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

​

Annullare webhook specifici

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

​

Cambiare il metodo HTTP

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

​

Testare le trasformazioni

1. Clicca Test nell’editor delle trasformazioni
2. Seleziona un tipo di evento o inserisci un payload personalizzato
3. Rivedi l’output trasformato
4. Verifica che le modifiche siano corrette prima di salvare