Skip to main content
POST
https://apis.hopnow.io
/
v1
/
accounts
/
{account_id}
/
virtual-accounts
Create Virtual Account
curl --request POST \
  --url https://apis.hopnow.io/v1/accounts/{account_id}/virtual-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "<string>",
  "label": "<string>",
  "address": {
    "address_line": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  }
}
'
{
  "id": "<string>",
  "object": "<string>",
  "account_id": "<string>",
  "currency": "<string>",
  "bank_details": {
    "ibans": [
      {}
    ],
    "iban": "<string>",
    "bic": "<string>",
    "bank_name": "<string>",
    "account_number": "<string>",
    "routing_number": "<string>"
  },
  "reference": "<string>",
  "provider_reference_id": "<string>",
  "label": "<string>",
  "status": "<string>",
  "created": "<string>",
  "updated": "<string>"
}

​
Path Parameters

​
account_id
string
required
The account’s external ID (starts with acc_)

​
Request Body

​
currency
string
required
ISO 4217 currency code (e.g., USD, EUR, GBP)
​
label
string
required
User-friendly label for the virtual account (max 255 characters)
​
address
object
Beneficiary address

​
Response

​
id
string
Virtual account identifier (starts with va_)
​
object
string
Always returns "virtual_account"
​
account_id
string
Parent account ID
​
currency
string
Virtual account currency
​
bank_details
object
Banking details for receiving payments
​
reference
string
Reference for payment reconciliation
​
provider_reference_id
string
Provider reference identifier
​
label
string
User-friendly label
​
status
string
Virtual account status: active, suspended, or inactive
​
created
string
ISO 8601 timestamp when created
​
updated
string
ISO 8601 timestamp when last updated

​
Response Example

{
  "id": "va_1234567890abcdef",
  "object": "virtual_account",
  "account_id": "acc_1234567890abcdef",
  "currency": "EUR",
  "bank_details": {
    "ibans": ["DE89370400440532013000", "DE89370400440532013001"],
    "iban": "DE89370400440532013000",
    "bic": "DEUTDEFFXXX",
    "bank_name": "Deutsche Bank"
  },
  "provider_reference_id": "BC-123456",
  "reference": "REF-001",
  "label": "EU Collections",
  "status": "active",
  "created": "2024-01-01T00:00:00Z",
  "updated": "2024-01-01T00:00:00Z"
}