บัญชีย่อย B2C

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

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": "encrypted_ck_test_xxx",
      "clientSecret": "encrypted_cs_test_xxx"
    },
  }
}

json

application/json

[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

OCR รายการเดินบัญชี

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

POST

https://sandbox.onebrick.io

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

publicAccessToken (header)

+X-Signature (header)

+X-Timestamp (header)

[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 Client] สร้าง Subaccount › Request Body

name

string · required

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

subAccountCode

string · required

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)

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

subAccountCode

string · required

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

200

status

integer

Default: 0

message

string

object