Skip to main content
Get virtual account status

Authorizations

X-TXC-APIKEY
string
header
required

The public WhiteBIT API key.

X-TXC-PAYLOAD
string
header
required

Base64-encoded JSON request body.

X-TXC-SIGNATURE
string
header
required

HMAC-SHA512 signature of the payload, hex-encoded. Computed as hex(HMAC-SHA512(payload, api_secret)).

Body

application/json
ticker
string
required

Base currency ticker of the fiat currency. Use EUR.

Example:

"EUR"

provider
string
required

Fiat provider of the virtual account. Use SEPA_BCB_GROUP.

Example:

"SEPA_BCB_GROUP"

request
string
required

Request path. See the authentication guide for signature generation details.

Example:

"{{request}}"

nonce
integer
required

A unique identifier for the request. Use a monotonically increasing value such as a Unix timestamp in milliseconds.

Example:

1594297865000

Response

Virtual account status returned

status
enum<string>
required

Virtual account status:

  • pending — registration accepted, the provider has not allocated the account yet.
  • active — the account is allocated and accepts deposits.
  • rejected — the provider refused to open the account. Submit a new registration request.
  • closed — the account is closed. Submit a new registration request.
  • notFound — the account has no virtual account with the provider.
Available options:
pending,
active,
rejected,
closed,
notFound
paymentDetails
object

Bank details of the virtual account. Present only when status is active.