Brick API Documentation
Brick
Brick API

Bank Account Validation

Server

ตรวจสอบรายละเอียดบัญชีธนาคารอินโดนีเซียก่อนบันทึกผู้รับผลประโยชน์หรือเริ่มการจ่ายเงิน การตรวจสอบบัญชีช่วยลดการโอนเงินล้มเหลว หมายเลขบัญชีผิด และปัญหาการกระทบยอดในการดำเนินงาน

Client Reference

clientReference เป็น query parameter แบบไม่บังคับที่ client สามารถกำหนดเป็น custom unique reference สำหรับคำขอ Bank Account Validation แต่ละครั้ง ใช้ field นี้เพื่อช่วยติดตาม จับคู่ธุรกรรม และกระทบยอดกับ reference ภายในของ client เอง

ค่าที่รองรับ: alphanumeric, hyphen (-), underscore (_), และ period (.), สูงสุด 64 อักขระ หากส่ง clientReference เป็นค่าว่าง จะถือว่าไม่ได้ส่งพารามิเตอร์นี้ หาก client เดียวกันส่ง clientReference ซ้ำ Brick จะตอบกลับ 409 duplicate_reference.

Request without clientReference

Code
GET https://api.onebrick.io/v2/payments/gs/bank-account-validation?accountNumber=<ACCOUNT_NUMBER>&bankShortCode=BCA_SYR Headers: Accept: application/json Content-Type: application/json publicAccessToken: Bearer <token>

Response without clientReference

JSONCode
{ "status": 200, "data": { "message": "Bank account validation has been completed successfully, and the submitted account details have been verified.", "bankShortCode": "BCA_SYR", "accountNo": "<ACCOUNT_NUMBER>", "accountName": "<ACCOUNT_NAME>", "activityId": "7b63f490900376f0f60aab63afde17d5" }, "error": null, "metaData": { "source": "API", "entity": "Payment" } }

Request with clientReference

Code
GET https://api.onebrick.io/v2/payments/gs/bank-account-validation?accountNumber=<ACCOUNT_NUMBER>&bankShortCode=BCA_SYR&clientReference=BAV_TEST-001 Headers: Accept: application/json Content-Type: application/json publicAccessToken: Bearer <token>

Response with clientReference

JSONCode
{ "status": 200, "data": { "message": "Bank account validation has been completed successfully, and the submitted account details have been verified.", "bankShortCode": "BCA_SYR", "accountNo": "<ACCOUNT_NUMBER>", "accountName": "<ACCOUNT_NAME>", "activityId": "a7014608c43969d890ea0fbf1cfc493e", "clientReference": "BAV_TEST-001" }, "error": null, "metaData": { "source": "API", "entity": "Payment" } }

Duplicate clientReference response

JSONCode
{ "status": 409, "data": null, "error": { "code": "duplicate_reference", "message": "clientReference has already been used.", "action": "Please use a unique clientReference for each Bank Account Validation request.", "reason": "The provided clientReference already exists." }, "metaData": { "source": "API", "entity": "Payment" } }

การยืนยันบัญชี API

GET
https://sandbox.onebrick.io
/v2/payments/gs/bank-account-validation
publicAccessToken (header)

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

การยืนยันบัญชี API › query Parameters

accountNumber
​string · required

หมายเลขบัญชีธนาคารที่ต้องการตรวจสอบ

Default:
bankShortCode
​string · required

รหัสย่อธนาคารที่ต้องการตรวจสอบ ตัวอย่างใน collection: MANDIRI

Default:
clientReference
​string · maxLength: 64 · pattern: ^[A-Za-z0-9._-]*$

ข้อมูลอ้างอิงแบบไม่บังคับที่ระบบลูกค้าส่งมาเพื่อการติดตาม การจับคู่ธุรกรรม และการกระทบยอด ใช้ได้สูงสุด 64 อักขระ: ตัวอักษร ตัวเลข ยัติภังค์ (-), underscore (_), หรือจุด (.) เว้นว่างหรือไม่ส่งพารามิเตอร์นี้หากไม่ต้องการส่ง client reference.

Default:

การยืนยันบัญชี API › Responses

200 สำเร็จ

oneOf
Exactly one variant must match.

Decision Table

VariantMatching Criteria
type = object
type = object
Properties for Success:
status
​integer
​object
error
​
​object