Bank Account Validation

Verifikasi detail rekening bank Indonesia sebelum menyimpan penerima atau memulai pembayaran. Validasi rekening mengurangi transfer gagal, nomor rekening salah ketik, dan masalah rekonsiliasi operasional.

Client Reference

clientReference adalah query parameter opsional yang dapat ditentukan oleh client sebagai custom unique reference untuk setiap request Bank Account Validation. Gunakan field ini untuk mempermudah tracking, matching transaksi, dan proses rekonsiliasi menggunakan reference internal milik client sendiri.

Nilai yang didukung: alphanumeric, hyphen (-), underscore (_), dan period (.), maksimal 64 karakter. clientReference kosong diperlakukan sama seperti tidak dikirim. Jika client yang sama mengirim clientReference duplikat, Brick mengembalikan 409 duplicate_reference.

Request tanpa 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 tanpa 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 dengan 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 dengan 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"
  }
}

Response duplicate clientReference

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