v1

latestOpenAPI 3.0.02026-07-24103118224.7 KB

Virtual Accounts

List virtual accounts

Returns the EUR and USD virtual accounts owned by the authenticated merchant. Each merchant can hold at most one virtual account per currency. When X-On-Behalf-Of is set, returns the virtual accounts of the targeted sub-merchant.

The response also exposes usesFallbackCustomerId, which is true when the merchant has not yet been provisioned with a dedicated underlying-provider customer; in that case no new virtual account can be created.

get/api/virtual-account

Response

Virtual accounts grouped by deposit currency

usesFallbackCustomerIdboolean required

True when the merchant is currently using Inflow's fallback Bridge customer ID. Such merchants cannot create new virtual accounts until a dedicated customer is provisioned.

Example response

{
  "eur": {
    "id": "virt_1234567890abcdef",
    "depositCurrency": "eur",
    "countryCode": "FR",
    "iban": "FR7630006000011234567890189",
    "bic": "BNPAFRPP",
    "accountNumber": "123456789",
    "routingNumber": "021000021",
    "accountOwnerName": "Inflow Technologies SAS",
    "bankName": "JP Morgan Chase",
    "bankAddress": "270 Park Ave, New York, NY 10017, US",
    "beneficiaryAddress": "1 Hacker Way, Menlo Park, CA 94025, US",
    "externalId": "ba_1234567890abcdef",
    "userId": "user_1234567890abcdef",
    "createdAt": "2025-01-15T10:00:00.000Z",
    "updatedAt": "2025-01-15T10:00:00.000Z"
  },
  "usd": {
    "id": "virt_1234567890abcdef",
    "depositCurrency": "eur",
    "countryCode": "FR",
    "iban": "FR7630006000011234567890189",
    "bic": "BNPAFRPP",
    "accountNumber": "123456789",
    "routingNumber": "021000021",
    "accountOwnerName": "Inflow Technologies SAS",
    "bankName": "JP Morgan Chase",
    "bankAddress": "270 Park Ave, New York, NY 10017, US",
    "beneficiaryAddress": "1 Hacker Way, Menlo Park, CA 94025, US",
    "externalId": "ba_1234567890abcdef",
    "userId": "user_1234567890abcdef",
    "createdAt": "2025-01-15T10:00:00.000Z",
    "updatedAt": "2025-01-15T10:00:00.000Z"
  }
}