Go Boilerplate

GitHub Repository

Minimal Go + Dodo Payments-boilerplate

Översikt

Go-boilerplate-koden är en minimal Go-server som säljer dina Dodo Payments-produkter från en prissida. Den skapar checkout-sessioner, verifierar och hanterar webhooks samt öppnar Customer Portal. Klona den som utgångspunkt för din egen Go-backend.

Boilerplate-koden kräver Go 1.24.4 eller senare, den version som anges i go.mod. Den använder en layout med cmd, internal och templates, renderar prissidan med Go HTML-mallar och anropar Dodo Payments API via dodopayments-go SDK.

Funktioner

Snabb installation: Klona repositoryt, lägg till dina API-nycklar i .env och starta servern med make run.
Betalningsintegration: Ett checkout-flöde som skapar checkout-sessioner med dodopayments-go SDK.
Modernt gränssnitt: En mörk prissida byggd med Go HTML-mallar och Tailwind CSS.
Webhook-hantering: Verifierar signaturen för varje webhook innan händelsen behandlas.
Customer Portal: Självbetjänad prenumerationshantering via Customer Portal.
Go-bästa praxis: En ren projektlayout med cmd, internal och templates.
Förifylld checkout: Skickar kundens namn och e-postadress till checkout, så att kunden inte behöver ange dem igen.

Förutsättningar

Innan du börjar behöver du:

Go 1.24.4 eller senare. Kontrollera din version med go version.
Ett Dodo Payments-konto, för att skapa en API-nyckel och en webhook-signeringsnyckel i instrumentpanelen.
Minst en produkt, skapad under Products i instrumentpanelen.

Snabbstart

Clone the Repository

git clone https://github.com/dodopayments/go-boilerplate.git
cd go-boilerplate

Install Dependencies

make install

make install kör go mod download och därefter go mod tidy. Om du vill hämta modulerna utan make kör du:

go mod download

Get API Credentials

Registrera dig på Dodo Payments och kopiera sedan båda nycklarna från instrumentpanelen:

API-nyckel: Developer → API Keys
Webhook-nyckel: Developer → Webhooks. Varje webhook-endpoint har en egen signerigsnyckel. Information om hur du skapar en endpoint som når din lokala server finns i Testa webhooks lokalt.

Skapa båda nycklarna i testläge medan du utvecklar. Växla till testläge genom att stänga av reglaget Live Mode i sidofältet i instrumentpanelen.

Configure Environment Variables

Skapa en fil med namnet .env i projektroten från mallen:

cp .env.example .env

Ange dessa värden i .env:

.env

DODO_PAYMENTS_API_KEY=your_api_key_here
DODO_PAYMENTS_WEBHOOK_KEY=your_webhook_signing_key_here
DODO_PAYMENTS_RETURN_URL=http://localhost:8000
DODO_PAYMENTS_ENVIRONMENT=test_mode
PORT=8000

Servern läser dessa variabler vid start:

Variabel	Krävs	Standardvärde	Syfte
`DODO_PAYMENTS_API_KEY`	Ja	None	Autentiserar förfrågningar till Dodo Payments API.
`DODO_PAYMENTS_WEBHOOK_KEY`	Ja	None	Verifierar signaturen för inkommande webhooks.
`DODO_PAYMENTS_RETURN_URL`	Nej	`http://localhost:8080`	URL:en som checkout skickar kunden till efter betalningen.
`DODO_PAYMENTS_ENVIRONMENT`	Nej	`test_mode`	`test_mode` eller `live_mode`.
`PORT`	Nej	`8000`	Porten som servern lyssnar på.

Servern avslutas vid start om någon av de obligatoriska nycklarna saknas. .env.example anger PORT och DODO_PAYMENTS_RETURN_URL till port 8080. Den här sidan använder port 8000, så ange båda till 8000 enligt exemplet, eller ersätt 8000 med 8080 i kommandona på den här sidan.

Checka aldrig in filen .env i versionshanteringen. Repositoryts .gitignore utesluter den redan.

Add Your Products

Ersätt exempelprodukten i internal/lib/products.go med dina produkter. Kopiera varje produkt-ID från Products i instrumentpanelen:

var Products = []Product{
    {
        ProductID:   "pdt_001", // Replace with your product ID
        Name:        "Basic Plan",
        Description: "Get access to basic features and support",
        Price:       9999, // in cents
        Features: []string{
            "Access to basic features",
            "Email support",
            "1 Team member",
            "Basic analytics",
        },
    },
    // ... add more products
}

Price anger endast priset som prissidan visar, i den minsta valutaenheten: 9999 visas som $99.99. Checkout debiterar produktens pris i Dodo Payments.

Run the Development Server

make run

make run bygger servern till bin/server och startar den. Om du vill köra servern utan att först bygga en binärfil kör du:

go run cmd/server/main.go

Öppna http://localhost:8000 för att se din prissida.

Du ser en mörk prissida som listar dina produkter och är redo för köp.

Projektstruktur

Repositoryt har följande layout:

go-boilerplate/
├── cmd/
│   └── server/             # Application entry point (main.go)
├── internal/
│   ├── api/                # API handlers: checkout.go, portal.go, webhook.go
│   ├── core/               # Configuration loading (config.go)
│   └── lib/                # Shared logic: products.go, customers.go
├── templates/              # HTML templates: base.html, index.html
├── Makefile                # Build and run commands
├── go.mod                  # Go module definition
├── go.sum                  # Dependency checksums
├── .env.example            # Environment template
└── README.md

API-endpoints

Boilerplate-koden innehåller följande förkonfigurerade endpoints:

Endpoint	Metod	Beskrivning
`/`	GET	Prissida som listar produkterna i `internal/lib/products.go`.
`/api/checkout`	POST	Skapar en checkout-session. Skicka `product_id` samt valfria `quantity` (standardvärde `1`) och `customer` (`email`, `name`, `phone`). Returnerar `session_id` och `checkout_url`.
`/api/webhook`	POST	Verifierar och hanterar Dodo Payments-webhooks. Returnerar `401` när signaturkontrollen misslyckas.
`/api/customer-portal`	POST	Returnerar en Customer Portal-länk i `portal_url`. Skicka `customer_id` eller `email` med en valfri `name`. Om endast en e-postadress anges söker handlern efter kunden och skapar kunden om ingen finns.
`/health`	GET	Hälsokontroll. Returnerar `OK`.

Anpassning

Uppdatera produktinformation

Redigera internal/lib/products.go för att ändra:

Produkt-ID:n (från Products i din Dodo Payments-instrumentpanel)
Namn
Priser som visas på prissidan
Funktioner
Beskrivningar

var Products = []Product{
    {
        ProductID:   "pdt_001", // Replace with your product ID
        Name:        "Basic Plan",
        Description: "Get access to basic features and support",
        Price:       9999,
        Features: []string{
            "Access to basic features",
            "Email support",
            "1 Team member",
            "Basic analytics",
        },
    },
}

Mallen för prissidan lägger till suffixet /mo på varje pris och visar Custom i stället för ett pris när Price är 100000 eller högre. Ändra detta genom att redigera templates/index.html.

Förifyll kunddata

I .env skickar funktionen handleCheckout hårdkodad kunddata till /api/checkout. Ersätt den med data från din inloggade användare:

const customerData = {
    name: "John Doe",       // Replace with actual logged-in user's name
    email: "john@example.com"  // Replace with actual logged-in user's email
};

Funktionen handlePortal återanvänder dessa kunddata och använder samma exempel på namn och e-postadress som reservvärden. I en produktionsapp injicerar du dessa värden från ditt autentiseringssystem i båda funktionerna.

Webhook-händelser

internal/api/webhook.go verifierar varje förfrågan med client.Webhooks.Unwrap och nyckeln i DODO_PAYMENTS_WEBHOOK_KEY och dirigerar sedan händelsen utifrån dess type. Dessa händelser har en handler, och varje handler loggar händelsedata:

Händelse	Beskrivning
`payment.succeeded`	Utlöses när en betalning lyckas
`payment.failed`	Utlöses när ett betalningsförsök misslyckas
`subscription.active`	Utlöses när en prenumeration blir aktiv
`subscription.renewed`	Utlöses när en prenumeration förnyas för nästa faktureringsperiod
`subscription.updated`	Utlöses när något prenumerationsfält ändras
`subscription.cancelled`	Utlöses när en prenumeration avslutas

Handlern accepterar även subscription.on_hold, subscription.failed, subscription.expired och subscription.plan_changed utan någon åtgärd och loggar alla andra händelsetyper som ohanterade. Den svarar med 200 på varje verifierad händelse. Se Webhook Event Guide för alla händelsetyper. Lägg till din affärslogik i handler-funktionerna för att:

Uppdatera användarbehörigheter i databasen
Skicka bekräftelsemeddelanden
Ge åtkomst till digitala produkter
Spåra analysdata och mätvärden

Testa webhooks lokalt

Dodo Payments kan inte nå localhost. Om du vill ta emot webhooks under utvecklingen exponerar du din lokala server med en tunnel som ngrok:

ngrok http 8000

I Dodo Payments Dashboard lägger du till en endpoint med vidarebefordrings-URL:en som ngrok visar, följt av /api/webhook:

https://your-ngrok-url.ngrok.io/api/webhook

Kopiera endpointens signerigsnyckel till DODO_PAYMENTS_WEBHOOK_KEY och starta sedan om servern.

Driftsättning

Bygg för produktion

make build kompilerar servern till bin/server:

make build

Om du vill bygga och starta den binära filen utan make kör du:

go build -o bin/server cmd/server/main.go
./bin/server

Distribuera till Vercel

[

](https://vercel.com/new/clone?repository-url=https://github.com/dodopayments/go-boilerplate) När du har distribuerat lägger du till variablerna från filen .env i Vercel-projektets inställningar, eftersom .env inte finns i repositoryt. Ange sedan din webhook-endpoint i instrumentpanelen till https://yourdomain.com/api/webhook.

Docker

Skapa en Dockerfile i projektroten. Byggsteget måste använda Go 1.24.4 eller senare för att matcha go.mod:

FROM golang:1.24-alpine AS builder

WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download

COPY . .
RUN go build -o bin/server cmd/server/main.go

FROM alpine:latest
WORKDIR /app
COPY --from=builder /app/bin/server .
COPY --from=builder /app/templates ./templates

EXPOSE 8000
CMD ["./server"]

Den slutliga avbildningen kopierar templates/ bredvid den binära filen, eftersom servern läser mallarna från arbetskatalogen. Bygg och kör avbildningen:

docker build -t go-dodo .
docker run -p 8000:8000 --env-file .env go-dodo

Containern lyssnar på värdet PORT från .env, så låt PORT=8000 matcha portmappningen.

Överväganden för produktion

Innan du distribuerar till produktion:

Ange DODO_PAYMENTS_ENVIRONMENT till live_mode.
Använd en API-nyckel i live-läge från instrumentpanelen.
Rikta webhook-endpointen mot din produktionsdomän och använd endpointens signerigsnyckel.
Ange DODO_PAYMENTS_RETURN_URL till en sida på din produktionsdomän.
Leverera alla endpoints via HTTPS.

Felsökning

Build errors or missing dependencies

Kontrollera att go version rapporterar Go 1.24.4 eller senare och hämta sedan modulerna igen:

go mod tidy
go mod download

Checkout session creation fails

Vanliga orsaker:

Produkt-ID:t är ogiltigt. Kontrollera att det finns under Products i samma läge som din API-nyckel.
API-nyckeln eller DODO_PAYMENTS_ENVIRONMENT i .env är felaktig. En nyckel i testläge behöver test_mode.
Kontrollera serverloggarna för det exakta felet. Handlern loggar varje misslyckad förfrågan innan den returnerar 500.

Webhooks not receiving events

För lokal testning exponerar du servern med ngrok:

ngrok http 8000

Ange webhook-URL:en i din Dodo Payments-instrumentpanel till ngrok-URL:en. Ange sedan DODO_PAYMENTS_WEBHOOK_KEY i .env till endpointens signerigsnyckel. Om servern loggar webhook verification failed matchar nyckeln inte endpointen.

Templates not loading

Servern läser templates/base.html och templates/index.html från arbetskatalogen. Starta servern från projektroten eller ändra mallsökvägarna i cmd/server/main.go.

Läs mer

Go SDK

Fullständig Go SDK-dokumentation

Webhooks Documentation

Läs om alla webhook-händelser och bästa praxis

Checkout Sessions

Fördjupa dig i konfiguration av checkout-sessioner

API Reference

Fullständig dokumentation för Dodo Payments API

Support

Om du behöver hjälp med boilerplate-koden:

Ställ frågor i Discord-communityt.
Se GitHub-repositoryt för problem och uppdateringar.
Kontakta supportteamet.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

GitHub Repository

Översikt

Funktioner

Förutsättningar

Snabbstart

Projektstruktur

API-endpoints

Anpassning

Uppdatera produktinformation

Förifyll kunddata

Webhook-händelser

Testa webhooks lokalt

Driftsättning

Bygg för produktion

Distribuera till Vercel

Docker

Överväganden för produktion

Felsökning

Läs mer

Go SDK

Webhooks Documentation

Checkout Sessions

API Reference

Support

GitHub Repository

​Översikt

​Funktioner

​Förutsättningar

​Snabbstart

​Projektstruktur

​API-endpoints

​Anpassning

​Uppdatera produktinformation

​Förifyll kunddata

​Webhook-händelser

​Testa webhooks lokalt

​Driftsättning

​Bygg för produktion

​Distribuera till Vercel

​Docker

​Överväganden för produktion

​Felsökning

​Läs mer

Go SDK

Webhooks Documentation

Checkout Sessions

API Reference

​Support

Översikt

Funktioner

Förutsättningar

Snabbstart

Projektstruktur

API-endpoints

Anpassning

Uppdatera produktinformation

Förifyll kunddata

Webhook-händelser

Testa webhooks lokalt

Driftsättning

Bygg för produktion

Distribuera till Vercel

Docker

Överväganden för produktion

Felsökning

Läs mer

Support