Zum Hauptinhalt springen

GitHub Repository

Minimaler Go- + Dodo Payments-Boilerplate

Übersicht

Das Go-Boilerplate bietet einen produktionsbereiten Ausgangspunkt für die Integration von Dodo Payments in Ihr Go-Backend. Diese Vorlage umfasst die Handhabung von Checkout-Sitzungen, die Überprüfung von Webhooks, die Integration des Kundenportals und folgt den besten Praktiken von Go, um Ihnen zu helfen, schnell Zahlungen zu akzeptieren.
Dieses Boilerplate verwendet Go 1.21+ mit Clean-Architecture-Mustern (cmd, internal, templates), HTML-Vorlagen und das dodopayments-go SDK für eine nahtlose API-Integration.

Funktionen

  • Quick Setup – Schnellstart in unter 5 Minuten
  • Payment Integration – Vorgefertigter Checkout-Flow mit dem dodopayments-go SDK
  • Modern UI – Saubere, dunkel gestaltete Preisübersichtsseite mit HTML-Vorlagen
  • Webhook Handling – Zahlungsereignisse sicher prüfen und verarbeiten
  • Customer Portal – Selbstständige Abo-Verwaltung
  • Go Best Practices – Saubere Architektur mit cmd, internal und templates
  • Pre-filled Checkout – Zeigt, wie Kundendaten zur Verbesserung der UX übergeben werden

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:
  • Go 1.21+
  • Dodo Payments-Konto (um API- und Webhook-Keys vom Dashboard abzurufen)

Schnellstart

1

Clone the Repository

2

Install Dependencies

Oder manuell:
3

Get API Credentials

Melden Sie sich bei Dodo Payments an und holen Sie sich Ihre Zugangsdaten aus dem Dashboard:
Stellen Sie sicher, dass Sie sich während der Entwicklung im Testmodus befinden!
4

Configure Environment Variables

Erstellen Sie eine .env-Datei im Stammverzeichnis:
Aktualisieren Sie die Werte mit Ihren Dodo Payments-Anmeldeinformationen:
.env
Committen Sie Ihre .env-Datei niemals in die Versionskontrolle. Sie ist bereits in .gitignore enthalten.
5

Add Your Products

Aktualisieren Sie internal/lib/products.go mit Ihren tatsächlichen Produkt-IDs von Dodo Payments:
6

Run the Development Server

Oder manuell:
Öffnen Sie http://localhost:8000, um Ihre Preisgestaltungseite zu sehen!
Sie sollten eine dunkel gestaltete Preisübersichtsseite sehen, auf der Ihre Produkte zum Kauf bereitstehen.

Projektstruktur

API-Endpunkte

Das Boilerplate umfasst die folgenden vorkonfigurierten Endpunkte:

Anpassung

Produktinformationen aktualisieren

Bearbeiten Sie internal/lib/products.go, um folgende Punkte anzupassen:
  • Produkt-IDs (aus Ihrem Dodo-Dashboard)
  • Preise
  • Funktionen
  • Beschreibungen

Kundendaten vorab ausfüllen

In templates/index.html ersetzen Sie die fest kodierten Kundendaten durch Ihre tatsächlichen Benutzerdaten:
In einer Produktionsanwendung würden Sie diese Werte dynamisch aus Ihrem Authentifizierungssystem einfügen.

Webhook-Ereignisse

Das Boilerplate zeigt die Verarbeitung von Webhook-Ereignissen in internal/api/webhook.go. Unterstützte Ereignisse sind: Fügen Sie Ihre Geschäftslogik innerhalb des Webhook-Handlers hinzu, um:
  • Benutzerberechtigungen in Ihrer Datenbank zu aktualisieren
  • Bestätigungs-E-Mails zu senden
  • Zugriff auf digitale Produkte bereitzustellen
  • Analysen und Metriken zu verfolgen

Webhooks lokal testen

Für die lokale Entwicklung verwenden Sie Tools wie ngrok, um Ihren lokalen Server freizugeben:
Aktualisieren Sie die Webhook-URL in Ihrem Dodo Payments Dashboard:

Bereitstellung

Für die Produktion bauen

Oder manuell:

Auf Vercel bereitstellen

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

Docker

Erstellen Sie eine Dockerfile:
Bauen und ausführen:

Produktionsüberlegungen

Vor dem Einsatz in der Produktion:
  • Wechseln Sie DODO_PAYMENTS_ENVIRONMENT zu live_mode
  • Verwenden Sie Produktions-API-Schlüssel aus dem Dashboard
  • Aktualisieren Sie die Webhook-URL auf Ihre Produktionsdomain
  • Aktivieren Sie HTTPS für alle Endpunkte

Fehlersuche

Stellen Sie sicher, dass die Go-Module ordnungsgemäß heruntergeladen sind:
Häufige Ursachen:
  • Ungültige Produkt-ID – prüfen Sie, ob sie in Ihrem Dodo-Dashboard vorhanden ist
  • Falscher API-Schlüssel oder Umgebungswert in .env
  • Überprüfen Sie die Serverprotokolle auf detaillierte Fehlermeldungen
Für lokale Tests verwenden Sie ngrok, um Ihren Server erreichbar zu machen:
Aktualisieren Sie die Webhook-URL in Ihrem Dodo-Dashboard auf die ngrok-URL. Stellen Sie sicher, dass Sie Ihre .env-Datei mit dem richtigen Webhook-Verifizierungsschlüssel aktualisieren.
Stellen Sie sicher, dass Sie den Server vom Projektstammverzeichnis aus starten oder dass der Vorlagenpfad in Ihrem Code korrekt konfiguriert ist.

Erfahren Sie mehr

Go SDK

Komplette Go SDK-Dokumentation

Webhooks Documentation

Erfahren Sie alles über Webhook-Ereignisse und bewährte Verfahren

Checkout Sessions

Ein tiefer Einblick in die Konfiguration der Checkout-Sitzung

API Reference

Komplette Dodo Payments API-Dokumentation

Unterstützung

Brauchen Sie Hilfe mit dem Boilerplate?
Zuletzt geändert am 9. Juni 2026