> ## 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.

# Overview

Partner Merchant Virtual Account (MID) lets partners issue and manage virtual accounts under their assigned HPay merchant. Each virtual account is a bank account number that customers can transfer to; Holdstation Pay credits the funds to the partner and forwards a payment callback.

A partner can:

* **Create** a virtual account with a display name, remark, and expiration time.
* **List** all virtual accounts owned by the partner.
* **Get** a single virtual account by its account number.
* **Inquire** live transaction history for a virtual account.
* **Revoke** a virtual account (mark it expired).
* **Receive** a callback every time a customer transfers in.

See [Virtual Account](/guides/partner-merchant-virtual-account/virtual-account) for the full request/response shapes, and [Get MID Balance](/guides/partner-merchant-virtual-account/get-mid-balance) for balance queries.

<Note>
  Contact Holdstation to enable this feature and receive your MID.
</Note>

## Authentication

All MID endpoints use Ed25519 request signing. See [Request Signing](/guides/partner-authentication-signed-api/overview) for how to sign requests and upload your verify key.

## Virtual Account Lifecycle

| Status  | Value | Description                                                            |
| ------- | ----- | ---------------------------------------------------------------------- |
| Active  | `1`   | VA accepts incoming transfers                                          |
| Expired | `2`   | VA past its TTL or revoked                                             |
| Revoked | `4`   | VA explicitly revoked (returned by the revoke endpoint as `va_status`) |