Vai al contenuto principale

GitHub Repository

Boilerplate minimale Go + Dodo Payments

Panoramica

Il boilerplate Go fornisce un punto di partenza pronto per la produzione per integrare Dodo Payments con il tuo backend Go. Questo template include la gestione delle sessioni di checkout, la verifica dei webhook, l’integrazione del portale clienti e segue le migliori pratiche di Go per aiutarti ad accettare pagamenti rapidamente.
Questo boilerplate utilizza Go 1.21+ con pattern di clean architecture (cmd, internal, templates), template HTML e l’SDK dodopayments-go per un’integrazione API senza soluzione di continuità.

Caratteristiche

  • Configurazione rapida - Inizia in meno di 5 minuti
  • Integrazione dei pagamenti - Flusso di checkout preconfigurato usando l’SDK dodopayments-go
  • Interfaccia moderna - Pagina dei prezzi pulita a tema scuro con template HTML
  • Gestione webhook - Verifica e processa in modo sicuro gli eventi di pagamento
  • Portale clienti - Gestione self-service degli abbonamenti
  • Best practice Go - Architettura pulita con cmd, internal e templates
  • Checkout precompilato - Dimostra il passaggio dei dati cliente per migliorare l’esperienza utente

Requisiti

Prima di iniziare, assicurati di avere:
  • Go 1.21+
  • Account Dodo Payments (per accedere alle chiavi API e Webhook dal dashboard)

Avvio Rapido

1

Clone the Repository

2

Install Dependencies

O manualmente:
3

Get API Credentials

Registrati su Dodo Payments e ottieni le tue credenziali dalla dashboard:
Assicurati di essere in Modalità Test durante lo sviluppo!
4

Configure Environment Variables

Crea un file .env nella directory principale:
Aggiorna i valori con le tue credenziali Dodo Payments:
.env
Non inserire mai il file .env nel controllo versione. È già incluso in .gitignore.
5

Add Your Products

Aggiorna internal/lib/products.go con i tuoi ID prodotto effettivi da Dodo Payments:
6

Run the Development Server

O manualmente:
Apri http://localhost:8000 per vedere la tua pagina di pricing!
Dovresti vedere una pagina dei prezzi a tema scuro con i tuoi prodotti pronta all’acquisto.

Struttura del Progetto

Endpoint API

Il boilerplate include i seguenti endpoint preconfigurati:

Personalizzazione

Aggiorna le Informazioni sul Prodotto

Modifica internal/lib/products.go per variare:
  • ID dei prodotti (dal tuo dashboard Dodo)
  • Prezzi
  • Funzionalità
  • Descrizioni

Pre-compila i Dati del Cliente

In templates/index.html, sostituisci i dati cliente hardcodati con i dati reali dei tuoi utenti:
In un’app di produzione, inietteresti dinamicamente questi valori dal tuo sistema di autenticazione.

Eventi Webhook

Il boilerplate dimostra la gestione degli eventi webhook in internal/api/webhook.go. Gli eventi supportati includono: Aggiungi la tua logica aziendale all’interno del gestore webhook per:
  • Aggiornare i permessi utente nel tuo database
  • Inviare email di conferma
  • Fornire accesso a prodotti digitali
  • Monitorare analisi e metriche

Testare i Webhook Localmente

Per lo sviluppo locale, utilizza strumenti come ngrok per esporre il tuo server locale:
Aggiorna l’URL del webhook nel tuo Dashboard Dodo Payments:

Distribuzione

Compila per la Produzione

O manualmente:

Distribuisci su Vercel

[ Distribuisci con Vercel ](https://vercel.com/new/clone?repository-url=https://github.com/dodopayments/go-boilerplate)

Docker

Crea un Dockerfile:
Compila ed esegui:

Considerazioni per la Produzione

Prima di distribuire in produzione:
  • Passa DODO_PAYMENTS_ENVIRONMENT a live_mode
  • Usa le chiavi API di produzione dalla dashboard
  • Aggiorna l’URL del webhook al tuo dominio di produzione
  • Abilita HTTPS per tutti gli endpoint

Risoluzione dei Problemi

Assicurati che i moduli Go siano correttamente scaricati:
Cause comuni:
  • ID prodotto non valido - verifica che esista nella tua dashboard Dodo
  • Chiave API o impostazione ambiente errate in .env
  • Controlla i log del server per messaggi di errore dettagliati
Per i test locali, usa ngrok per esporre il tuo server:
Aggiorna l’URL del webhook nella tua dashboard Dodo con l’URL di ngrok. Assicurati di aggiornare il file .env con la chiave di verifica del webhook corretta.
Assicurati di eseguire il server dalla directory principale del progetto, oppure che il percorso dei template sia configurato correttamente nel tuo codice.

Scopri di più

Go SDK

Documentazione completa SDK Go

Webhooks Documentation

Scopri tutti gli eventi webhook e le best practice

Checkout Sessions

Approfondimento sulla configurazione della sessione di checkout

API Reference

Documentazione completa dell’API Dodo Payments

Supporto

Hai bisogno di aiuto con il boilerplate?
Ultima modifica il 1 aprile 2026