VA Prefixes

Manage Sacombank VA prefixes via SePay API v2. Required when creating Sacombank VA orders.

A VA prefix (va_prefix) is the leading part of a Sacombank VA number that identifies the sales channel. Every Sacombank order requires an active VA prefix.

VA number format: {va_prefix}{random_alnum}, max 18 characters. Example: SEP200001WEB1234567.

Sacombank only

This API only applies to Sacombank accounts. Other banks return 422 unsupported_bank.

Manage at my.sepay.vn > Bank Accounts > Select Sacombank account > VA Order Prefixes.

List VA Prefixes

GET

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

Use the results to select a va_prefix when creating an order.

Parameters

ba_xidstringrequired

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

pageinteger

Số trang

Default: 1

per_pageinteger

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

Default: 20

Code Examples

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 - VA prefix list

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

Errors

HTTP	error_code	Description
400	-	Sacombank merchant not activated for this account
422	unsupported_bank	Bank account does not support VA prefixes (not Sacombank)

VA Prefix Fields

Field	Type	Description
`va_prefix`	string	Prefix string (e.g. `SEP200001WEB`)
`store_id`	string	Store/channel ID
`store_name`	string	Account holder name
`status`	string	`active` or `inactive`
`created_at`	string	Creation timestamp