Skip to main content
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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://pay-docs.holdstation.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Partner-App-Key
string
required
Your partner app key.
​
X-HSPay-Signature
string
required
Base64-encoded Ed25519 signature of the sign data.
​
X-HSPay-Timestamp
string
required
Unix timestamp (seconds) of the request. Must be within 60 seconds of server time.

​
Body Parameters

​
va_name
string
required
Display name for the virtual account (max 200 chars).
​
remark
string
required
Optional remark for the virtual account (max 50 chars).
​
va_expiration_time
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"
  }
}