Brick API Documentation
Brick

Orientasi Sub-akun B2C API

📘 API ini tersedia secara eksklusif untuk klien B2C

Mitra yang pengguna akhirnya adalah individu atau bisnis yang tidak terdaftar (yaitu, tanpa badan usaha yang sah). Akun Brick hanya dapat dikonfigurasi untuk mode B2B atau B2C, tidak keduanya.

Orientasi Sub-akun B2C API memungkinkan mitra Brick membuat dan mengelola sub-akun secara terprogram untuk pengguna akhir mereka. Ini ideal untuk platform yang melayani pembuat konten, pekerja lepas, atau pemilik usaha kecil.

API ini menggantikan alur orientasi manual dan mendukung siklus hidup penyediaan akun penuh, termasuk pembuatan kunci API otomatis, manajemen kredensial yang aman, dan penyiapan sub-akun yang disederhanakan.

Fitur Utama

  • Buat sub-akun secara terprogram melalui API
  • Secara otomatis menghasilkan client_key dan client_secret yang aman
  • Buat ulang kredensial jika disusupi atau kedaluwarsa
  • Unggah kunci publik untuk memverifikasi permintaan yang ditandatangani klien

Titik Akhir API

Sebelum mendalami titik akhir, pastikan Anda meninjau dan memahami cara membuat X-Signature yang digunakan di header permintaan. Anda dapat membaca panduan here.

  • Siapkan Kunci Publik Anda

    Mengunggah public key yang digunakan untuk memverifikasi komunikasi terenkripsi atau ditandatangani dari klien ke Brick.
    Langkah ini diperlukan sebelum membuat sub-akun.
    📘 Kunci publik yang diunggah harus dalam format PEM dan harus cocok dengan kunci pribadi yang dimiliki sistem Anda untuk menandatangani payload. Lihat Pengaturan Kunci Publik API.
  • Buat Subakun

    Membuat sub-akun baru dengan nama khusus, kode sub-akun, dan logo opsional. Lihat detailnya di B2C Client - Create Subaccount API reference.
  • Regenerasi Kunci API

    Gunakan titik akhir ini untuk memutar kunci API untuk sub-akun. Lihat detailnya di B2C Client - Regenerate API Key API reference.

⚠️ Penanganan Kesalahan

API mengembalikan pesan kesalahan standar untuk pemecahan masalah yang lebih mudah:

Respon Kesalahan

API mengembalikan pesan kesalahan standar untuk pemecahan masalah yang lebih mudah

Kode HTTPPesanDeskripsi
400Permintaan Tidak ValidBidang yang wajib diisi tidak ada, format masukan salah
400Gambar Terlalu BesarGambar yang diunggah melebihi batas ukuran yang diperbolehkan
401Tidak sahToken tidak valid atau token Pembawa hilang
404Subakun Tidak DitemukanSub-akun yang diminta tidak ada.
403TerlarangTindakan tidak diperbolehkan untuk jenis atau status akun saat ini
403Kunci Publik Tidak DitemukanKunci Publik belum diunggah oleh klien
409KonflikKode sub-akun duplikat
429Batas Nilai TerlampauiTerlalu banyak permintaan
500Kesalahan Server InternalKegagalan sistem—coba lagi nanti
Last modified on