Autentikasi API

Setiap request API pembayaran memerlukan API key. Key menentukan project dan environment yang boleh diakses oleh backend Anda.

Siapkan key TEST

Pilih workspace dan project di aplikasi Valcentra.
Buka API Keys, lalu buat key untuk TEST dengan akun yang memiliki izin.
Simpan nilai secret saat ditampilkan. Nilai lengkap tidak dapat dibaca ulang dari daftar key.
Masukkan key ke environment backend atau secret manager. Contoh panduan memakai nama TEST_API_KEY.

Jika akses ditolak di dashboard, minta bantuan anggota workspace yang memiliki izin mengelola key. Mengganti ID pada request bukan cara mendapatkan akses.

Kirim header Bearer

Mengambil pembayaran dengan key TEST

curl "$VALCENTRA_API_URL/v1/payments/$PAYMENT_ID" \
  --header "Authorization: Bearer $TEST_API_KEY"

Gunakan satu spasi antara Bearer dan nilai key. Anda tidak perlu mengirim cookie login dashboard atau workspace ID. ID pembayaran saja tidak memberikan akses ke pembayaran project lain.

Bedakan API key dan webhook secret

Secret	Digunakan oleh	Tujuan
API key	Backend Anda ketika memanggil API Valcentra	Mengautentikasi request ke project/environment.
Webhook secret	Backend Anda ketika menerima webhook	Memverifikasi signature dari endpoint webhook tertentu.

Keduanya tidak saling menggantikan. Jangan memakai API key untuk menghitung signature webhook.

Simpan credential dengan aman

Jangan menaruh key pada JavaScript browser, aplikasi mobile, URL, screenshot, atau repository.
Jangan mencetak header Authorization atau seluruh konfigurasi environment ke log.
Gunakan credential terpisah untuk konteks pengujian yang berbeda; jangan membagikan satu secret melalui chat.
Jika key bocor, cabut key tersebut dan buat penggantinya. Perbarui backend, lalu uji akses dengan key baru.
Setelah mengganti key, periksa kembali status pembayaran yang sedang berjalan. Deduplikasi create payment terikat pada key yang digunakan; lihat idempotensi.

Menangani HTTP 401

Kode error	Yang perlu diperiksa
`authentication_required`	Header Bearer hilang atau formatnya tidak sesuai.
`authentication_failed`	Nilai key salah, tidak aktif, atau sudah dicabut.

Periksa sumber konfigurasi dan status key tanpa menampilkan nilainya di log. Jangan mengulang HTTP 401 terus-menerus; perbaiki credential dulu. Simpan request_id jika perlu meminta bantuan.

Lanjutkan ke: Quickstart untuk request pertama, atau environment untuk batas TEST dan produksi.