Bank Account Detail API

API to retrieve detailed information of a specific bank account, including primary account details and the list of linked Virtual Accounts.

API Endpoint

GET

https://bankhub-api-sandbox.sepay.vn/v1/bank-account/{bank_account_id}

Path Parameters

bank_account_idstringrequired

Bank account ID

Note

This API requires a Bearer Token in the Authorization header
The bank account must belong to the authenticated merchant
The response includes the Virtual Account list (if any)

Error Handling

401Unauthorized

The access token is invalid or has expired

404Not Found

The account does not exist or does not belong to this merchant

API Response

Response 200 - Success

{
  "data": {
    "xid": "string",
    "company_xid": "string",
    "brand_name": "string",
    "account_holder_name": "string",
    "account_number": "string",
    "accumulated": "string",
    "bank_api_connected": "string",
    "active": "string",
    "last_transaction": "string",
    "identification_number": "string",
    "phone_number": "string",
    "created_at": "string",
    "updated_at": "string",
    "va_list": [
      {
        "xid": "string",
        "sub_account": "string",
        "sub_holder_name": "string",
        "active": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ]
  }
}

dataobject

Account detail information

Code Examples

curl --request GET \
  --url https://bankhub-api-sandbox.sepay.vn/v1/bank-account/780717f8-eeb6-11f0-b16e-52c7e9b4f41b \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Usage Examples

JSGet bank account details

curl --location 'https://bankhub-api-sandbox.sepay.vn/v1/bank-account/ba_abc123xyz' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Important Notes

Virtual Account (VA): Virtual accounts are sub-accounts created from a primary bank account, helping distinguish incoming funds from different customers
Identification Number: Citizen ID/Identity number used for verification and compliance purposes
Phone Number: Phone number used to receive notifications and verify transactions
Empty VA List: If va_list is empty ([]), no virtual accounts have been created for this bank account yet