Apa yang Anda butuhkan
| Kolom | Apa yang dilakukannya |
|---|---|
| API key | Membiarkan kami memanggil Dodo untuk membuat checkout terhosting. Rahasia. |
| Webhook signing secret (whsec_…) | Memastikan sebuah webhook benar-benar berasal dari Dodo. Rahasia. |
| Return URL | Tempat pembeli mendarat setelah checkout. |
Kenapa kami meminta setiap kolom
API key
Mengotorisasi pembuatan checkout terhosting, agar tagihannya berjalan lewat akun Anda.
Webhook signing secret
Membuktikan webhook masuk benar-benar dari Dodo, jadi tidak ada yang bisa memalsukan event "paid". Ia adalah nilai terpisah dari API key.
Return URL
Pengaturan biasa: tempat pembeli mendarat setelah checkout. Bukan rahasia.
Penyiapan
- Pakai mode uji (gratis)
Dodo punya lingkungan uji terpisah. Kunci mode-uji berjalan terhadap host uji Dodo, dan tidak ada uang sungguhan yang berpindah.
- Masuk di app.dodopayments.com.
- Dodo memisahkan kunci Live dan Test. Siapkan uji dulu, lalu ulangi di live.
- Salin API key Anda
Buka Developer → API Keys dan salin kunci Test untuk memverifikasi, atau kunci Live untuk menerima pembayaran sungguhan.
Dodo → Developer → API Keys - Tambahkan webhook
- Tambahkan sebuah webhook di Dodo.
- Atur URL webhook ke alamat webhook proyek Anda (di bawah).
- Salin webhook signing secret (whsec_…). Tambahkan webhook terpisah di test dan di live.
https://api.coinmoebius.com/webhook/dodopayments/<your project id>Dodo → Developer → Webhooks - Hubungkan di dasbor
Tambah penyedia → Dodo Payments. Masukkan Return URL dan grup Live (Live API key, Live webhook signing secret). Tambahkan grup Test opsional untuk memverifikasi dulu. Grup Test berpasangan: tambahkan baik kunci API uji maupun webhook secret uji, atau biarkan keduanya kosong. Live dan test diperiksa secara terpisah.
Setelah Anda menghubungkan
Jalankan satu pembayaran uji sebelum tayang:
- Buat sebuah produk dan atur Environment-nya ke Testing. Itu menjalankan produknya pada kredensial uji Anda, jadi Anda bisa memesan penuh tanpa memindahkan uang. (Jika Anda melewatkan set uji, produk Testing kembali ke live, jadi tambahkan dulu.)
- Taruh tombol beli di sebuah halaman (berkas HTML lokal pun berfungsi) yang menunjuk ke proyek Anda.
- Selesaikan checkout di mode uji Dodo.
- Buka tab Transaksi. Sebuah baris baru muncul, bertanda Testing. Saat statusnya mencapai succeeded, kredensial dan webhook Anda keduanya berfungsi dari ujung ke ujung.
Alihkan Environment produk ke Live saat Anda siap untuk pembayaran sungguhan.
Pemecahan masalah
Mulai dengan Verify. Di dasbor, klik Verify (atau Verify test credentials) untuk memeriksa API key Anda.
Verify test credentials bilang tidak ada kredensial uji yang tersimpan.
Tambahkan kunci API uji di tab Test, simpan penyedianya, lalu buka kembali dialognya dan verifikasi.
Pembayaran selesai tapi pesanan tetap pending.
Pastikan URL webhook cocok dan bahwa signing secret cocok dengan webhook di lingkungan yang sama (secret uji untuk uji, live untuk live).
Menyimpan grup Test ditolak.
Grup Test berpasangan: tambahkan baik kunci API uji maupun webhook secret uji, atau biarkan keduanya kosong.
Pastikan dari ujung ke ujung.
Dasbor Dodo → Developer → Webhooks → Send Example (atau Dodo CLI) yang menunjuk ke URL webhook Anda, lalu amati pesanannya diperbarui.
Baik untuk diketahui
Hanya pembayaran sekali bayar. Coin Moebius memakai Dodo untuk pembayaran tunggal, bukan langganan.
Memutar secret. Putar API key atau webhook secret kapan saja, lalu tempel nilai barunya. Kolom rahasia tetap kosong saat diedit.
Ada pertanyaan? Join our Discord