Tiền tố VA

Tiền tố VA là phần đầu của số VA Sacombank, dùng để phân biệt kênh bán hàng. Mỗi đơn hàng Sacombank phải có một va_prefix đang hoạt động.

Định dạng số VA: {va_prefix}{chuỗi ngẫu nhiên}, tối đa 18 ký tự. Ví dụ: SEP200001WEB1234567.

Chỉ Sacombank

API này chỉ dùng cho tài khoản Sacombank. Ngân hàng khác trả lỗi 422 unsupported_bank.

Đăng ký tiền tố VA

Quản lý tại my.sepay.vn > Ngân hàng > Chọn tài khoản Sacombank > Tiền tố VA đơn hàng.

Danh sách tiền tố VA

GET

https://userapi.sepay.vn/v2/bank-accounts/{ba_xid}/prefixes

Kết quả dùng để chọn va_prefix khi tạo đơn hàng.

Tham số

ba_xidstringrequired

UUID tài khoản ngân hàng

pageinteger

Số trang

Mặc định: 1

per_pageinteger

Số bản ghi mỗi trang (tối đa 100)

Mặc định: 20

Code mẫu

curl --request GET \
  --url 'https://userapi.sepay.vn/v2/bank-accounts/f9e8d7c6-b5a4-3210-fedc-ba0987654321/prefixes?page=SOME_INTEGER_VALUE&per_page=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response (HTTP 200)

Response 200 - Danh sách tiền tố VA

{
  "status": "success",
  "data": [
    {
      "va_prefix": "SEP200001WEB",
      "store_id": "WEB",
      "store_name": "NGUYEN VAN A",
      "status": "active",
      "created_at": "2026-03-20 09:00:00"
    },
    {
      "va_prefix": "SEP200001POS",
      "store_id": "POS",
      "store_name": "NGUYEN VAN A",
      "status": "active",
      "created_at": "2026-03-21 14:00:00"
    }
  ],
  "meta": {
    "pagination": {
      "total": 2,
      "per_page": 20,
      "current_page": 1,
      "last_page": 1,
      "has_more": false
    }
  }
}

statusstring

dataarray<object>

metaobject

Lỗi

HTTP	error_code	Mô tả
400	-	Sacombank merchant chưa được kích hoạt cho tài khoản này
422	unsupported_bank	Tài khoản ngân hàng không hỗ trợ tiền tố VA (không phải Sacombank)

Thuộc tính tiền tố VA

Trường	Kiểu	Mô tả
`va_prefix`	string	Chuỗi tiền tố (ví dụ `SEP200001WEB`)
`store_id`	string	Mã kênh/cửa hàng
`store_name`	string	Tên chủ tài khoản
`status`	string	`active` hoặc `inactive`
`created_at`	string	Thời điểm tạo