Ambil API key

API key membuat servermu bisa memanggil Merchant API. Setiap key hanya berlaku di satu environment: sandbox key (bk_test_…) bekerja dengan data uji, dan live key (bk_live_…) memindahkan uang sungguhan.

Buat key

1. Pastikan pemilih environment menunjukkan environment yang kamu mau.

2. Buka API Key di menu (atau tab API key pada proyek, untuk key yang hanya berlaku di proyek itu), lalu pilih Buat key.

3. Pilih izin yang dibutuhkan key: baca pembayaran, buat pembayaran, baca invoice, buat dan terbitkan invoice, baca webhook, kelola webhook, baca saldo. Beri hanya yang dibutuhkan servermu. Invoice punya izin sendiri karena menerbitkannya mengirim email ke pelangganmu.

   

4. Opsional: atur alamat yang diizinkan (satu alamat IP atau rentang per baris; kosong berarti alamat apa pun), kedaluwarsa, dan deskripsi untuk dirimu.

5. Buat, dan salin key-nya sekarang. Key lengkap hanya ditampilkan sekali. Simpan di secret manager servermu; kalau hilang, buat yang baru.

   

Membuat live key membutuhkan akun yang terverifikasi dan faktor kedua: kode enam digit dari aplikasi authenticator, atau kata sandimu dan kode yang kami kirim lewat email.

Jaga keamanan key

• Jangan taruh key di aplikasi mobile, halaman web, repository, atau URL.
• Pakai key terpisah untuk tiap server atau layanan, supaya satu bisa dicabut tanpa mengganggu yang lain.
• Batasi key ke alamat tempat servermu memanggil. Panggilan dari tempat lain ditolak.

Putar key

Pilih Putar pada sebuah key untuk membuat yang baru dengan izin yang sama. Key lama tetap bekerja selama 24 jam supaya kamu bisa berpindah, lalu berhenti. Memutar live key meminta faktor kedua.

Cabut key

Pilih Cabut kalau key bocor atau tidak dipakai lagi. Request dengan key itu langsung berhenti bekerja dan ini tidak bisa dibatalkan. Alasan bersifat opsional dan disimpan bersama key.

Selanjutnya

Cara key dikirim dan apa yang boleh dilakukannya ada di Autentikasi. Untuk memakainya, lanjut ke Quickstart.