{
"va_name": "PARTNER ABC ORDER 12345",
"remark": "order-12345",
"va_expiration_time": 1735689600
}
{
"message": "success",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"partner_id": "partner-xyz",
"va_account": "1234567890",
"va_name": "PARTNER ABC ORDER 12345",
"va_bank": "Vietcombank",
"remark": "order-12345",
"status": 1,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z",
"expired_at": "2025-01-01T00:00:00Z"
}
}
Merchant Virtual Account
Create Virtual Account
Create a multi-use virtual account under the partner’s assigned HPay merchant.
POST
/
partners
/
mid
/
va
{
"va_name": "PARTNER ABC ORDER 12345",
"remark": "order-12345",
"va_expiration_time": 1735689600
}
{
"message": "success",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"partner_id": "partner-xyz",
"va_account": "1234567890",
"va_name": "PARTNER ABC ORDER 12345",
"va_bank": "Vietcombank",
"remark": "order-12345",
"status": 1,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z",
"expired_at": "2025-01-01T00:00:00Z"
}
}
Create a multi-use virtual account under the partner’s assigned HPay merchant. The VA is stored in Holdstation Pay and can be managed via the list, get, inquiry, and revoke endpoints.
Authentication
string
required
Your partner app key.
string
required
Base64-encoded Ed25519 signature of the sign data.
string
required
Unix timestamp (seconds) of the request. Must be within 60 seconds of server time.
Body Parameters
string
required
Display name for the virtual account (max 200 chars).
string
required
Optional remark for the virtual account (max 50 chars).
integer | null
required
Expiration as a Unix timestamp (seconds). Pass
null to use the maximum allowed TTL.{
"va_name": "PARTNER ABC ORDER 12345",
"remark": "order-12345",
"va_expiration_time": 1735689600
}
{
"message": "success",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"partner_id": "partner-xyz",
"va_account": "1234567890",
"va_name": "PARTNER ABC ORDER 12345",
"va_bank": "Vietcombank",
"remark": "order-12345",
"status": 1,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z",
"expired_at": "2025-01-01T00:00:00Z"
}
}