Skip to main content

Introduzione

L’integrazione con Discord pubblica pagamenti, abbonamenti, contestazioni e altri eventi Dodo Payments in un canale Discord a tua scelta. Il tuo team visualizza ogni evento nel luogo in cui collabora già, senza dover eseguire il polling di un’API o controllare una dashboard.
Devi avere accesso a Developer → Webhooks nella dashboard di Dodo Payments e l’autorizzazione Manage Webhooks nel server Discord.

Iniziare

1

Create a Discord Webhook

In Discord, apri il canale che deve ricevere le notifiche e fai clic su Edit Channel. Vai a Integrations → Webhooks → New Webhook, assegna un nome al webhook, conferma il canale e fai clic su Copy Webhook URL.
2

Open the Webhook Section

Nel dashboard di Dodo Payments, vai su Developer → Webhooks e fai clic su Add endpoint.
Finestra di dialogo Add endpoint con Discord selezionato nel menu a discesa Integration
3

Select Discord

In Integration, seleziona Discord. Il pannello How to connect Discord ripete i passaggi per creare il webhook Discord.
4

Paste the Webhook URL

Incolla l’URL del webhook Discord, che inizia con https://discord.com/api/webhooks/, in Endpoint URL. Discord non richiede una API key.
5

Select Events

In Subscribed events, seleziona gli eventi gestiti dalla trasformazione. Discord rifiuta un messaggio che non contiene content o embeds, quindi un evento che la trasformazione non converte non verrà recapitato.
6

Edit Transformation Code

In Transformation code, personalizza il modo in cui ogni evento viene associato a un embed Discord oppure parti dagli esempi.
7

Test & Create

In Test this code, fai clic su Simulate per visualizzare in anteprima l’embed relativo a un payload di esempio. Quindi fai clic su Create endpoint.
8

Done

Il tuo canale Discord ora riceve un messaggio per ogni evento sottoscritto.

Esempi di codice di trasformazione

Ogni gestore sostituisce webhook.payload con un messaggio Discord che contiene un embed. Gli importi di Dodo Payments sono espressi nell’unità monetaria più piccola, quindi gli esempi dividono per 100 e mostrano il codice della valuta.

Embed di pagamento minimo

Pubblica un embed quando un pagamento va a buon fine (payment.succeeded):
payment_embed.js

Eventi degli abbonamenti

Pubblica un embed quando un abbonamento diventa attivo (subscription.active) o viene annullato (subscription.cancelled):
subscription_embed.js

Avvisi sulle contestazioni

Pubblica un embed per ogni evento relativo a una contestazione, come dispute.opened, dispute.won e dispute.lost. Il titolo e il colore seguono dispute_status della contestazione:
dispute_embed.js

Suggerimenti

  • Usa gli embed per una formattazione avanzata e per i colori.
  • Mantieni brevi i titoli e inserisci i dettagli nei campi.
  • Usa colori che indichino l’esito: verde per il successo, rosso per il fallimento e arancione per gli avvisi.

Risoluzione dei problemi

  • Verifica che il webhook esista ancora in Integrations → Webhooks del canale e che Endpoint URL corrisponda al relativo URL.
  • Verifica che la trasformazione restituisca un oggetto JSON con embeds.
  • Verifica che Subscribed events includa gli eventi previsti.
  • Apri i tentativi di consegna dell’endpoint nella scheda Logs di Developer → Webhooks per visualizzare il codice di risposta di Discord.
  • Convalida il codice nell’editor. Gli errori di sintassi bloccano la consegna.
  • Verifica che i nomi dei campi corrispondano alla struttura del payload del webhook.
Ultima modifica il 28 settembre 2026