Loop

Introduzione

L’integrazione Loops trasforma gli eventi di Dodo Payments in eventi Loops, così le conferme di pagamento, gli aggiornamenti degli abbonamenti e le notifiche di pagamento non riuscito vengono inviate come email Loops. Una trasformazione associa ogni evento di pagamento a un evento Loops, che attiva il workflow corrispondente in Loops.

Ti serve una chiave API Loops. In Loops, vai su Impostazioni → API e genera una chiave.

Iniziare

Open the Webhook Section

Nella dashboard di Dodo Payments, vai su Developer → Webhooks e fai clic su Add endpoint.

Add endpoint dialog with Loops selected in the Integration dropdown

Select Loops

Nell’elenco Integration, seleziona Loops.

Enter API Key

Incolla la chiave API Loops nel campo API key. Dodo Payments la invia come intestazione Authorization a ogni invio. L’integrazione imposta l’URL di destinazione, quindi la chiave è l’unico valore che devi fornire.

Configure Transformation

Modifica il codice in Transformation code in modo che ogni evento diventi un evento Loops. Inizia dagli esempi riportati di seguito. In Subscribed events, seleziona gli eventi gestiti dal tuo codice.

Test & Create

In Test this code, esegui la trasformazione su un payload di esempio, quindi fai clic su Create endpoint.

Done

Ora gli eventi di pagamento attivano email tramite Loops.

Esempi di Codice di Trasformazione

Ogni esempio riscrive un tipo di evento nel corpo dell’API Loops Send an Event: un eventName, il email del contatto e eventProperties che le tue email Loops possono utilizzare.

Email di conferma del pagamento

Questo esempio invia un evento payment_confirmation quando un pagamento va a buon fine.

payment_confirmation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "payment_confirmation",
      email: p.customer.email,
      eventProperties: {
        customer_name: p.customer.name,
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        currency: p.currency || "USD",
        payment_method: p.payment_method || "unknown",
        payment_date: new Date(webhook.payload.timestamp).toLocaleDateString()
      }
    };
  }
  return webhook;
}

Email di benvenuto per l’abbonamento

Questo esempio invia un evento subscription_welcome quando un abbonamento diventa attivo.

subscription_welcome.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "subscription_welcome",
      email: s.customer.email,
      eventProperties: {
        customer_name: s.customer.name,
        subscription_id: s.subscription_id,
        product_id: s.product_id,
        amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
        frequency: s.payment_frequency_interval,
        next_billing: s.next_billing_date
      }
    };
  }
  return webhook;
}

Notifica di pagamento non riuscito

Questo esempio invia un evento payment_failed con il messaggio di errore e un link per riprovare. Sostituisci yourdomain.com con il tuo dominio.

payment_failure.js

function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "payment_failed",
      email: p.customer.email,
      eventProperties: {
        customer_name: p.customer.name,
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        error_message: p.error_message || "Payment processing failed",
        retry_link: `https://yourdomain.com/retry-payment/${p.payment_id}`
      }
    };
  }
  return webhook;
}

Suggerimenti

Assegna a ogni evento un nome descrittivo, ad esempio payment_confirmation, per mantenere organizzate le tue email Loops.
Includi le proprietà del cliente che le tue email utilizzano per la personalizzazione.
In Loops, configura un workflow e un’email per ogni nome di evento che invii.
Usa gli stessi nomi delle proprietà in tutti gli eventi.
Testa la consegna delle email prima di andare in produzione.

Risoluzione dei problemi

Emails Not Being Sent

Verifica che la chiave API sia corretta e attiva.
Verifica che ogni nome di evento corrisponda all’evento che attiva il tuo workflow Loops.
Verifica che gli indirizzi email dei destinatari siano validi.
Controlla i limiti e le quote di invio di Loops.

Transformation Errors

Verifica che il payload corrisponda al formato API Loops: un eventName, più un email o userId.
Verifica che siano presenti tutti i campi obbligatori.
Verifica che i nomi degli eventi siano formattati correttamente.
Assegna a ogni proprietà dell’evento un valore stringa, numerico, booleano o data.
Verifica le autorizzazioni della chiave API.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduzione

Iniziare

Esempi di Codice di Trasformazione

Email di conferma del pagamento

Email di benvenuto per l’abbonamento

Notifica di pagamento non riuscito

Suggerimenti

Risoluzione dei problemi

​Introduzione

​Iniziare

​Esempi di Codice di Trasformazione

​Email di conferma del pagamento

​Email di benvenuto per l’abbonamento

​Notifica di pagamento non riuscito

​Suggerimenti

​Risoluzione dei problemi

Introduzione

Iniziare

Esempi di Codice di Trasformazione

Email di conferma del pagamento

Email di benvenuto per l’abbonamento

Notifica di pagamento non riuscito

Suggerimenti

Risoluzione dei problemi