Create Virtual Account

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

POST

partners

mid

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

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

Get MID Balance List Virtual Accounts

Overview

Banks

Tokens

Exchange

Orders

Configurations

Prefunding

Merchant Virtual Account

Partners

Partner Customer KYC

Authentication

Body Parameters

​Authentication

​Body Parameters

Authentication

Body Parameters