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_keydanclient_secretyang 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 HTTP | Pesan | Deskripsi |
|---|---|---|
| 400 | Permintaan Tidak Valid | Bidang yang wajib diisi tidak ada, format masukan salah |
| 400 | Gambar Terlalu Besar | Gambar yang diunggah melebihi batas ukuran yang diperbolehkan |
| 401 | Tidak sah | Token tidak valid atau token Pembawa hilang |
| 404 | Subakun Tidak Ditemukan | Sub-akun yang diminta tidak ada. |
| 403 | Terlarang | Tindakan tidak diperbolehkan untuk jenis atau status akun saat ini |
| 403 | Kunci Publik Tidak Ditemukan | Kunci Publik belum diunggah oleh klien |
| 409 | Konflik | Kode sub-akun duplikat |
| 429 | Batas Nilai Terlampaui | Terlalu banyak permintaan |
| 500 | Kesalahan Server Internal | Kegagalan sistem—coba lagi nanti |