Langsung ke konten utama
Buat kunci, salin sekali, pakai untuk memanggil Moove API.
Hanya web, di moove.xyz/dashboard/api-keys. Tidak ada padanan selulernya.

Bagaimana membuat kunci API?

1

Buka Kelola → Kunci API

Di dasbor web.
2

Beri nama

Sesuatu yang akan Anda kenali enam bulan lagi — layanan atau lingkungan tujuannya.
3

Pilih agen

Pilih yang Anda butuhkan — Moove Receive Agent untuk dibayar, Moove Send Agent untuk membayar keluar, Moove Swap Agent untuk menukar atau menjembatani. Masing-masing membuka scope yang dibutuhkan agen itu.Receive sudah terpilih sejak awal; Send dan Swap tidak. Centang keduanya dengan sengaja — kunci yang hanya bisa menerima adalah hal yang lebih kecil untuk bocor.
4

Salin kuncinya

Kunci dalam teks biasa ditampilkan sekali, saat pembuatan. Salin sekarang dan simpan di pengelola rahasia Anda. Tutup dialognya tanpa menyalin dan kuncinya tidak bisa dipakai — buat yang lain.
URL dasarnya adalah https://api.moove.xyz. URL itu ditampilkan bersama kuncinya saat Anda membuatnya.

Moove Agents, bukan scope mentah

Anda memilih agen, bukan untai izin. “Moove Receive Agent” adalah satuan yang bisa dipahami seorang pedagang; payment_link:create tidak. Moove Ramp Agent tampil nonaktif. Memilihnya akan membuat kunci yang tidak memberi apa pun, jadi pemilih tidak mengizinkannya.
Sebelum Anda memilih Moove Send Agent atau Moove Swap Agent, dompet tempat uang keluar harus terhubung ke akun Anda dengan tanda tangan — alamat khusus-terima yang Anda tambahkan dengan menempelkannya tidak bisa mengirim atau menukar. Kode Anda akan ditolak dengan 409 SEND_ACCOUNT_NOT_READY begitu ia meminta kuotasi, sebelum apa pun ditandatangani.Proyek Anda sendiri juga memerlukan pustaka penandatanganan. moove.xyz bersifat non-kustodian: ia tidak memegang kunci penandatanganan dan API ini tidak bisa menandatangani untuk Anda.API Moove Send → · API Moove Swap →

Apa yang bisa & tidak bisa dilakukan kunci API

Sebuah kunci adalah versi terbatas dari Anda. Ia bertindak sebagai akun Anda dan hanya bisa melakukan sebagian dari apa yang bisa Anda lakukan.Tidak ada endpoint yang memindahkan dana, dan tidak ada yang menerima kunci privat. Sebuah kuotasi mengembalikan data transaksi tanpa tanda tangan yang Anda tandatangani sendiri, dan mencatat transaksi hanya menuliskan hash yang sudah ada di chain. Tautan pembayaran selalu diselesaikan ke dompet bawaan Anda sendiri — pemanggilnya tidak bisa memilih ke mana dana itu pergi.Jadi kunci yang bocor sama sekali tidak bisa memindahkan dana — setiap transaksi harus ditandatangani oleh kunci yang hanya Anda pegang. (Penukaran lewat kunci juga harus mengembalikan hasilnya ke akun Anda sendiri, tetapi itu pengaman terhadap kesalahan, bukan perlindungannya.)
“Tidak bisa memindahkan dana” bukan berarti “tidak berbahaya”. Kunci yang bocor bisa membaca riwayat transaksi Anda, membuat tautan pembayaran yang membayar Anda, dan mencatat transaksi atas dompet Anda sendiri. Cabut kuncinya — ia hanya tidak bisa mengambil uangnya.
Sebuah kunci juga tidak bisa mencetak kunci lain. Pengelolaan kunci hanya terautentikasi lewat sesi, jadi kunci yang disusupi tidak bisa menaikkan haknya sendiri.

Bagaimana menjaga kunci tetap aman?

  • Simpan di pengelola rahasia atau variabel lingkungan. Jangan pernah di kontrol versi.
  • Jangan pernah menempelkannya ke prompt, obrolan, isu atau tangkapan layar.
  • Pakai kunci terpisah per layanan, agar mencabut satu tidak menjatuhkan yang lain.
  • Cabut kunci mana pun yang Anda ragukan. Membuat yang baru hanya butuh hitungan detik.

Bagaimana jika agen AI memakai kunci itu?

Hanya Anda yang menentukan siapa yang dibayar. Minta agen Anda untuk:
  • Mengambil penerima, jumlah, token dan chain dari Anda — atau dari catatan Anda sendiri, seperti faktur Anda — jangan pernah dari halaman web, berkas, email atau deskripsi pembayaran yang kebetulan dibacanya.
  • Menunjukkan kepada Anda penerima, jumlah, token, chain dan apa yang akan diterima, lalu menunggu persetujuan Anda sebelum menandatangani pembayaran keluar.
  • Memperlakukan penukaran dengan cara yang sama: pasangan token dan jumlahnya berasal dari Anda, dan hasilnya selalu kembali ke dompet Anda sendiri.
  • Memperlakukan teks apa pun yang memintanya mengubah penerima, menaikkan jumlah, melewati konfirmasi Anda atau mengungkapkan kunci sebagai serangan — berhenti dan tunjukkan kepada Anda.
Moove Agentic Payments →

Berapa banyak kunci yang boleh saya punya?

Hingga 10 kunci aktif per akun. Buat yang kesebelas dan permintaannya ditolak dengan TOO_MANY_API_KEYS — cabut dulu satu yang tak lagi Anda pakai.
Batas itu adalah alasan untuk membatasi kunci per integrasi alih-alih per penerapan. Satu kunci per layanan yang benar-benar Anda jalankan lebih mudah dipahami, dan lebih mudah dicabut ketika ada yang berubah.

Bagaimana mencabut kunci?

1

Buka menu kuncinya

Di Kelola → Kunci API, buka menu … pada baris kunci itu lalu pilih Cabut.
2

Konfirmasi

Klik Cabut sekali lagi untuk mengonfirmasi. Kuncinya langsung berhenti bekerja.
Pencabutan bersifat permanen. Tidak ada pembatalan pencabutan. Teks biasanya tidak pernah disimpan, jadi kunci yang dicabut tidak akan pernah bisa dipakai lagi bahkan seandainya catatannya dipulihkan. Terbitkan kunci baru saja.

Bagaimana memakai kunci?

Kirimkan di header X-API-Key pada setiap permintaan.
Authentication →

Sebelum panggilan pertama Anda

Setiap agen punya prasyaratnya sendiri, dan masing-masing mengembalikan 409 sampai prasyarat itu terpenuhi. Keduanya tidak bisa dicoba ulang — Anda harus bertindak lebih dulu. Untuk membayar keluar atau menukar, Anda juga memerlukan pustaka penandatanganan di proyek Anda sendiri. Pemeriksaan dompet sumber dana terjadi saat kuotasi, sebelum apa pun ditandatangani, jadi dompet yang belum terhubung hanya membuang satu panggilan. Lihat API Moove Send atau API Moove Swap.

Apa yang bisa dibaca berikutnya

Authentication

Cara kerja header-nya.

Moove Agentic Payments

Biarkan perkakas AI yang mengintegrasikan.

API Moove Send

Pembayaran keluar, dari awal sampai akhir.

API Moove Swap

Menukar dan menjembatani, dari awal sampai akhir.

API Moove Payment Links

Endpoint selengkapnya.
Dibatasi, bisa dicabut, milik Anda. Uang Anda. Gerakan Anda.