Tạo đơn hàng

Tạo đơn hàng VA mới cho tài khoản BIDV hoặc Sacombank qua SePay API v2.

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

POST

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

Tham số

ba_xidstringrequired

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

va_prefixstringrequired (Sacombank)

Tiền tố VA (bắt buộc khi tài khoản là Sacombank). Ví dụ SEP200001WEB. Không dùng cho BIDV.

order_codestring

Mã đơn hàng (alphanumeric, 6-50 ký tự). Tự sinh nếu để trống.

amountintegerrequired (Sacombank)

Số tiền (số nguyên dương, tối đa 12 chữ số). Bắt buộc khi tài khoản là Sacombank (chỉ nhận đúng số tiền).

va_holder_namestring

Tên chủ VA. Liên hệ SePay để bật tính năng tùy chỉnh tên VA. Chữ hoa A-Z, số 0-9, khoảng trắng.

durationinteger

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

with_qrcodeenum

Bao gồm mã QR trong response (0 hoặc 1)

qrcode_templateenum

Mẫu mã QR

Khác biệt theo ngân hàng

Tham số	BIDV	Sacombank
`va_prefix`	Không cần	Bắt buộc. Xem Tiền tố VA.
`amount`	Tùy chọn	Bắt buộc (chỉ nhận đúng số tiền)
`va_holder_name`	Có (cần bật tính năng, liên hệ SePay)	Không hỗ trợ

Code mẫu

curl --request POST \
  --url https://userapi.sepay.vn/v2/bank-accounts/f9e8d7c6-b5a4-3210-fedc-ba0987654321/orders \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"va_prefix":"string","order_code":"string","amount":0,"va_holder_name":"string","duration":0,"with_qrcode":"0","qrcode_template":"compact"}'

Response (HTTP 201)

Response 201 - Tạo đơn hàng thành công

{
  "status": "success",
  "message": "Order created successfully",
  "data": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678902",
    "order_code": "ORDER2026001",
    "va_number": "963NQDORD1234567890AB",
    "va_holder_name": "TRAN THI B",
    "amount": 1000000,
    "status": "Pending",
    "bank_name": "BIDV",
    "account_holder_name": "TRAN THI B",
    "account_number": "1234567890",
    "expired_at": "2025-12-19 08:15:00",
    "qr_code": "data:image/png;base64,...",
    "qr_code_url": "https://qr.sepay.vn/img?acc=..."
  }
}

statusstring

messagestring

dataobject

Lỗi

HTTP	error_code	Mô tả
400	-	BIDV: Tài khoản không phải loại doanh nghiệp
400	-	Sacombank: Merchant chưa được kích hoạt
400	-	Sacombank: `va_prefix` không tồn tại hoặc đã bị hủy
409	duplicate	Trùng `order_code`
422	validation_error	Lỗi validation