Tiền tố VA

Quản lý tiền tố VA Sacombank qua SePay API v2. Bắt buộc khi tạo đơn hàng Sacombank.

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