Kunci API

Stripe melakukan autentikasi permintaan API Anda menggunakan kunci API akun. Jika permintaan tidak menyertakan kunci yang valid, Stripe akan mengembalikan kesalahan permintaan yang tidak valid. Jika permintaan menyertakan kunci yang dihapus atau kedaluwarsa, Stripe akan mengembalikan kesalahan autentikasi.

Gunakan Dashboard Pengembang untuk membuat, memperlihatkan, menghapus, dan mencabut kunci API. Untuk mengakses kunci API v1 Anda, pilih tab Kunci API di Dashboard.

Mode percobaan versus mode live

Semua permintaan Stripe API terjadi dalam mode percobaan atau mode live. Gunakan mode percobaan untuk mengakses data percobaan, dan mode live untuk mengakses data akun aktual. Masing-masing mode memiliki serangkaian kunci API-nya sendiri. Objek dalam satu mode tidak dapat diakses oleh mode lainnya. Misalnya, objek produk mode percobaan tidak dapat menjadi bagian dari pembayaran mode live.

Kunci rahasia dan kunci yang dapat diterbitkan

Semua akun memiliki total empat kunci API secara default—dua untuk mode percobaan dan dua untuk mode live:

• Kunci rahasia mode percobaan: Gunakan kunci ini untuk mengautentikasi permintaan di server Anda saat dalam mode percobaan. Secara default, Anda dapat menggunakan kunci ini untuk melakukan permintaan API apa pun tanpa batasan.
• Kunci mode percobaan yang dapat dipublikasikan: Gunakan kunci ini untuk tujuan percobaan di kode sisi klien web atau aplikasi seluler Anda.
• Kunci rahasia mode live: Gunakan kunci ini untuk mengautentikasi permintaan di server Anda saat dalam mode live. Secara default, Anda dapat menggunakan kunci ini untuk melakukan permintaan API apa pun tanpa batasan.
• Kunci mode live yang dapat dipublikasikan: Gunakan kunci ini, saat Anda siap meluncurkan aplikasi, di kode sisi klien web atau aplikasi seluler Anda.

You can find your secret and publishable keys in API keys. When you’re logged in, Stripe’s documentation automatically populates code examples with your test mode API keys (only you can see these values). If you’re not logged in, our code examples include randomly generated API keys. You can replace them with your own test keys or log in to see the code examples populated with your test API keys. If you can’t view your API keys, ask the owner of your Stripe account to add you to their team, with the proper permissions.

Tabel berikut ini menunjukkan contoh yang dibuat secara acak dari kunci API percobaan yang bersifat rahasia dan dapat dipublikasikan:

Simpan kunci Anda dengan aman

Siapa saja dapat menggunakan kunci API rahasia mode live Anda untuk melakukan segala panggilan API atas nama akun Anda, seperti membuat charge atau melakukan pengembalian dana. Tetap amankan kunci Anda dengan mengikuti praktik terbaik kunci API rahasia.

Sesuaikan akses API dengan kunci API terbatas

Untuk menyediakan akses terbatas ke API, buat kunci API yang dibatasi. Anda dapat melakukan konfigurasi kunci API yang dibatasi untuk mengizinkan akses baca atau tulis ke sumber daya API tertentu. Ketika menggunakan layanan mikro yang berinteraksi dengan API atas nama Anda, tentukan kunci yang dibatasi dengan izin akses minimum saja yang diperlukan oleh layanan mikro tersebut. Misalnya, jika Anda menggunakan layanan pemantauan sengketa, buat kunci yang dibatasi dengan penyediaan akses baca ke sumber daya terkait sengketa. Kunci itu memungkinkan layanan tersebut mendapatkan data yang dibutuhkan, tetapi tidak mengizinkannya untuk melakukan perubahan atau mengakses data lainnya.

Kunci yang dibatasi tidak dapat berinteraksi dengan banyak bagian API Stripe karena kunci tersebut hanya dimaksudkan untuk mengurangi risiko ketika menggunakan atau membuat layanan mikro. Jangan gunakan kunci yang dibatasi sebagai alternatif untuk kunci API yang dapat diterbitkan atau rahasia selama pengembangan integrasi Stripe Anda.

Batasi alamat IP yang dapat mengirim permintaan API

Anda dapat meningkatkan keamanan kunci yang dibatasi atau rahasia dengan membatasi alamat IP yang dapat menggunakannya untuk mengirim permintaan API. Selain itu, Anda dapat membatasi kunci untuk satu atau beberapa alamat IP atau ke rentang alamat IP.

Perlihatkan kunci API rahasia untuk mode percobaan

Dalam mode percobaan, Anda dapat memperlihatkan kunci API rahasia sebanyak yang diinginkan.

Untuk memperlihatkan kunci rahasia dalam mode percobaan:

1. Di Dashboard Pengembang, pilih tab kunci API.
2. Di daftar Kunci standar, di baris Kunci rahasia, klik Perllihatkan kunci percobaan.
3. Salin nilai kunci dengan mengekliknya.
4. Simpan nilai kunci.
5. Klik Sembunyikan kunci percobaan.

Perlihatkan kunci API yang dibatasi atau rahasia untuk mode live

Demi keamanan, dalam mode live, Stripe hanya menampilkan kunci API yang dibatasi atau rahasia satu kali. Simpan kunci di tempat aman yang tidak akan hilang. Untuk membantu mengingat tempat menyimpannya, Anda dapat meninggalkan catatan pada kunci di Dashboard. Jika kehilangan kunci, Anda dapat mencabut atau menghapusnya serta membuat yang lain.

Untuk memperlihatkan kunci yang dibatasi atau rahasia dalam mode live dan melampirkan catatan:

1. Di Dashboard Pengembang, pilih tab Kunci API.
2. Di daftar Kunci standar atau Kunci yang dibatasi, di baris kunci yang ingin Anda perlihatkan, klik Perlihatkan kunci live.
3. Salin nilai kunci dengan mengekliknya.
4. Simpan nilai kunci.
5. Klik Sembunyikan kunci percobaan.
6. Klik menu perluasan () di sebelah kunci, kemudian pilih Edit kunci….
7. Di bidang Catatan, masukkan lokasi tempat Anda menyimpan kunci, kemudian klik Simpan.
8. Jika Anda membuat kunci sebelum Stripe memperkenalkan fitur ini, klik Sembunyikan kunci live.

Cabut kunci API

Mencabut kunci akan mencabut kunci tersebut dan menghasilkan kunci pengganti. Anda dapat mencabut kunci dengan segera atau menjadwalkan kunci untuk dicabut setelah waktu tertentu. Cabut kunci dalam skenario seperti dalam contoh berikut:

• Jika Anda berada dalam mode live dan kehilangan kunci yang dibatasi atau rahasia, Anda tidak dapat memulihkannya dari Dashboard serta harus menggantinya.
• Jika kunci yang dibatasi atau rahasia diretas, Anda harus mencabutnya untuk memblokir permintaan API berpotensi berbahaya yang mungkin menggunakannya.
• Kebijakan Anda mengharuskan rotasi kunci pada interval tertentu.

Untuk mencabut kunci API:

1. Buka halaman kunci API.
2. Di baris untuk kunci yang ingin Anda cabut, klik menu perluasan (), kemudian pilih Cabut kunci….
3. Pilih tanggal kedaluwarsa dari menu dropdown Kedaluwarsa.
4. Klik Cabut kunci API.
5. Dialog menampilkan nilai kunci baru. Salin dengan mengekliknya.
6. Simpan nilai kunci. Anda tidak dapat mengambilnya nanti.
7. Di bidang Tambahkan catatan, masukkan lokasi tempat Anda menyimpan kunci dan klik Selesai atau Simpan.

Jika Anda memilih Sekarang untuk Kedaluwarsa, kami akan menghapus kunci lama. Jika memilih waktu yang berbeda, Anda dapat melihat sisa waktu hingga kunci tersebut kedaluwarsa di bawah namanya.

Kapan pun waktu kedaluwarsa kunci lama, kunci baru siap digunakan langsung.

Bila Anda mencabut kunci yang dapat diterbitkan, nama kunci penggantinya selalu Publishable key. Bila Anda mencabut kunci rahasia, nama kunci penggantinya selalu Secret key. Bila anda mencabut kunci yang dibatasi, nama kunci penggantinya sama dengan kunci yang dicabut. Anda dapat mengganti nama kunci yang dibatasi atau rahasia dengan mengeklik menu perluasan dan memilih Edit kunci….

Hapus kunci API yang dibatasi atau rahasia

Jika Anda menghapus kunci, kode yang menggunakan kunci tersebut tidak lagi dapat melakukan panggilan API. Buat kunci baru dan perbarui kode untuk menggunakannya.

Untuk menghapus kunci:

1. Di Dashboard Pengembang, pilih tab kunci API.
2. Temukan kunci yang ingin Anda hapus di daftar Kunci standar atau Kunci yang dibatasi. Klik ikon menu perluasan () di baris kunci tersebut, kemudian pilih Hapus kunci ….
3. Di dialog Hapus kunci API, jika Anda yakin ingin menghapus kunci, klik Hapus kunci. Jika tidak, klik Batalkan.

Buat kunci API rahasia

Untuk membuat kunci API rahasia:

1. Buka halaman kunci API.
2. Klik Buat kunci rahasia.
3. Stripe mengirim kode verifikasi ke alamat email Anda atau dalam pesan teks. (Sebagaimana email atau pesan teks lain, kode mungkin tidak langsung diterima.) Masukkan kode dalam dialog. Jika dialog tidak berlanjut secara otomatis, klik Lanjutkan.
4. Masukkan nama di bidang Nama kunci.
5. Klik Buat.
6. Dialog menampilkan nilai kunci baru. Salin dengan mengekliknya.
7. Simpan nilai kunci. Anda tidak dapat mengambilnya nanti.
8. Di bidang Tambahkan catatan, masukkan lokasi tempat Anda menyimpan kunci dan klik Selesai.

Buat kunci API yang dibatasi

Kunci API yang dibatasi hanya mengizinkan tingkat akses yang Anda tentukan.

Untuk membuat kunci API yang dibatasi:

1. Buka halaman kunci API.
2. Anda dapat membuat kunci yang dibatasi dari nol atau memulai dengan melakukan kloning kunci tersedia yang dibatasi.
   • Untuk membuat kunci yang dibatasi dari nol, klik Buat kunci yang dibatasi. Dalam kasus ini, nilai default untuk semua izin adalah Tidak ada.
   • Untuk melakukan kloning kunci yang sudah ada, di baris untuk kunci yang ingin Anda kloning, klik menu perluasan (), kemudian pilih Buat duplikat kunci…. Dalam kasus ini, nilai default untuk setiap izin adalah nilainya di kunci yang dikloning.
3. Di bidang Nama kunci, masukkan nama. Jika Anda menggandakan kunci yang sudah ada, nama default adalah nama kunci yang digandakan.
4. Bagi setiap sumber daya yang Anda inginkan untuk diakses oleh kunci baru, pilih izin yang diperbolehkan untuk kunci ini. Jika menggunakan Connect, Anda juga dapat memilih izin yang diperbolehkan untuk kunci ini ketika mengakses akun terhubung. Izin yang tersedia adalah Tidak ada, Baca, atau Tulis.
5. Klik Buat kunci.
6. Stripe mengirim kode verifikasi ke alamat email Anda atau dalam pesan teks. (Sebagaimana email atau pesan teks lain, kode mungkin tidak langsung diterima.) Masukkan kode dalam dialog. Jika dialog tidak berlanjut secara otomatis, klik Lanjutkan.
7. Dialog menampilkan nilai kunci baru. Salin dengan mengekliknya.
8. Simpan nilai kunci. Anda tidak dapat mengambilnya nanti.
9. Di bidang Tambahkan catatan, masukkan lokasi tempat Anda menyimpan kunci dan klik Selesai.

Batasi kunci yang dibatasi atau rahasia pada daftar atau rentang alamat IP

Untuk membatasi permintaan API menggunakan kunci ke satu atau beberapa alamat IP tertentu atau ke rentang alamat IP:

1. Buka halaman kunci API.
2. Di daftar Kunci standar atau Kunci terbatas, di baris kunci yang ingin Anda perlihatkan, klik menu perluasan (), lalu pilih Kelola pembatasan IP….
3. Klik Batasi penggunaan pada serangkaian alamat IP.
4. Masukkan alamat IP atau rentang alamat IP:
   • Untuk alamat IP perorangan, masukkan dalam bidang Alamat IP.
   • Untuk rentang alamat IP, masukkan rentang dalam notasi Classless Inter-Domain Routing (CIDR). Di bidang Alamat IP, masukkan alamat pertama dalam rentang tersebut. Di bidang CIDR, masukkan ukuran awalan jaringan.
   • Anda juga dapat memilih tab Kelola dalam jumlah besar serta memasukkan alamat IP dan rentang perorangan, dipisahkan dengan spasi. Perubahan yang Anda buat di satu tab muncul di tab lain.
5. Untuk menambahkan alamat atau rentang lain, klik + Tambahkan.
6. Klik Simpan.

Ubah nama atau catatan kunci API yang dibatasi atau rahasia

Untuk mengubah nama atau teks catatan dari kunci yang dibatasi atau rahasia:

1. Buka halaman kunci API.
2. Di baris untuk kunci yang ingin Anda ubah, klik menu perluasan (), kemudian pilih Edit kunci….
3. Jika Anda ingin mengubah nama, di Nama kunci, masukkan nama baru.
4. Jika Anda ingin mengubah teks catatan, di Catatan, masukkan teks catatan baru.
5. Klik Simpan.

Lihat log permintaan API

Untuk membuka log permintaan API, klik menu perluasan () untuk mendapat kunci, kemudian pilih Lihat log permintaan. Membuka log akan mengalihkan Anda ke Dashboard Stripe utama.