Go Boilerplate

GitHub Repository

Boilerplate Minimal Go + Dodo Payments

Ikhtisar

Boilerplate Go adalah server Go minimal yang menjual produk Dodo Payments Anda dari halaman pricing. Server ini membuat checkout sessions, memverifikasi dan menangani webhooks, serta membuka Customer Portal. Clone sebagai titik awal untuk backend Go Anda sendiri.

Boilerplate ini memerlukan Go 1.24.4 atau versi yang lebih baru, yaitu versi yang ditetapkan di go.mod. Boilerplate ini menggunakan layout cmd, internal, dan templates, merender halaman pricing dengan template HTML Go, serta memanggil API Dodo Payments melalui SDK dodopayments-go.

Fitur

Setup Cepat: Clone repository, tambahkan API keys Anda ke .env, lalu jalankan server dengan make run.
Integrasi Payment: Alur checkout yang membuat checkout sessions dengan SDK dodopayments-go.
UI Modern: Halaman pricing bertema gelap yang dibuat dengan template HTML Go dan Tailwind CSS.
Penanganan Webhook: Memverifikasi signature setiap webhook sebelum memproses event.
Customer Portal: Pengelolaan subscription mandiri melalui Customer Portal.
Praktik Terbaik Go: Layout project yang rapi dengan cmd, internal, dan templates.
Checkout Terisi Otomatis: Meneruskan nama dan email customer ke checkout, sehingga customer tidak perlu mengetikkannya lagi.

Prasyarat

Sebelum memulai, Anda memerlukan:

Go 1.24.4 atau versi yang lebih baru. Periksa versi Anda dengan go version.
Akun Dodo Payments, untuk membuat API key dan webhook signing key di dashboard.
Setidaknya satu produk, yang dibuat di bagian Products pada dashboard.

Memulai dengan Cepat

Clone the Repository

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

Install Dependencies

make install

make install menjalankan go mod download lalu go mod tidy. Untuk mengunduh modules tanpa make, jalankan:

go mod download

Get API Credentials

Daftar di Dodo Payments, lalu salin kedua key dari dashboard:

API Key: Developer → API Keys
Webhook Key: Developer → Webhooks. Setiap webhook endpoint memiliki signing key sendiri. Untuk membuat endpoint yang dapat menjangkau server lokal Anda, lihat Testing Webhooks Locally.

Buat kedua key dalam test mode selama pengembangan. Untuk beralih ke test mode, nonaktifkan switch Live Mode di sidebar dashboard.

Configure Environment Variables

Buat file .env di root project dari template:

cp .env.example .env

Tetapkan nilai berikut di .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

Server membaca variables ini saat startup:

Variable	Required	Default	Purpose
`DODO_PAYMENTS_API_KEY`	Yes	None	Mengautentikasi request ke API Dodo Payments.
`DODO_PAYMENTS_WEBHOOK_KEY`	Yes	None	Memverifikasi signature webhook yang masuk.
`DODO_PAYMENTS_RETURN_URL`	No	`http://localhost:8080`	URL yang digunakan checkout untuk mengarahkan customer setelah payment.
`DODO_PAYMENTS_ENVIRONMENT`	No	`test_mode`	`test_mode` atau `live_mode`.
`PORT`	No	`8000`	Port tempat server melakukan listen.

Server berhenti saat startup jika salah satu key yang diperlukan tidak ada. .env.example menetapkan PORT dan DODO_PAYMENTS_RETURN_URL ke port 8080. Halaman ini menggunakan port 8000, jadi tetapkan keduanya ke 8000 seperti yang ditunjukkan, atau ganti 8000 dengan 8080 dalam commands di halaman ini.

Jangan pernah commit file .env ke version control. .gitignore milik repository sudah mengecualikannya.

Add Your Products

Ganti sample product di internal/lib/products.go dengan produk Anda. Salin setiap product ID dari Products di dashboard:

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 hanya menetapkan price yang ditampilkan halaman pricing, dalam unit mata uang terkecil: 9999 ditampilkan sebagai $99.99. Checkout mengenakan price produk di Dodo Payments.

Run the Development Server

make run

make run membangun server menjadi bin/server lalu menjalankannya. Untuk menjalankan server tanpa membangun binary terlebih dahulu, jalankan:

go run cmd/server/main.go

Buka http://localhost:8000 untuk melihat halaman pricing Anda.

Anda akan melihat halaman pricing bertema gelap yang mencantumkan produk Anda dan siap digunakan untuk pembelian.

Struktur Project

Repository memiliki layout berikut:

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 ini menyertakan endpoint yang telah dikonfigurasi berikut:

Endpoint	Method	Description
`/`	GET	Halaman pricing yang mencantumkan produk di `internal/lib/products.go`.
`/api/checkout`	POST	Membuat checkout session. Kirim `product_id`, serta `quantity` opsional (default `1`) dan `customer` (`email`, `name`, `phone`). Mengembalikan `session_id` dan `checkout_url`.
`/api/webhook`	POST	Memverifikasi dan menangani webhook Dodo Payments. Mengembalikan `401` ketika pemeriksaan signature gagal.
`/api/customer-portal`	POST	Mengembalikan link Customer Portal di `portal_url`. Kirim `customer_id`, atau `email` dengan `name` opsional. Jika hanya menggunakan email, handler akan mencari customer dan membuatnya jika belum ada.
`/health`	GET	Health check. Mengembalikan `OK`.

Kustomisasi

Memperbarui Informasi Produk

Edit internal/lib/products.go untuk mengubah:

Product IDs (dari Products di dashboard Dodo Payments Anda)
Nama
Price yang ditampilkan di halaman pricing
Fitur
Deskripsi

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",
        },
    },
}

Template halaman pricing menambahkan suffix /mo ke setiap price dan menampilkan Custom, bukan price, jika Price bernilai 100000 atau lebih. Untuk mengubahnya, edit templates/index.html.

Mengisi Data Customer Otomatis

Di .env, function handleCheckout mengirim data customer yang ditulis langsung ke /api/checkout. Ganti dengan data user yang sudah login:

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
};

Function handlePortal menggunakan kembali data customer ini dan menggunakan nama serta email sample yang sama sebagai fallback. Dalam app production, masukkan nilai ini dari sistem authentication Anda ke kedua function.

Event Webhook

internal/api/webhook.go memverifikasi setiap request dengan client.Webhooks.Unwrap dan key di DODO_PAYMENTS_WEBHOOK_KEY, lalu merutekan event berdasarkan type. Event-event ini memiliki handler, dan setiap handler mencatat data event:

Event	Description
`payment.succeeded`	Dipicu ketika payment berhasil
`payment.failed`	Dipicu ketika payment attempt gagal
`subscription.active`	Dipicu ketika subscription menjadi aktif
`subscription.renewed`	Dipicu ketika subscription diperpanjang untuk billing period berikutnya
`subscription.updated`	Dipicu ketika field subscription apa pun berubah
`subscription.cancelled`	Dipicu ketika subscription dibatalkan

Handler juga menerima subscription.on_hold, subscription.failed, subscription.expired, dan subscription.plan_changed tanpa melakukan tindakan apa pun, serta mencatat setiap event type lainnya sebagai tidak ditangani. Handler merespons dengan 200 untuk setiap event yang terverifikasi. Untuk semua event type, lihat Webhook Event Guide. Tambahkan business logic Anda ke function handler untuk:

Memperbarui permission user di database Anda
Mengirim email konfirmasi
Menyediakan akses ke produk digital
Melacak analytics dan metrics

Testing Webhook Secara Lokal

Dodo Payments tidak dapat menjangkau localhost. Untuk menerima webhook selama development, expose server lokal Anda dengan tunnel seperti ngrok:

ngrok http 8000

Di Dodo Payments Dashboard, tambahkan endpoint dengan forwarding URL yang ditampilkan ngrok, diikuti /api/webhook:

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

Salin signing key endpoint ke DODO_PAYMENTS_WEBHOOK_KEY, lalu restart server.

Deployment

Build untuk Production

make build mengompilasi server menjadi bin/server:

make build

Untuk build dan menjalankan binary tanpa make, jalankan:

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

Deploy ke Vercel

[

](https://vercel.com/new/clone?repository-url=https://github.com/dodopayments/go-boilerplate) Setelah melakukan deployment, tambahkan variables dari file .env ke pengaturan project Vercel, karena .env tidak ada di repository. Kemudian tetapkan webhook endpoint di dashboard ke https://yourdomain.com/api/webhook.

Docker

Buat Dockerfile di root project. Build stage harus menggunakan Go 1.24.4 atau versi yang lebih baru agar sesuai dengan 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"]

Final image menyalin templates/ ke sebelah binary, karena server memuat template dari working directory. Build dan jalankan image:

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

Container listen pada nilai PORT dari .env, jadi pertahankan PORT=8000 agar sesuai dengan port mapping.

Pertimbangan Production

Sebelum melakukan deployment ke production:

Tetapkan DODO_PAYMENTS_ENVIRONMENT ke live_mode.
Gunakan API key live mode dari dashboard.
Arahkan webhook endpoint ke domain production Anda, dan gunakan signing key endpoint tersebut.
Tetapkan DODO_PAYMENTS_RETURN_URL ke halaman di domain production Anda.
Sajikan setiap endpoint melalui HTTPS.

Troubleshooting

Build errors or missing dependencies

Pastikan go version melaporkan Go 1.24.4 atau versi yang lebih baru, lalu unduh modules lagi:

go mod tidy
go mod download

Checkout session creation fails

Penyebab umum:

Product ID tidak valid. Pastikan product ID tersebut ada di Products dalam mode yang sama dengan API key Anda.
API key atau DODO_PAYMENTS_ENVIRONMENT di .env salah. Key test mode memerlukan test_mode.
Untuk melihat error yang tepat, periksa server logs. Handler mencatat setiap request yang gagal sebelum mengembalikan 500.

Webhooks not receiving events

Untuk pengujian lokal, expose server Anda dengan ngrok:

ngrok http 8000

Tetapkan webhook URL di Dodo Payments dashboard ke URL ngrok. Kemudian tetapkan DODO_PAYMENTS_WEBHOOK_KEY di .env ke signing key endpoint tersebut. Jika server mencatat webhook verification failed, key tidak sesuai dengan endpoint.

Templates not loading

Server memuat templates/base.html dan templates/index.html dari working directory. Jalankan server dari root project, atau ubah template paths di cmd/server/main.go.

Pelajari Lebih Lanjut

Go SDK

Dokumentasi Go SDK lengkap

Webhooks Documentation

Pelajari semua event webhook dan praktik terbaik

Checkout Sessions

Pelajari secara mendalam konfigurasi checkout session

API Reference

Dokumentasi API Dodo Payments lengkap

Dukungan

Untuk mendapatkan bantuan terkait boilerplate:

Ajukan pertanyaan di komunitas Discord.
Periksa repository GitHub untuk issue dan update.
Hubungi tim support.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

GitHub Repository

Ikhtisar

Fitur

Prasyarat

Memulai dengan Cepat

Struktur Project

API Endpoints

Kustomisasi

Memperbarui Informasi Produk

Mengisi Data Customer Otomatis

Event Webhook

Testing Webhook Secara Lokal

Deployment

Build untuk Production

Deploy ke Vercel

Docker

Pertimbangan Production

Troubleshooting

Pelajari Lebih Lanjut

Go SDK

Webhooks Documentation

Checkout Sessions

API Reference

Dukungan

GitHub Repository

​Ikhtisar

​Fitur

​Prasyarat

​Memulai dengan Cepat

​Struktur Project

​API Endpoints

​Kustomisasi

​Memperbarui Informasi Produk

​Mengisi Data Customer Otomatis

​Event Webhook

​Testing Webhook Secara Lokal

​Deployment

​Build untuk Production

​Deploy ke Vercel

​Docker

​Pertimbangan Production

​Troubleshooting

​Pelajari Lebih Lanjut

Go SDK

Webhooks Documentation

Checkout Sessions

API Reference

​Dukungan

Ikhtisar

Fitur

Prasyarat

Memulai dengan Cepat

Struktur Project

API Endpoints

Kustomisasi

Memperbarui Informasi Produk

Mengisi Data Customer Otomatis

Event Webhook

Testing Webhook Secara Lokal

Deployment

Build untuk Production

Deploy ke Vercel

Docker

Pertimbangan Production

Troubleshooting

Pelajari Lebih Lanjut

Dukungan