Apa yang Anda butuhkan
| Kolom | Apa yang dilakukannya |
|---|---|
| API key ID | Mengidentifikasi kunci API MakePay Anda sehingga kami memanggil akun yang benar. |
| API key secret | Membiarkan kami membuat checkout MakePay pada akun Anda. Rahasia. |
| Webhook secret | Memastikan webhook benar-benar berasal dari MakePay. Rahasia. |
| Success URL | Tempat pembeli mendarat setelah pembayaran berhasil. |
| Failure URL | Tempat pembeli mendarat jika pembayaran gagal atau mereka batal. |
MakePay mengeluarkan API key ID dan secret secara bersamaan saat Anda menghasilkan kunci; webhook secret adalah nilai terpisah dari pengaturan callback-nya.
Kenapa kami meminta setiap kolom
API key ID
Mengidentifikasi kunci MakePay mana yang kami autentikasi. Bukan rahasia sendiri, tapi dipasangkan dengan secret di bawah.
API key secret
Mengotorisasi pembuatan checkout, sehingga pembayaran berjalan terhadap akun MakePay Anda dan masuk ke dompet Anda. MakePay menampilkannya sekali, tepat setelah Anda menghasilkan kunci.
Webhook secret
Membuktikan webhook masuk benar-benar dari MakePay, sehingga tidak ada yang bisa memalsukan event "paid". Ia adalah nilai terpisah dari API key.
Success and Failure URL
Pengaturan biasa: tempat pembeli mendarat setelah membayar atau setelah pembayaran gagal atau dibatalkan. Bukan rahasia.
Penyiapan
- Hasilkan API key di MakePay
Masuk ke MakePay dan buka API & SDK → API integrations. Di bawah API keys, klik Generate API Key, beri nama seperti "Coin Moebius", dan buatnya. MakePay menampilkan ID kunci API dan secret-nya sekali, tepat setelah generasi — salin keduanya sekarang, karena secret tidak ditampilkan lagi.
MakePay → API & SDK → API integrations → Generate API Key Perlakukan API key secret seperti kata sandi. Jika Anda kehilangannya, hasilkan kunci baru daripada mencoba memulihkan yang lama.
- Temukan ID proyek Coin Moebius Anda
Di tab terpisah, buka proyek Anda di dasbor Coin Moebius dan salin ID Proyek dari bawah nama proyek. URL callback MakePay Anda adalah ID itu dimasukkan ke dalam alamat di bawah — Anda akan menempel ke MakePay di langkah berikutnya.
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → proyek Anda → ID Proyek Kartu penyedia yang terhubung (langkah terakhir) menampilkan URL yang sama, sehingga Anda bisa menyalinnya lagi kapan saja.
- Atur URL callback dan salin webhook secret
Kembali di MakePay, gulir ke Delivery → Callback URL configuration. Klik Edit Callback URL, tempel URL webhook Coin Moebius Anda sebagai tujuan aktif, dan simpan. Kemudian, di bawah Webhook signing, salin signing secret (gunakan Regenerate secret jika belum ada nilai) — itu adalah Webhook secret yang Coin Moebius minta.
MakePay → Delivery → Callback URL configuration MakePay memposting pembaruan pengiriman ke alamat ini setelah setiap perubahan status yang terlihat oleh pedagang. Signing secret terpisah dari API key — Anda membutuhkan keduanya.
- Hubungkan di dasbor Coin Moebius
Di Coin Moebius, buka Providers → Add provider → MakePay. Tempel API key ID, API key secret, dan Webhook secret Anda, lalu atur Success URL dan Failure URL (tempat pembeli mendarat setelah membayar atau setelah pembayaran gagal). Klik Save.
Coin Moebius → Add provider → MakePay Secret yang tersimpan tetap tersembunyi. Untuk mengubahnya nanti, pilih Replace dan masukkan nilai baru.
- Anda sudah terhubung
MakePay kini muncul di tab Providers Anda dengan tanggal terhubungnya dan URL webhook yang diharapkannya. Jika Anda belum melakukannya, tempel URL itu ke pengaturan callback MakePay. Gunakan Edit untuk memutar kunci atau Disconnect untuk menghapusnya, dan alih ke toggle mode Test untuk menjalankan pesanan tanpa mempengaruhi angka sungguhan Anda.
Coin Moebius → Providers → MakePay (terhubung)
Setelah Anda menghubungkan
Jalankan satu pesanan sebelum tayang:
- Aktifkan toggle mode Test pada kartu MakePay yang terhubung untuk menjalankan pesanan tanpa mempengaruhi angka sungguhan Anda.
- Buat produk dan taruh tombol beli di halaman (berkas HTML lokal pun berfungsi) yang menunjuk ke proyek Anda.
- Selesaikan checkout melalui MakePay.
- Buka tab Transaksi. Saat status baris baru mencapai succeeded, kunci dan webhook Anda keduanya berfungsi dari ujung ke ujung.
Matikan mode Test saat Anda siap untuk pembayaran sungguhan.
Pemecahan masalah
Mulai di dasbor: konfirmasi kartu MakePay menampilkan terhubung dan bahwa URL webhook cocok dengan tujuan callback yang tersimpan di MakePay.
Pembayaran selesai tapi pesanan tetap pending.
Webhook tidak tiba atau tidak terverifikasi. Konfirmasi URL callback di MakePay cocok persis dengan URL webhook proyek Anda, dan bahwa Webhook secret di Coin Moebius cocok dengan signing secret di MakePay.
Menyimpan penyedia ditolak.
API key ID, API key secret, dan Webhook secret semuanya diperlukan. Salin ulang dari MakePay — secret hanya ditampilkan sekali, jadi hasilkan kunci baru jika Anda tidak lagi memilikinya.
Pesanan uji tidak pernah muncul di Transaksi.
Aktifkan toggle mode Test pada kartu MakePay sebelum Anda menjalankan tombol beli, dan pastikan produk menunjuk ke proyek yang sama.
Baik untuk diketahui
Tidak ada penguasa dana. MakePay mengirimkan kripto langsung ke dompet Anda sendiri. Coin Moebius tidak pernah memegang dana dan tidak bisa memindahkannya.
Memutar secret. Hasilkan API key baru atau regenerasi webhook signing secret kapan saja, lalu pilih Replace di dasbor dan tempel nilai baru. Kolom rahasia tetap kosong saat diedit.
Ada pertanyaan? Join our Discord