B2C Subaccount

Server

Kelola sub-akun klien B2C, penyiapan kunci publik, dan rotasi kunci API untuk integrasi Brick multi-penyewa. Titik akhir ini membantu platform mengisolasi kredensial klien dan mengoperasikan sub-akun di bawah ruang kerja Brick utama.

[B2C Client] Setup Public Key

POST

https://sandbox.onebrick.io

/v2/payments/general/client/public-key

publicAccessToken (header)

+X-Signature (header)

+X-Timestamp (header)

Unggah kunci publik yang harus digunakan Brick untuk mengenkripsi kredensial klien B2C yang dihasilkan untuk sub-akun. Hubungi ini sebelum membuat sub-akun B2C sehingga materi rahasia klien yang dikembalikan dapat ditangani dengan aman oleh platform Anda. Permintaan tersebut memerlukan header autentikasi Brick dan responsnya mengonfirmasi bahwa kunci enkripsi siap untuk penyediaan sub-akun berikutnya.

[B2C Client] Setup Public Key › Request Body

publicKey

string · binary

File yang berisi Kunci publik Anda dalam format .pem. Ukuran maksimal 100KB.

[B2C Client] Setup Public Key › Responses

200

status

integer

Default: 0

data

error

object

[B2C Client] Buat Subaccount

POST

https://sandbox.onebrick.io

/v2/payments/general/b2c/sub-accounts

publicAccessToken (header)

+X-Signature (header)

+X-Timestamp (header)

Buat sub-akun B2C di bawah ruang kerja Brick Anda untuk klien, penyewa, pedagang, atau unit bisnis. Kirim detail pelanggan dan akun yang diperlukan dengan header otentikasi B2C; Brick mengembalikan pengidentifikasi sub-akun dan kredensial terenkripsi yang dapat disimpan di platform Anda. Gunakan endpoint ini ketika Anda memerlukan pemisahan kredensial di seluruh pelanggan akhir sambil tetap menjaga kontrol operasional terpusat.

[B2C Client] Buat Subaccount › Request Body

name

string · required

Nama bisnis atau konsumen individu

subAccountCode

string · required

Kode alfanumerik unik (maks. 5 karakter) yang digunakan untuk mengidentifikasi sub-akun

email

string · required

Alamat email kontak untuk sub-akun

address

string · required

Alamat bisnis atau tempat tinggal yang terkait dengan sub-akun

picture

string · binary

(Opsional) File gambar logo (maks. 2 MB) untuk mewakili sub-akun secara visual

[B2C Client] Buat Subaccount › Responses

200

No data returned

POST/v2/payments/general/b2c/sub-accounts

curl https://sandbox.onebrick.io/v2/payments/general/b2c/sub-accounts \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'publicAccessToken: <api-key>' \
  --header 'X-Signature: <api-key>' \
  --header 'X-Timestamp: <api-key>' \
  --data '{
  "name": "name",
  "subAccountCode": "subAccountCode",
  "email": "email",
  "address": "address",
  "picture": "<binary>"
}'

Example Request Body

{
  "name": "name",
  "subAccountCode": "subAccountCode",
  "email": "email",
  "address": "address",
  "picture": "<binary>"
}

json

Example Responses

{
  "status": 200,
  "message": "Subaccount created successfully",
  "data": {
    "status": "approved",
    "apiKey": {
      "clientKey": "YOUR_CLIENT_ID",
      "clientSecret": "YOUR_CLIENT_SECRET"
    }
  }
}

json

application/json

[B2C Client] Regenerate API Key

POST

https://sandbox.onebrick.io

/v2/payments/general/b2c/sub-accounts/{subAccountCode}/regenerate-api-key

publicAccessToken (header)

+X-Signature (header)

+X-Timestamp (header)

Buat ulang pasangan kunci API untuk sub-akun B2C yang ada ketika kredensial perlu dirotasi, disusupi, atau diterbitkan ulang. Pasangan kunci sebelumnya tidak valid setelah regenerasi, jadi perbarui layanan downstream sebelum mengalihkan lalu lintas. Hanya peran pemilik B2C yang berwenang yang boleh menyebut ini endpoint, dan responsnya harus diperlakukan sebagai materi kredensial sensitif.

[B2C Client] Regenerate API Key › path Parameters

subAccountCode

string · required

[B2C Client] Regenerate API Key › Responses

200

status

integer

Default: 0

message

string

object

Authentication BIFAST Disbursement