Bank Account Validation

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

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

Code
{
  "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

Code
{
  "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

Code
{
  "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"
  }
}