Apa yang Anda butuhkan
| Kolom | Apa yang dilakukannya |
|---|---|
| API key | Membiarkan kami memanggil NOWPayments untuk membuat pembayaran. Rahasia. |
| IPN secret | Memastikan sebuah notifikasi pembayaran benar-benar berasal dari NOWPayments. Rahasia. |
| Success URL / Cancel URL | Tempat pembeli mendarat setelah membayar atau mundur. |
IPN (Instant Payment Notification) adalah nama NOWPayments untuk webhook yang mereka kirim saat status pembayaran berubah.
Kenapa kami meminta setiap kolom
API key
Mengotorisasi pembuatan pembayaran, agar dananya masuk ke akun Anda.
IPN secret
Membuktikan notifikasi masuk benar-benar dari NOWPayments, jadi tidak ada yang bisa memalsukan event "paid". Ia adalah nilai terpisah dari API key.
Success and Cancel URL
Pengaturan biasa: tempat pembeli mendarat setelah membayar atau mundur. Bukan rahasia.
Penyiapan
- Pengujian: tidak ada sandbox
NOWPayments tidak punya sandbox atau lingkungan uji. Untuk memverifikasi dari ujung ke ujung, kirim pembayaran sungguhan kecil dalam koin berbiaya rendah dan pastikan ia muncul di dasbor Anda. Anggap pembayaran kecil pertama itu sebagai uji Anda. Akun NOWPayments gratis; Anda hanya membayar biaya jaringan dan layanan normal pada pembayaran sungguhan.
- Buka Payments Settings di NOWPayments
Masuk di account.nowpayments.io dan buka Settings → Payments. Satu layar ini memuat tiga hal yang Anda butuhkan: Payout wallets (tempat dana masuk), API keys, dan Instant payment notifications. Anda akan mengunjungi masing-masing secara bergantian.
NOWPayments → Settings → Payments - Tambahkan payout wallet
NOWPayments membuka kunci API hanya setelah Anda memiliki payout wallet yang terdaftar. Di Payout wallets, klik Add new wallet, pilih mata uang, tempel alamat wallet yang Anda kendalikan, dan klik Add wallet. Ini adalah alamat tujuan crypto Anda.
NOWPayments → Payout wallets → Add new wallet - Buat API key
Buka API keys dan klik Add new API key. Kunci-kunci Anda terdaftar di sini, masing-masing dengan ikon salin, sehingga Anda bisa kembali dan menyalin ulang kunci kapan saja.
NOWPayments → Settings → API keys - Salin API key Anda
NOWPayments menampilkan kunci baru dalam dialog "API key created". Klik ikon salin di sebelah Your API key dan simpan. (Kunci publik di bawahnya tidak dibutuhkan oleh Coin Moebius.) Anda bisa menambahkan label opsional, lalu klik Save.
NOWPayments → API key created Ini adalah API key rahasia Anda. Perlakukan seperti kata sandi.
- Siapkan callback IPN dan salin IPN secret
Buka Instant payment notifications. IPN (Instant Payment Notification) adalah nama NOWPayments untuk webhook yang mereka kirim saat status pembayaran berubah.
- Di kolom Webhook URL, tempel alamat webhook NOWPayments proyek Anda (di bawah), lalu klik Save.
- Salin IPN secret key yang ditampilkan di bagian atas (gunakan Regenerate jika belum ada nilainya).
- Di bawah Choose webhook format, pilih Classic way agar jumlah dan ID tetap dalam format numerik normalnya.
https://api.coinmoebius.com/webhook/nowpayments/<your project id>NOWPayments → Instant payment notifications ID proyek Anda ada di bawah nama proyek di dasbor Coin Moebius; masukkan ke alamat di atas. Kartu penyedia yang terhubung (langkah terakhir) menampilkan URL yang sama, sehingga Anda bisa menyalinnya ulang kapan saja.
- Kembali di Coin Moebius: Add provider → NOWPayments
Di proyek Anda, buka tab Providers, klik Add provider, pilih Connect a service, dan pilih NOWPayments. Tempel API key dan IPN secret Anda, atur Success URL dan Cancel URL (tempat pembeli mendarat setelah membayar atau mundur), lalu klik Save.
Coin Moebius → Add provider → NOWPayments - Anda sudah terhubung
NOWPayments kini muncul di tab Providers Anda beserta tanggal koneksinya. Kartu menampilkan URL webhook yang sama yang Anda tempel ke NOWPayments, plus Edit dan Disconnect. Karena NOWPayments tidak memiliki sandbox, kami tidak dapat memverifikasi IPN secret secara otomatis, sehingga kartu menawarkan uji micro-payment: kirim pembayaran nyata kecil untuk memastikan semuanya berfungsi dari ujung ke ujung.
Coin Moebius → Providers → NOWPayments (terhubung)
Setelah Anda menghubungkan
Tidak ada sandbox, jadi pembayaran sungguhan kecil pertama Anda adalah ujinya:
- Buat sebuah produk dan taruh tombol beli di sebuah halaman (berkas HTML lokal pun berfungsi) yang menunjuk ke proyek Anda.
- Bayar jumlah kecil dalam koin berbiaya rendah.
- Buka tab Transaksi. Saat status baris baru mencapai succeeded, API key dan IPN secret Anda keduanya berfungsi dari ujung ke ujung.
Pemecahan masalah
Pembayaran selesai tapi pesanan tetap pending.
IPN-nya tidak tiba atau tidak terverifikasi. Pastikan callback URL cocok dan bahwa IPN secret di dasbor cocok dengan IPN Secret Key di pengaturan NOWPayments Anda.
Tidak ada cara menguji tanpa membayar.
Benar, tidak ada sandbox. Kirim pembayaran sungguhan kecil dalam koin berbiaya rendah untuk memicu IPN asli, lalu amati pesanannya diperbarui.
Status hanya berubah saat ada aktivitas sungguhan.
Status NOWPayments mencerminkan pengiriman IPN, jadi akun yang sunyi tidak menampilkan status sampai pembayaran sungguhan bergerak.
Baik untuk diketahui
Tanpa mode uji. Verifikasi dengan pembayaran sungguhan kecil, bukan sandbox.
Memutar secret. Hasilkan API key atau IPN secret baru kapan saja, lalu tempel nilai barunya.
Ada pertanyaan? Join our Discord