Tạo VA cho đơn hàng

Tạo VA mới cho đơn hàng hiện có qua SePay API v2. Đơn hàng phải ở trạng thái Pending hoặc Partially (BIDV) / Pending (Sacombank).

Tạo VA mới cho đơn hàng

POST

https://userapi.sepay.vn/v2/bank-accounts/{ba_xid}/orders/{order_xid}/va

Thông tin

Đơn hàng phải ở trạng thái Pending hoặc Partially. Sacombank không có Partially, chỉ cho phép khi Pending.

Tham số

ba_xidstringrequired

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

order_xidstringrequired

UUID đơn hàng

amountinteger

Số tiền, không được vượt quá số tiền đơn hàng

va_holder_namestring

Tên chủ VA. Bắt buộc nếu đã bật tính năng tùy chỉnh tên VA.

durationinteger

Thời hạn VA tính bằng giây

Code mẫu

curl --request POST \
  --url https://userapi.sepay.vn/v2/bank-accounts/f9e8d7c6-b5a4-3210-fedc-ba0987654321/orders/b2c3d4e5-f6a7-8901-bcde-f12345678902/va \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"amount":0,"va_holder_name":"string","duration":0}'

Response (HTTP 201)

Response 201 - Tạo VA thành công

{
  "status": "success",
  "message": "VA created successfully",
  "data": {
    "va_number": "963NQDORD1234567890CD",
    "va_holder_name": "TRAN THI B",
    "amount": 500000,
    "status": "Unpaid",
    "expired_at": "2025-12-19 08:15:00"
  }
}

statusstring

messagestring

dataobject

Lỗi

HTTP	error_code	Mô tả
422	invalid_state	Trạng thái đơn hàng không phải `Pending` hoặc `Partially`