Brick API Documentation
Brick
Brick API

B2C Subaccount

Server

จัดการบัญชีย่อยไคลเอ็นต์ B2C การตั้งค่าคีย์สาธารณะ และการหมุนเวียนคีย์ API สำหรับการผสานรวม Brick หลายผู้เช่า ตำแหน่งข้อมูลเหล่านี้ช่วยให้แพลตฟอร์มแยกข้อมูลรับรองไคลเอ็นต์และดำเนินการบัญชีย่อยภายใต้พื้นที่ทำงาน Brick หลัก


[B2C Client] ตั้งค่า Public Key

POST
https://sandbox.onebrick.io
/v2/payments/general/client/public-key
publicAccessToken (header)
+X-Signature (header)
+X-Timestamp (header)

อัปโหลดคีย์สาธารณะ Brick ควรใช้เพื่อเข้ารหัสข้อมูลรับรองไคลเอ็นต์ B2C ที่สร้างขึ้นสำหรับบัญชีย่อย เรียกสิ่งนี้ก่อนที่จะสร้างบัญชีย่อย B2C เพื่อให้แพลตฟอร์มของคุณสามารถจัดการเนื้อหาลับของลูกค้าที่ส่งคืนได้อย่างปลอดภัย คำขอต้องใช้ส่วนหัวการตรวจสอบสิทธิ์ Brick และการตอบกลับยืนยันว่าคีย์การเข้ารหัสพร้อมสำหรับการจัดสรรบัญชีย่อยในภายหลัง

[B2C Client] ตั้งค่า Public Key › Request Body

publicKey
​string · binary

ไฟล์ที่มีคีย์สาธารณะของคุณในรูปแบบ .pem ขนาดสูงสุด 100KB

[B2C Client] ตั้งค่า Public Key › Responses

200

status
​integer
Default: 0
data
​
error
​
​object

[B2C Client] สร้าง Subaccount

POST
https://sandbox.onebrick.io
/v2/payments/general/b2c/sub-accounts
publicAccessToken (header)
+X-Signature (header)
+X-Timestamp (header)

สร้างบัญชีย่อย B2C ภายใต้พื้นที่ทำงาน Brick ของคุณสำหรับลูกค้า ผู้เช่า ผู้ค้า หรือหน่วยธุรกิจ ส่งรายละเอียดลูกค้าและบัญชีที่จำเป็นพร้อมกับส่วนหัวการตรวจสอบสิทธิ์ B2C Brick ส่งคืนตัวระบุบัญชีย่อยและข้อมูลประจำตัวที่เข้ารหัสซึ่งสามารถจัดเก็บไว้ในแพลตฟอร์มของคุณได้ ใช้ endpoint นี้เมื่อคุณต้องการแยกข้อมูลรับรองระหว่างลูกค้าปลายทาง ขณะเดียวกันก็รักษาการควบคุมการปฏิบัติงานจากส่วนกลาง

[B2C Client] สร้าง Subaccount › Request Body

name
​string · required

ชื่อของธุรกิจหรือผู้บริโภคแต่ละราย

subAccountCode
​string · required

รหัสตัวอักษรและตัวเลขที่ไม่ซ้ำกัน (สูงสุด 5 ตัวอักษร) ที่ใช้ในการระบุบัญชีย่อย

email
​string · required

ที่อยู่อีเมลติดต่อสำหรับบัญชีย่อย

address
​string · required

ที่อยู่ธุรกิจหรือที่อยู่อาศัยที่เกี่ยวข้องกับบัญชีย่อย

picture
​string · binary

(ไม่บังคับ) ไฟล์รูปภาพโลโก้ (สูงสุด 2 MB) เพื่อแสดงบัญชีย่อยแบบเห็นภาพ

[B2C Client] สร้าง Subaccount › Responses

200

No data returned

[B2C Client] สร้างคีย์ API ใหม่

POST
https://sandbox.onebrick.io
/v2/payments/general/b2c/sub-accounts/{subAccountCode}/regenerate-api-key
publicAccessToken (header)
+X-Signature (header)
+X-Timestamp (header)

สร้างคู่คีย์ API ใหม่สำหรับบัญชีย่อย B2C ที่มีอยู่ เมื่อข้อมูลรับรองจำเป็นต้องได้รับการหมุนเวียน บุกรุก หรือออกใหม่ คู่คีย์ก่อนหน้านี้ใช้งานไม่ได้หลังการสร้างใหม่ ดังนั้นควรอัปเดตบริการดาวน์สตรีมก่อนที่จะเปลี่ยนการรับส่งข้อมูล เฉพาะบทบาทเจ้าของ B2C ที่ได้รับอนุญาตเท่านั้นที่ควรเรียกสิ่งนี้ว่า endpoint และการตอบกลับควรถือเป็นข้อมูลรับรองที่ละเอียดอ่อน

[B2C Client] สร้างคีย์ API ใหม่ › path Parameters

subAccountCode
​string · required

[B2C Client] สร้างคีย์ API ใหม่ › Responses

200

status
​integer
Default: 0
message
​string
​object