Hoppa till huvudinnehåll

GitHub Repository

Minimal Go + Dodo Payments-boilerplate

Översikt

Go boilerplate ger en produktionsklar startpunkt för att integrera Dodo Payments med din Go backend. Denna mall inkluderar hantering av checkout-sessioner, verifiering av webhooks, integration av kundportal och följer Go:s bästa praxis för att hjälpa dig att börja ta emot betalningar snabbt.
Detta boilerplate använder Go 1.21+ med ren arkitektur (cmd, internal, templates), HTML-mallar och dodopayments-go SDK för sömlös API-integrering.

Funktioner

  • Snabb uppstart – Kom igång på under 5 minuter
  • Betalintegration – Förkonfigurerat checkout-flöde med dodopayments-go SDK
  • Modern UI – Ren, mörkprydd prislista med HTML-mallar
  • Webhook-hantering – Verifiera och bearbeta betalevents säkert
  • Kundportal – Självbetjäningshantering av prenumerationer
  • Go-bästa praxis – Ren arkitektur med cmd, internal och templates
  • Förifylld checkout – Visar hur du skickar kunddata för att förbättra UX

Förutsättningar

Innan du börjar, se till att du har:
  • Go 1.21+
  • Dodo Payments-konto (för att få tillgång till API- och Webhook-nycklar från instrumentpanelen)

Snabbstart

1

Clone the Repository

2

Install Dependencies

Eller manuellt:
3

Get API Credentials

Registrera dig på Dodo Payments och hämta dina uppgifter från instrumentpanelen:
Se till att du är i testläge medan du utvecklar!
4

Configure Environment Variables

Skapa en .env-fil i rotkatalogen:
Uppdatera värdena med dina Dodo Payments-uppgifter:
.env
Lägg aldrig till din .env-fil i versionskontrollen. Den ingår redan i .gitignore.
5

Add Your Products

Uppdatera internal/lib/products.go med dina faktiska produkt-ID:n från Dodo Payments:
6

Run the Development Server

Eller manuellt:
Öppna http://localhost:8000 för att se din prissättningssida!
Du bör se en mörkprydd prislista med dina produkter redo att köpas.

Projektstruktur

API-endpunkter

Boilerplate inkluderar följande förkonfigurerade endpunkter:

Anpassning

Uppdatera produktinformation

Redigera internal/lib/products.go för att ändra:
  • Produkt-ID:n (från din Dodo-instrumentpanel)
  • Prissättning
  • Funktioner
  • Beskrivningar

Förifyll kunddata

I templates/index.html, ersätt de hårdkodade kunduppgifterna med dina faktiska användaruppgifter:
I en produktionsapp skulle du dynamiskt injicera dessa värden från ditt autentiseringssystem.

Webhook-händelser

Boilerplaten visar hur webhook-events hanteras i internal/api/webhook.go. Stöd för följande events ingår: Lägg till din affärslogik inuti webhook-hanteraren för att:
  • Uppdatera användarbehörigheter i din databas
  • Skicka bekräftelsemail
  • Tillhandahålla åtkomst till digitala produkter
  • Spåra analyser och mätvärden

Testa webhooks lokalt

För lokal utveckling, använd verktyg som ngrok för att exponera din lokala server:
Uppdatera webhook-URL:en i din Dodo Payments Dashboard:

Distribution

Bygg för produktion

Eller manuellt:

Distribuera till Vercel

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

Docker

Skapa en Dockerfile:
Bygg och kör:

Produktionsöverväganden

Innan du distribuerar till produktion:
  • Byt DODO_PAYMENTS_ENVIRONMENT till live_mode
  • Använd produktions-API-nycklar från instrumentpanelen
  • Uppdatera webhook-URL:en till din produktionsdomän
  • Aktivera HTTPS för alla endpoints

Felsökning

Se till att Go-moduler laddas ner korrekt:
Vanliga orsaker:
  • Ogiltigt produkt-ID – verifiera att det finns i din Dodo-instrumentpanel
  • Fel API-nyckel eller miljöinställning i .env
  • Kontrollera serverloggarna för detaljerade felmeddelanden
För lokal testning, använd ngrok för att exponera din server:
Uppdatera webhook-URL:en i din Dodo-instrumentpanel till ngrok-URL:en. Se till att uppdatera din .env-fil med rätt webhook-verifieringsnyckel.
Se till att du kör servern från projektets rotkatalog, eller att mallvägen är korrekt konfigurerad i din kod.

Lär dig mer

Go SDK

Komplett Go SDK-dokumentation

Webhooks Documentation

Lär dig om alla webhook-events och bästa praxis

Checkout Sessions

Fördjupa dig i checkout-sessionens konfiguration

API Reference

Komplett Dodo Payments API-dokumentation

Support

Behöver du hjälp med boilerplate?
Senast ändrad 9 juni 2026