Entities and spaces
Entities
Entities are legal organizations (companies) or natural persons (private individuals) that become part of the Banqup platform upon successful onboarding.
Every entity in Banqup has a unique identifier, which will be needed to perform a number of API calls on the Banqup Developer Portal.
To get the entity ID for a given company or natural person, call GET/entities.
Spaces
During the onboarding process of a Banqup entity, a first space is created. Spaces are virtual environments where all relevant resources of an entity are managed. Spaces can also facilitate document exchange and communication among entities, depending on the space type.
The role of spaces is to gather all relevant data of an entity into one accessible setting. Such data can include: invoices, connections, cards, clients, payments, users, installed apps etc. The capabilities offered by a space depends on the space type and the active subscription.
Every space in Banqup has a unique identifier that is needed when performing certain API calls on a space.
To retrieve the space ID, call GET/entities/entityId/spaces, providing the
entityId.
Space types
There are different types of spaces available in Banqup, each designed for different types of organizations and requirements.
Business spaces
A business space is owned by a legal organization or a sole trader (a self-employed person who owns and runs a business as an individual).
One company can have multiple business spaces. This can be useful if the company has multiple branches, or if the company needs a separate business space for a distinct department.
This space type supports common business needs like invoicing, payments, financing, document exchange, communication with other Banqup connections and more.
Personal spaces
A personal space is similar to a business space, but intended for consumers (natural persons) who can centralize receiving documents and make payments, e.g. in-store and online, exchanging money between individuals, all on national or international level.
Partner spaces
A partner is a Banqup space owner that is authorized to manage multiple other Banqup spaces, whose owners are the partner's clients. This allows partners to easily access and manage financial or other data of their clients. For example, in this way, accounting documents don't need to be sent to the accountant, but are shared in real time directly on the space.
Besides accountants, partners could also be: associations, guardians, software partners or financial institutions.
A partner space can also be used for invitation campaigns by a reseller or to enable caretakers to manage the finances of their clients.
Space management
During the onboarding process the first space and the first user are created. Other spaces can be added later to the entity. The entity that initiates the onboarding is considered the owner of the space and the data contained in it.
As the owner of a space, you can manage multiple settings and functionalities, change the subscription, invite other users, install additional extensions, etc.
For a more visual representation of entities, spaces and how they are interconnected, check out the diagram below:
