This guide provides step-by-step instructions for onboarding new business customers for Digital Banking and Cards products using the Solaris API. You will learn which information is mandatory and which endpoints and webhooks to integrate.
For a comprehensive overview of onboarding requirements, check the Onboarding requirements guide.
Onboarding a business requires creating multiple resources to represent the legal entity and the natural persons associated with it.
You must manage two distinct streams of data simultaneously:
| Information Stream | Description | Target Resource |
|---|---|---|
| Business Information | Details about the legal entity (e.g., name, registration number, tax info). | The company or organization (business resource). |
| Person Information | Personal details of the individuals who own, represent, or act for the business. | Legal representatives, beneficial owners, and authorized persons (person resource). |
Verification occurs at two levels:
- Legal identification: Solaris verifies the legal entity.
- Video identification: The service provider (IDnow) identifies the natural persons. Note that only persons assigned to specific roles require video identification.
The Business Resource
In the API, a business represents the legal entity (the company). The business is the account holder and owner of the funds. A business must have at least one natural person attached to it.
The Person Resource
Natural persons (humans) are represented by person resources. They do not own the account but are authorized to act on behalf of the business.
Roles
You must assign a specific role to every person attached to a business. A single person can hold multiple roles (e.g., a Legal Representative who is also a Beneficial Owner).
The following roles are available:
- Legal Representative: Represents the company legally.
- Ultimate Beneficial Owner (UBO): Owns or controls the company.
- Authorized Person: Authorized to access the account (usually the Legal Representative, but can be others).
- Signee: Restricted role for signing documents or viewing info.
You must assign at least one Legal Representative and one Ultimate Beneficial Owner to every business customer.
Before starting the onboarding process, implement the following prerequisites:
1. Technical setup:
Set up your environment and get your authentication keys. For step-by-step instructions, check the Technical setup guide.
2. Legal and compliance screens:
Build the following legal and compliance screens into your sign-up flow. The linked Legal and compliance screens guide contains detailed instructions for each.
The following screens are required to onboard B2B customers for Digital Banking & Cards:
- Terms and Conditions: Present Solaris's T&Cs and collect the customer's consent.
- Customer information: Inform the customer about data processing and collect their consent.
- Business tax declaration: Display the required tax declaration text and collect the business's tax information.
- FATCA indication: Determine if the business is subject to US tax law (FATCA).
- Self-declaration as a politically exposed person (PEP): Collect a PEP declaration for all relevant persons. (Only for customers in France, Italy, and Spain)
- Compliance screen: Display Solaris's compliance disclaimer before starting the identification process.
Record the customer's consent on each screen as a UTC timestamp (e.g., 2019-01-01T00:00:00Z). Afterward, you must pass each timestamp in its respective field to Solaris.
- Collect the customer's consent to Solaris's Terms and Conditions and store the timestamp in the
terms_conditions_signed_atfield. - Collect the customer's consent to data processing and store the timestamp in the
data_terms_signed_atfield. - Collect the customer's FATCA indication and store it in the
fatca_relevantfield. Store the timestamp in thefatca_crs_confirmed_atfield.
- All legal representative(s) of the business, beneficial owner(s) and authorized person(s) must consent to FATCA related fields.
- Only legal representative(s) and authorized person(s) on the account must consent to Solaris' terms and conditions and data terms fields.
The following diagram outlines the integration process for onboarding business customers. Click on each step to jump to the relevant section.
| Category | Step | Description |
|---|---|---|
| Business Registration | Step 1 | Collect mandatory business data and create a business resource. |
| Business Registration | Step 2 | Collect required documents and create document resources. |
| Person Registration | Step 3 | 3.1. Collect data and create person resources for all legal representatives. 3.2. Assign the legal representative role. |
| Person Registration | Step 4 | 4.1. Collect data and create person resources for all beneficial owners. 4.2. Assign the beneficial owner role. |
| Tax Info | Step 5 | 5.1. Create business tax identification. 5.2. Create person tax identifications for all related persons. |
| Identification | Step 6 | 6.1. Trigger Business KYC (BKYC) and video identification. 6.2. Implement manual video ID. 6.3. Handle compliance questions. 6.4. Verify Customer Due Diligence (CDD) status. 6.5. Verify FATCA status. |
| Account | Step 7 | Create an account opening request. |
| Auth. Persons | Step 8 | Add all legal representatives as authorized persons on the account. |
| Cards | Step 9 | Create and activate the business card. |
| Optional | Step 10 | Add optional roles (e.g., Signees, other Authorized Persons). |
To view a larger version, right-click the image and select "Open in a new tab".
Solaris recommends subscribing to the following webhook events to better automate your processes. For detailed instructions on implementing Solaris webhooks, check the webhooks documentation.
- ACCOUNT_BLOCK
- ACCOUNT_CLOSURE_REQUEST
- ACCOUNT_CLOSURE
- BENEFICIAL_OWNER
- BOOKING
- BUSINESS_CHANGED
- BUSINESS_DELETED
- BUSINESS_SEIZURE_CREATED
- BUSINESS_SEIZURE_DELETED
- BUSINESS_SEIZURE_FULFILLED
- BUSINESS_SEIZURE_UPDATED
- BUSINESS_IDENTIFICATION
- BUSINESS_TAX_IDENTIFICATION_CHANGED
- CARD_LIFECYCLE_EVENT
- CARD_AUTHORIZATION
- CARD_AUTHORIZATION_DECLINE_V2
- CARD_AUTHORIZATION_RESOLUTION
- CARD_FRAUD_CASE_PENDING
- CARD_FRAUD_CASE_TIMEOUT
- IDENTIFICATION
- LEGAL_REPRESENTATIVE
- PERSON_CHANGED
- PERSON_DELETED
- PERSON_SEIZURE_CREATED
- PERSON_SEIZURE_DELETED
- PERSON_SEIZURE_FULFILLED
- PERSON_SEIZURE_UPDATED
- PERSON_MOBILE_NUMBER_CREATED
- PERSON_MOBILE_NUMBER_DELETED
- PERSON_TAX_IDENTIFICATION_CHANGED
- POSTBOX_ITEM_CREATED
- SCA_CHALLENGE
You must integrate all mandatory features highlighted in the Onboarding requirements guide before going live.
Collect mandatory data points in your sign-up flow, including timestamps for the business's consent to the legal and compliance screens.
Pass this data to Solaris by creating a business resource.
For a complete list of endpoints, properties, and examples related to the business resource, visit the following links:
Related webhook events
- Review the special considerations for data collection highlighted in the onboarding requirements guide.
- You must submit the information exactly as it appears in official documents.
- When testing in the Sandbox, ensure that each business you create has unique values for
name,postal_code,legal_form, andregistration_number(if provided). If you create over 1000 identical business resources, the API returns a400error.
The mandatory data points required for businesses may differ depending on the country in which you're opening the account. The following example outlines the mandatory fields for Germany. For information about other countries, please refer to the Onboarding requirements guide
There are certain mappings between the fields
tax_country,sector, andlegal_form. Check this section for more information.
This endpoint creates a business resource for your customer. You must collect the following mandatory data points from the customer in your sign-up flow and pass it to Solaris in the request body of this endpoint:
nameaddressline_1line_2postal_codecitycountry
sectorlegal_formnace_codefoundation_datecrs_company_typeorregistration_typebusiness_purposetax_informationtax_countrytax_confirmationregistration_issuer: For Germany, it must be preceded by AMTSGERICHT (e.g., AMTSGERICHT Berlin).registration_number
registration_districtterms_conditions_signed_atdata_terms_signed_atfatca_relevantfatca_crs_confirmed_at
Request URL:
POST /v1/businessesClick here to view the full API reference.
Simplify your customers' onboarding process by opting for the automatic data collection feature. With our external service provider, Business Registry, customers can enter the country and company name, and the remaining business data fields will be automatically filled out.
Automated data collection is an optional step that improves user experience. For more information on this feature and its associated cost, contact your Partner Manager.
The customer enters the company's name and country on your frontend and you pass this information using the following endpoint to automatically fetch the business' registration_issuer and registration_number:
This endpoint might be slow in certain markets.
Request URL:
GET /v1/commercial_registrations/search_by_name?country={{}}&name={{}}Example response
[
{
"name": "EWIV für Unternehmensberatung",
"registration_number": "HRA 201632",
"registration_issuer": "AMTSGERICHT Lüneburg"
}
]Click here to view the full API reference.
If the previous endpoint cannot retrieve the registration number, you must allow the user to enter it manually.
Use the following endpoint to automatically retrieve the remaining business details after obtaining the registration_issuer and registration_number from the response of the previous endpoint:
- Cost: This endpoint has an associated cost per request. Contact your Partner Manager for more information.
- Prefix (Germany): For companies in Germany, you must add
AMTSGERICHTbefore the value of theregistration_issuer(e.g.,AMTSGERICHT MÜNCHEN). - Registration Number: You must enter the complete registration number, including the letters at the beginning (e.g.,
HRB 12345). Inputting12345alone will not work. - Registration Issuer: For the
registration_issuer, we expect one of the Business Registry offices from the list available in Appendix V. We cannot accept free input as it breaks automation.
Request URL:
GET /v1/commercial_registrations/find?registration_number={{}}®istration_issuer={{}}Example response
{
"name": "FLOOR 13 GmbH",
"address": {
"country": "DE",
"postal_code": "86919",
"city": "Utting a.Ammersee",
"line_1": "Seestraße 9",
"line_2": ""
},
"legal_form": "GMBH",
"tax_country": "DE",
"registration_number": "HRB 198673",
"registration_issuer": "AMTSGERICHT MÜNCHEN",
"registration_date": "2012-05-09",
"registry_updated_at": "2015-11-17",
"legal_representatives": [
{
"first_name": "Stefan",
"last_name": "Schneider"
}
],
"commercial_registry_industry_key": [
"66.19.0 - Sonstige mit Finanzdienstleistungen verbundene Tätigkeiten",
"70.10.9 - Sonstige Verwaltung und Führung von Unternehmen und Betrieben",
"70.22.0 - Unternehmensberatung",
"73.11.0 - Werbeagenturen"
]
}Click here to view the full API reference.
If the company is not registered in Germany, you can still use this service for companies in other countries. The following examples describe how to find the business registration details for a French company.
The field registration_issuer is only required for companies in Germany.
GET Search for business commercial registration (France)
Request URL
GET v1/commercial_registrations/search_by_name?name=PARISOL&country=FRResponse
{
"name": "PARISOL",
"registration_number": "513 937359",
"registration_issuer": null
}GET Automatic business data collection (France)
Request URL
GET /v1/commercial_registrations/find?registration_number=513937359&country=FRResponse
{
"name": "PARISOL",
"address": {
"country": "FR",
"postal_code": null,
"city": "NANTERRE",
"line_1": "RUE D ARRAS 18",
"line_2": ""
},
"legal_form": null,
"tax_country": "FR",
"registration_number": "513 937359",
"registration_issuer": null,
"registration_date": "2009-07-27",
"registry_updated_at": null,
"legal_representatives": [
{
"first_name": "Stefan",
"last_name": "Schneider"
}
]
}Check the appendix for testing data for these endpoints.
Create document resources and attach them to the business to verify its identity. These documents are mandatory and vary based on legal form and sector. Refer to the appendix for a list of required documents.
You must make a separate API request for each document and specify the document_type. See the appendix for a list of possible values.
For a complete list of endpoints, properties, and examples related to the business document resource, visit the following links:
This endpoint uploads a document and links it to the business with the business_id specified in the request URL.
Add the following properties to the request body:
document_type: The document type. For a list of possible values, see the API reference.file: The file to be uploaded.
The request body of this endpoint is a multipart/form-data content type. Parameters are transmitted as form-data, not as a raw JSON string.
Request URL
POST /v1/businesses/{business_id}/documentsClick here to view the full API reference
Once the business resource is created, you must create the associated natural persons and assign them roles.
In this step, collect the mandatory data points from the business' legal representative(s) and create a person object for each representative. Then, create a legal_representative resource and link it to the corresponding person object.
Legal representatives can be natural persons (individuals) or legal entities (businesses) appointed by a company to act on its behalf. The legal representative(s) of a company may be, for instance, its general manager(s) or its managing director(s). The names of a business' legal representatives are usually recorded in the company's commercial register.
- A business must have at least one legal representative.
- If a business has more than one legal representative, you must create and link all of them to the
businessobject in the Solaris system to prevent delays during the business identification process.
A business' legal representative can be a legal entity instead of a natural person. For example, the legal representative of a GbR company could be another GmbH or AG company.
In this case, you must do the following:
- Collect the business data of the legal entity acting as the legal representative and create a business resource for it.
- The natural persons who are the legal representatives of that legal entity are the ones who must go through the KYC flow.
Collect the mandatory information for each legal representative and create a person resource.
API reference
For a complete list of endpoints, properties, and examples related to the person resource, visit the following links:
Related webhook events
- Review the special requirements in the Onboarding requirements guide.
- Submit information exactly as it appears in official documents.
- Sandbox Testing: Ensure that each person you create has unique values for
first_name,last_name,birth_city, andbirth_date. If you create over 1000 identical person resources, the API will return a400error. - Privacy: Do not use real personal data when testing in Sandbox.
The mandatory data points for legal representatives depend on the country in which you're opening the account. The following example shows the mandatory data points for Germany. For other countries, check the Onboarding requirements guide
You have to create a separate
personobject for each legal representative associated with the business.
Call this endpoint to create a person resource for the business' legal representative. You must collect the following mandatory data points in your sign-up flow and pass it to Solaris in the request body of this endpoint:
salutationfirst_namelast_nameaddressline_1line_2postal_codecitystatecountry
birth_datebirth_citybirth_countrynationalitymobile_numberterms_and_conditions_signed_atdata_terms_signed_atfatca_relevantfatca_crs_confirmed_at
Request URL:
POST /v1/personsClick here to view the full API reference
For each person resource created, create a legal_representative resource linking the person_id.
Solaris only supports legal representatives with the type_of_representation set to ALONE.
For a complete list of endpoints, properties, and examples related to the legal_representative resource, visit the following links:
Related webhook events
Call this method to create a legal_representative resource on the business and link a person to the business as a legal representative.
Attributes
type_of_representation: Alegal_representativecould have atype_of_representation, which indicates whether this legal representative can make decisions alone or jointly with other legal representatives. This attribute is optional. Possible values areALONE,JOINT, orOTHER.power_of_attorney_confirmed_at: In case ofJOINTrepresentation, legal representatives need to confirm the power of attorney's timestamp in thepower_of_attorney_confirmed_atattribute.
Request URL:
POST /v1/businesses/{business_id}/legal_representativesClick here to view the full API reference.
Check the FAQ for more information about legal representatives.
In this step:
- Collect the mandatory data points from the business' beneficial owner(s) and create a
personobject for each beneficial owner. - Create a
beneficial_ownerresource and assign it to its correspondingpersonobject. - Display the definition of the beneficial owner in your UI.
- If a business has more than one beneficial owner, you must create and link all of them to the corresponding
businessobject to avoid delays during the business identification process. - A beneficial owner MUST be a natural person and CANNOT be another company.
The Beneficial Owners (BO) are natural persons who, directly or indirectly, own more than 25% of a company's shares.
According to the German Money Laundering Act (Geldwäschegesetz - GwG), a Beneficial Owner is a natural person who:
- Ultimately owns or controls the business.
- On whose behalf a transaction is ultimately carried out.
- On whose behalf a business relationship is ultimately established.
- The beneficial owner must be a natural person (individual) and not a legal entity (company). If your business is owned by another company (holding or corporate structure), you need to follow the trail of indirect ownership until you find an individual.
- After a thorough investigation, if no individual owns directly or indirectly more than 25% of the company's voting shares, you must add the legal representative(s) as
fictitiousbeneficial owners. - Beneficial owners don't require video identification.
- For more information about beneficial owners, check the FAQ in the appendices section.
Ensure that the beneficial owner's full definitions and the checkbox are available to your customers in your sign-up flow.
Full definition in English
The ultimate beneficial owner in the sense of the German Money Laundering Act (Geldwäschegesetz - GwG) is the natural person who ultimately owns or controls the contracting party, or on whose behalf a transaction is ultimately carried out or a business relationship is ultimately established. This particularly includes:
- In case of legal persons, foundations without legal capacity and, in the case of other companies, any natural person who directly or indirectly holds more than a 25% share of the capital, controls more than 25% of the voting rights or exercises control in any comparable manner (+). Establishing the identity of the beneficial owner can be waived, though, for companies that are listed in an organised market in the EU with in accordance with Sec on 2 para. 5 of the Securities Trading Act or, in case of listed companies from a third country, if they are subject to EU-equivalent transparency requirements regarding voting rights or equivalent international standards;
- In case of foundations or other legal arrangements with legal capacity (or similar) used to manage or distribute assets or property as trustee (trust management), or through which third parties are instructed with the management or distribution of assets or property, the ultimate beneficial owner is:
- any natural person who is a trustor/settlor, trustee or protector, if applicable
- any natural person who is a member of the board of the foundation,
- any natural person designated as a beneficiary,
- the group of natural persons in whose favour the assets are mainly to be administered or distributed, provided that the natural person who is to be the ultimate beneficial owner of the assets or property has not yet been determined
- any natural person who, by any other means, directly or indirectly exercises control over the asset management or property or the distribution of income.
- In the event of acting on behalf of another party, the ultimate beneficial owner includes the party upon whose initiative the transaction is performed. If the contracting party acts as a trustee, he also acts on behalf of another party. (+) Indirect control exists particularly if corresponding shares are held by one or more associations pursuant to Sec on 20 para. 1 GwG which are controlled by a natural person. Control exists particularly if the natural person can directly or indirectly exert a controlling influence on the association pursuant to Sec on 20 para. 1 GwG. Sec on 290 para. 2 to 4 German Commercial Code (Handelsgesetzbuch - HGB) applies mutatis mutandis to the existence of a controlling influence. If, after extensive audits have been performed and without the facts according to Sec on 43 para. 1 GwG applying, no natural person has been identified or if there is any doubt that the identified person is the ultimate beneficial owner, the ultimate beneficial owner shall be the legal representative, managing partner or partner of the contracting party.
Full definition in German
Wirtschaftlich Berechtigter im Sinne des Geldwäschegesetzes, ist die natürliche Person, in deren Eigentum oder unter deren Kontrolle der Vertragspartner letztlich steht, oder auf deren Veranlassung eine Transaktion letztlich durchgeführt oder eine Geschäftsbeziehung letztlich begründet wird. Hierzu zählen insbesondere:
- Bei juristischen Personen, außerrechtsfähigen Stiftungen und bei sonstigen Gesellschaften jede natürliche Person, welche unmittelbar oder mittelbar mehr als 25 Prozent der Kapitalanteile hält, mehr als 25 Prozent der Stimmrechte kontrolliert oder auf vergleichbare Weise Kontrolle ausübt(2). Auf die Abklärung des wirtschaftlich Berechtigten kann aber verzichtet werden bei Gesellschaften, die innerhalb der EU an einem organisierten Markt im Sinne des § 2 Abs. 5 des Wertpapierhandelsgesetzes notiert sind, oder bei börsennotierten Unternehmen aus einem Drittstaat, wenn sie dem Gemeinschaftsrecht entsprechenden Transparenzanforderungen im Hinblick auf Stimmrechtsanteile oder gleichwertigen internationalen Standards unterliegen;
- Bei rechtsfähigen Stiftungen und Rechtsgestaltungen, mit denen treuhänderisch Vermögen verwaltet oder verteilt oder die Verwaltung oder Verteilung durch Dritte beauftragt wird, oder diesen vergleichbaren Rechtsformen zählt zu den wirtschaftlich Berechtigten:
- jede natürliche Person, die als Treugeber, Verwalter von Trusts (Trustee) oder Protektor, sofern vorhanden,
- jede natürliche Person, die Mitglied des Vorstands der Stiftung ist,
- jede natürliche Person, die als Begünstigte bestimmt worden ist,
- die Gruppe von natürlichen Personen, zu deren Gunsten das Vermögen hauptsächlich verwaltet oder verteilt werden soll, sofern die natürliche Person, die Begünstigte des verwalteten Vermögens werden soll, noch nicht bestimmt ist,
- jede natürliche Person, die auf sonstige Weise unmittelbar oder mittelbar beherrschenden Einfluss auf die Vermögensverwaltung oder Ertragsverteilung ausübt.
- Bei Handeln auf Veranlassung zählt zu den wirtschaftlich Berechtigten derjenige, auf dessen Veranlassung die Transaktion durchgeführt wird. Soweit der Vertragspartner als Treuhänder handelt, handelt er ebenfalls auf Veranlassung.
Collect the mandatory information for each beneficial owner and create a person resource.
The mandatory data points for beneficial owners depend on the country in which you're opening the account. The following example shows the mandatory data points for Germany. For other countries, check the Onboarding requirements guide
You have to create a separate
personobject for each beneficial owner associated with the business.
Call this endpoint to create a person resource for the business' beneficial owner. You must collect the following mandatory data points in your sign-up flow and pass it to Solaris in the request body of this endpoint:
salutationfirst_namelast_nameaddressline_1line_2postal_codecitystatecountry
birth_datenationalityfatca_relevantfatca_crs_confirmed_at
Request URL:
POST /v1/personsClick here to view the full API reference
For each person resource created, create a beneficial_owner resource linking the person_id.
For a complete list of endpoints, properties, and examples related to the beneficial_owner resource, visit the following links:
Related webhook events
Call this method to create a beneficial_owner resource on the business and link a person to the business as a beneficial owner. You must add the following properties in the request body of this endpoint:
person_id: The ID of the person resource you created for the beneficial owner.voting_share: The beneficial owner's voting share in the business.
Please note is that if you're creating a fictitious beneficial owner, the voting_share is not required.
Request URL:
POST /v1/businesses/{business_id}/beneficial_ownersClick here to view the full API reference.
Check the FAQ for more information about beneficial owners.
Collect relevant tax information and create tax identification resources for:
- The business legal entity.
- All natural persons associated with the business.
Submitting the tax information of your customers is a requirement to open a bank account in all of Solaris branches. However, please note the following:
You can open the bank account for customers in Germany (DE branch) before they provide tax information. However, you must submit the customer's tax information to Solaris within 90 days of opening the account. Otherwise, Solaris will block the customer's account with the reason
MISSING_TAX_INFORMATIONuntil you submit the required tax information.If a customer has multiple tax residencies (i.e., taxable in multiple countries), you must create a separate tax identification resource for each tax residency and specify only one of them as
primary.The first
tax_identificationto be submitted for apersonor abusinessmust be the primary tax identification. If anothertax_identificationwith the value ofprimaryset totrueis created, it will set theprimaryvalue of the previously createdtax_identificationtofalse.A
personorbusinessmay only have onetax_identificationpercountry.When creating a
tax_identification, explicitly collect thecountryvalue from the user and do not default to their physical residence (i.e., thecountryproperty of thepersonresource).Check the Onboarding requirements guide for more information about the TIN requirements per country.
Collect tax information for the business entity and create a business tax identification resource.
For a complete list of endpoints, properties, and examples related to the business tax identification resource, visit the following links:
Related webhook events
Call this endpoint to create a business tax identification for the business with the business_id specified in the request URL. Collect the following tax information from the business and pass them to Solaris in the request body:
numbercountryprimary
If the business has not submitted their TIN to your solution yet (i.e., the value of number is null), then include the following properties in the request:
reason_no_tin: Possible values areNOT_ASSIGNED_YET,NOT_ASSIGNED_BY_COUNTRY,OTHER.reason_description: Applies only if thereason_no_tinisOTHER.tax_id_type: (Only for Spain) Possible values areNIEandNIF.
Request URL
POST /v1/businesses/{business_id}/tax_identificationsClick here to view the full API reference.
Ensure your UI meets the requirements for collecting tax information as detailed in the Legal and compliance screens guide.
Collect tax information from all natural persons linked to the business and create a person tax identification for each.
This is mandatory for all branches. You must create a person tax identification for all legal representatives, beneficial owners, and authorized persons.
For a complete list of endpoints, properties, and examples related to the person tax identification resource, visit the following links:
Related webhook events
Call this endpoint to create a person tax identification for the customer with the person_id specified in the request URL. Collect the following tax information from your customers and pass them to Solaris in the request body:
numbercountryprimary
If the customer has not submitted their TIN to your solution yet (i.e., the value of number is null), then include the following properties in the request:
reason_no_tin: Possible values areNOT_ASSIGNED_YET,NOT_ASSIGNED_BY_COUNTRY,OTHER.reason_description: Applies only if thereason_no_tinisOTHER.tax_id_type: (Only for Spain) Possible values areNIEandNIF.
Request example:
POST /v1/persons/{person_id}/tax_identificationsClick here to view the full API reference.
You can use the following test values for the TIN to test these endpoints on Sandbox:
| Country | TIN testing values |
|---|---|
| DE | 48954371207 |
| FR | 3023217600053 |
| IT | SSSNNN31B28X000C |
| ES | Test data can be generated from this website |
Before starting identification, your solution must display the Solaris compliance disclaimer and collect the customer's agreement.
Refer to the UI requirements and legal text in the Legal and compliance screens guide.
In this phase, you must:
- Trigger Identification: Start the business identification process and ensure all legal representatives complete video identification via IDnow.
- Manual Video ID: Implement manual video identification endpoints.
- Compliance Questions: Implement compliance questions endpoints and forward any questions to the legal representatives.
- Due Diligence: Ensure all natural persons pass customer due diligence (CDD) checks.
- FATCA: Complete FATCA-related checks.
Solaris' BKYC solution uses RESTful APIs to perform a series of identification and compliance checks for business customers.
The business identification consists of two asynchronous processes:
- Legal identification: The Solaris Banking Operations team verifies the completeness and accuracy of the data submitted by the business customer. They ensure that all legal representatives and ultimate beneficial owners are disclosed and linked to the business.
- Video identification: All of the business' legal representatives and authorized persons must undergo a video identification session with IDnow to validate their data against their identification documents.
- The business must pass both of these checks before the business identification process is successful.
- Only legal representatives and authorized persons must undergo video identification. Ultimate beneficial owners (UBOs) are exempt from this requirement.
API reference
For a complete list of endpoints, properties, and examples related to business identification (BKYC), visit the following links:
Related webhook events
Call this endpoint to initiate the business identification process, which automatically triggers both the legal identification of the business and the video identification of applicable natural person(s). Specify the identification method in the request body. The default method is idnow.
Request URL
POST /v1/businesses/{business_id}/identificationsResponse
Returns an identification object with a unique id representing the business identification resource and its overall status. Additionally, the payload contains individual identification objects for the video identification sessions of legal representatives, including their respective resource id, IDnow status, reference, and url for completing the process.
The payload also provides information on the legal identification process, including its dedicated legal_identification_status. Monitor the progress of this process by calling the API, particularly the legal_identification_missing_information field, where Solaris highlights compliance questions requiring answers from the business.
Click here to view the full API reference
While the initial business identification process automatically triggers video identification for the known legal representatives, you may need to initiate this process manually. This occurs if new legal representatives are discovered during the legal review or if an initial identification attempt fails.
Trigger video identification manually in the following cases:
- New legal representatives: If the legal review uncovers new representatives, you will receive a
LEGAL_REPRESENTATIVEwebhook event containing the newlegal_representative_id. You must then initiate a video identification with IDnow and redirect the person to the provided URL. - Failed attempts: If a video identification fails, you must manually trigger a new identification session.
API reference
- This guide focuses on video identification with IDnow.
- Ensure you have completed the IDnow technical prerequisites (e.g., mobile SDKs or web redirects).
Related webhook events
Call this endpoint to initialize the identification process. You must specify the method (idnow) and the customer's preferred language.
Required fields:
method: Set toidnow.language:ENorDE.proof_of_address_type: Required if the ID document does not show the address (e.g., Passport).proof_of_address_issued_at: Required if providing a proof of address (must be < 6 months old).
Creating the resource does not start the video call. You must trigger it in the next step.
Request example
// POST /v1/persons/{person_id}/identifications
{
"method": "idnow",
"language": "DE",
"proof_of_address_type": "GAS_BILL",
"proof_of_address_issued_at": "2022-09-21"
}Response example
Returns an identification object with status created.
{
"id": "6dc54352d6793a892e0702850d07b831cidt",
"status": "created",
"method": "idnow",
...
}Click here to view the full API reference.
The method idnow_custom allows for a customized IDnow flow. If you are interested in offering this to your customers, contact your Partner Manager.
Before redirecting the customer, check which documents are supported for their country. This avoids user frustration if they attempt to use an unsupported ID.
Request URL
GET /v1/persons/{person_id}/identifications/{id}/supported_documentsClick here to view the full API reference
Call this endpoint to generate the required tokens and URLs for the IDnow session.
Request URL
PATCH /v1/persons/{person_id}/identifications/{id}/requestResponse example
The status changes to pending. The response contains two critical fields depending on your integration type:
url: Use this for Web integrations (redirect the user here). Valid for 14 days.reference: Use this token for Mobile SDK (iOS/Android) integrations.
{
"id": "6dc54352d6793a892e0702850d07b831cidt",
"reference": "TST-KCCEY",
"url": "[https://go.test.idnow.de/solarisbankvideoidentsandbox/identifications/](https://go.test.idnow.de/solarisbankvideoidentsandbox/identifications/)...",
"status": "pending",
...
}Click here to view the full API reference.
Once you redirect the customer (Web) or initialize the SDK (Mobile), the IDnow session begins.
- Consent & Setup: The customer lands on an IDnow-branded page. They must consent to Terms & Conditions and confirm they have a valid ID document ready.
- Mobile Verification: The customer provides a mobile number. The IDnow agent sends an SMS OTP to this number during the call to verify possession.
- Video Call: The agent connects via video to verify the customer's face and ID document live.
- Data Update: If the agent detects missing or incorrect data (e.g., name spelling), they will update the record directly. These changes are automatically reflected in the
personresource.
Once the webhook IDENTIFICATION signals success, retrieve the final data.
Use the ?include_documents=true query parameter to download the images of the ID document and the user's face.
Request URL
GET /v1/persons/{person_id}/identifications/{id}Click here to view the full API reference.
- List IDnow attempts (Audit log of failed/aborted calls)
- Upload additional documents
During the legal identification process, Solaris' legal and compliance team may require additional information from your customers, including answers to certain compliance questions and/or additional documents.
- If Solaris needs further clarification during the business identification, you will receive a notification on the
BUSINESS_IDENTIFICATIONwebhook. - Call the GET Retrieve a business identification endpoint to retrieve the required details.
Only compliance questions
If Solaris has compliance questions for the business, the field legal_identification_missing_information contains only COMPLIANCE_QUESTIONS. In this case, collect answers from the customer on your frontend. We recommend setting document upload as optional to allow the customer to add supporting documents if needed.
Example payload
{
"legal_identification_status": "information_required",
"legal_identification_missing_information": [
"COMPLIANCE_QUESTIONS"
]
}Both compliance questions & documents
If Solaris requires both answers to compliance questions and documents, the field legal_identification_missing_information contains COMPLIANCE_QUESTIONS and a document_type (e.g., FOUNDATION_DOCUMENT). In this case, collect the answers and the mandatory documents. You must set document upload as mandatory on your frontend and submit the document to Solaris using the POST Create a Business Document endpoint.
Example payload
{
"legal_identification_status": "information_required",
"legal_identification_missing_information": [
"COMPLIANCE_QUESTIONS",
"FOUNDATION_DOCUMENT"
]
}If the status indicates missing information, follow this flow to resolve it:
To retrieve the questions and submit answers, use the following endpoints:
To get the compliance questions, call the following endpoint:
Request URL
GET /v1/businesses/{business_id}/identifications/{business_identification_id}/legal_identification/questionsResponse example
The API call returns an object that includes the question(s) with a unique ID and the corresponding text. You must redirect these questions to your customers and retrieve their answers as part of your workflow. Provide a dedicated page for answering all questions separately.
{
"question_id": "ebb463137becc09788dfe21fc066e670qstn",
"question_text": "Please provide the license for security / guarding services (Bewachungsgewerbe): § 34a GewO",
"legal_identification_id": "14eb210435e09ab7f6a06c8b9b86ce27lid",
"business_identification_id": "4c74c804eaea5d2a2d64ef400a27a4d3bid",
"business_id": "880bbac68a34add190786b9c74f4c82fcbiz",
"answer_id": null,
"answer_text": "string",
"asked_at": "2021-07-16T13:38:06.000Z",
"answered_at": null
}Click here to view the full API reference.
After receiving the compliance question answers from the customer, call the following endpoint to share them with Solaris. Make a separate API call for each answer.
Request URL
Provide the answer in the request body.
POST /v1/businesses/{business_id}/identifications/{business_identification_id}/legal_identification/questions/{question_id}/answersClick here to view the full API reference.
Call this method to update the legal identification and mark it as ready to resume the identification process after adding all answers and documents. This endpoint changes the legal_identification_status from information_required to pending.
Request URL
PATCH /v1/businesses/{business_id}/identifications/{id}/legal_identification/mark_as_readyClick here to view the full API reference.
Solaris conducts risk screening (Customer Due Diligence) on the business, legal representatives, beneficial owners, and authorized persons. Results are returned in the GET person or GET business resources.
All entities must have a green status to proceed. For details, see the Customer Due Diligence guide.
To comply with the Foreign Account Tax Compliance Act (FATCA), Solaris is required to perform checks to determine whether the customer is subject to US tax law. These checks are in addition to the self-declaration during the Legal and Compliance screen.
To perform the FATCA checks, parse the person and identification resources using the following endpoints:
To determine the customer's FATCA relevance, you must screen for the following hard criteria:
- Has the customer provided a US passport as their identification document? Check the
legitimation_countryattribute on the identification resource. - Is the customer a citizen of the US? Check the
nationalityattribute. - Has the customer provided a residential address in the US, the US Minor Outlying Islands, or the US Virgin Islands? Check the
countryattribute. - Was the customer born in the US, the US Minor Outlying Islands, or the US Virgin Islands? Check the
birth_countryattribute.
When to reject the customer
If any of these hard criteria attributes have the value of US or USA, you must deny banking services to the customer and stop the onboarding process. Failure to screen for these hard FATCA criteria may cause ongoing operational burdens for Solaris customer support.
To further determine the customer's FATCA relevance, screen for the following soft criteria:
- Has the customer provided a US mobile number? Check the
mobile_numberattribute. US mobile numbers have a country code of +1. - Is the customer's only address a PO box or a c/o address? Check the
address_line_1andaddress_line_2attributes.
When to reject the customer
- If the answer is "Yes" to any of the soft criteria, ask the customer to clarify their phone number and/or address.
- If the customer provides a non-US phone number and a physical address, you may onboard them.
- If the customer does not provide a non-US phone number and a physical address, you may not onboard them.
Failure to screen for soft FATCA criteria may cause ongoing operational burdens for Solaris customer support.
Note that Solaris periodically checks FATCA relevance for existing customers. If a customer's FATCA relevance changes to true, Solaris's Customer Support team will provide further instructions.
There are three key statuses in the business identification process:
- Solarisident status: Tracks the overall legal and video identification. Initially
created, becomessuccessfulupon completion. - Legal identification status: Tracks the verification of the legal entity. Initially
created. - Video identification status: A unique object for each person. The IDnow status remains
pendinguntil the person completes video identification.
See the appendices for status values.
To comply with regulatory requirements, Solaris must keep copies of valid identification documents for active customers in its Italy and Spain branches. This requirement applies to the following customer segments:
- Retail customers
- Freelancers & Sole proprietors
- Businesses' legal representatives
- Authorized persons on a business or a retail account
How will you be notified of the expiry of ID documents?
In Italy and Spain, Solaris stores the expiry date of a customer's identification document and calculates a follow-up date to notify you before it expires. You'll receive a webhook notification on the event POTENTIAL_ACCOUNT_BLOCKING 30 days before the expiry date, and then every 30 days until 90 days after the expiry.
The webhook payload includes the blocking_date, which is the date by which the account will be blocked if the customer has not identified again with a valid ID document, and the reason for the account blocking is set to IDENTIFICATION_DOCUMENT_EXPIRED.
What should you do?
After receiving a notification on the POTENTIAL_ACCOUNT_BLOCKING webhook event, you should take the following steps:
- Create a new identification resource for the customer and specify the identification
methodusing the POST Create an identification. - Request the identification for the customer by calling PATCH Request an identification.
- Notify the customer that they must complete the KYC flow with their new valid ID document.
- After successful KYC, Solaris will store the expiry date of the new ID document and calculates a new follow-up date.
If the customer did not identify with a valid ID document within 90 days after the expiry date, the customer's account will be blocked with the reason IDENTIFICATION_DOCUMENT_EXPIRED. If a new ID document is submitted, the account will be unblocked.
Which KYC method to use?
For the re-identification due to expired ID documents, you can choose between the following methods:
- Fourthline
- IDnow AutoIdent
Proceed to the next steps only when:
- The identification status is
successful. - All CDD checks have a
greenstatus. - FATCA screening confirms the customer is not liable for US taxes.
You have successfully completed the business identification process. You can now open a business account for the customer.
Present the customer with a button to open their account using the specific formulations below:
English
Order / Open account (subject to a charge)
German
Bestellen / Konto eröffnen (zahlungspflichtig)
(Consult your Onboarding Project Manager if you wish to use different text.)
An authorized person is a natural person who can act on the account and receive authorization challenges (2FA).
- Legal representatives are authorized by default but must be explicitly added as an
authorized_personin the system. - Other persons can be authorized by a legal representative (see Step 10).
Legal representatives can be added as authorized_person without extra authorization. Adding other persons requires approval via 2FA.
Request example:
Add the person_id of the legal representative.
// POST /v1/businesses/{business_id}/accounts/{account_id}/authorized_persons
{
"authorized_person_id": "3b8cfd40fb4dce5a231251ea06a014cper"
}Example response:
{
"id": "568b5241afd0ce435c56ea0efef2bd0dcpea",
"authorized_person_id": "3b8cfd40fb4dce5a231251ea06a014cper"
}Once onboarded, you can create a card for the customer. See the Cards Creation and Servicing guide for instructions.
The business card holder is the business' legal representative.
You can add optional roles based on your use case:
- Additional Authorized Person: A person who is not a legal representative but can act on the account.
- Signee: A person with specific rights (view info, sign documents) but not full authorization power.
In this step, you can add other persons who are not legal representatives as authorized_person on the business account.
This action is sensitive and triggers a Change Request. The Legal Representative must approve this action using 2FA (SMS or Device Signing).
- See The Change Request Process for the full authorization flow.
- You must create the
personresource first. - The person must be video identified (see Manual video identification).
Request URL:
POST /v1/businesses/{business_id}/accounts/{account_id}/authorized_personsResponse example:
Returns a URL to authorize the action.
{
"id": "d6c778822b2d7bd3b778935bcfd0d1d3csc",
"status": "AUTHORIZATION_REQUIRED",
"updated_at": "2017-07-15T14:04:35.000Z",
"url": ":env/v1/change_requests/:id/authorize"
}Call the url from the previous response. Specify the person_id of the legal representative authorizing the request.
// POST /v1/change_requests/{change_request_id}/authorize
{
"person_id":"5af2ea4271038d5c53e68ccbf4fe43b3cper",
"delivery_method": "mobile_number"
}This sends a 6-digit OTP to the legal representative's verified mobile number.
Confirm the request with the OTP (tan).
// POST /v1/change_requests/{change_request_id}/confirm
{
"person_id":"5af2ea4271038d5c53e68ccbf4fe43b3cper",
"tan": "123456"
}Signees are optional roles added after successful business identification.
Assign the signee role to a person linked to the business.
You must create the person resource first.
Request URL:
POST /v1/businesses/{business_id}/signeesClick here to view the full API reference.
Congratulations! You have successfully onboarded a business, identified the legal representatives, and opened an account.
Critical Next Step: Authentication The Legal Representative cannot log in or authorize payments yet. You must now implement the security framework:
- Bind a Device: Prompt the Legal Representative to link their smartphone to the user account.
- Choice: You can implement either the SMS OTP flow or the Activation Code (QR) flow.
- Requirement: This binding is mandatory for Strong Customer Authentication (SCA).
- Implement Login & SCA: Set up the flows for logging in and authorizing transactions using the bound device.
To set the value of annual_income_range, you may offer the customer a drop-down list with the following numeric values for each range:
| Range | Value |
|---|---|
RANGE_1 | < 20000 |
RANGE_2 | 20000 - 40000 |
RANGE_3 | 40000 - 60000 |
RANGE_4 | 60000 - 100000 |
RANGE_5 | 100000 - 200000 |
RANGE_6 | 200000 - 400000 |
RANGE_7 | > 400000 |
The field crs_company_type is required to collect mandatory tax information and create the business tax_identification resource. The following table includes the possible values for this field and their descriptions:
| Enum | Description |
|---|---|
FE_REPORTING | Reporting Financial Institution. |
FE_NON_REPORTING | Non-Reporting Financial Institution. |
NFE_ACTIVE_OTHER | Active NFE (Non-Financial Entity) - A corporation whose shares are regularly traded on at least one recognized stock exchange (or an affiliate), a government entity, an international organization, a central bank, or a legal entity wholly owned by one of these. |
NFE_PASSIVE | Passive NFE - A non-active Non-Financial Entity. |
NFE_PASSIVE_INVESTMENT | Passive NFE (Investment) - An Investment Entity that is a Financial Institution in a jurisdiction not participating in the CRS and is managed by another Financial Institution. |
The following table includes the possible values for the field document_type and their descriptions.
| Enum | Description |
|---|---|
ANNUAL_FINANCIAL_STATEMENT | A business or company's annual financial statement. |
KYC_REPORT | The KYC report generated after successful customer identification. |
ID_DOCUMENT | A person's identification document, such as a passport or ID card. |
SIGNATURE | A signature sample. |
PICTURE | A picture or scanned document of any other type. |
QES_DOCUMENT | A document related to a Qualified Electronic Signature (QES). |
SIGNED_CONTRACT | A signed contract of any kind. |
SIGNED_QES_DOCUMENT | A document signed by a Qualified Electronic Signature (QES). |
REGISTER_APPLICATION | A document proving the application for registration (Gründungsurkunde), used for companies "in formation". |
REGISTER_CHECK | A register check. |
REGISTER_EXTRACT | A commercial register excerpt or similar document. |
FOUNDATION_DOCUMENT | The foundation document of a company or business. |
SCHUFA_COMPACT_REPORT | A compact SCHUFA report. |
SCHUFA_GWG_REPORT | A GWG (Money Laundering Act) SCHUFA report. |
SCHUFA_FULL_REPORT | A full SCHUFA report about a person. |
SCHUFA_SHORT_REPORT | A short SCHUFA report about a person. |
CREDIT_AGENCY_REPORT | A report issued by a credit agency. |
SHARE_HOLDERS_AGREEMENT | A shareholder agreement. |
SHAREHOLDERS_LIST | A list of shareholders. |
TRADING_LICENSE | A trading license. |
TRANSPARENCY_REGISTER_EXTRACT | An extract from the transparency register. |
INVOICE | An invoice of any kind. |
OTHER | Any other type of document. |
VIDEO | A video of any kind. |
VAT_CERTIFICATE | VAT registration certificate. |
The Statistical Classification of Economic Activities in the European Community (NACE) is the industry standard classification system used in the European Union.
NACE uses four hierarchical levels:
- Level 1: 21 sections identified by alphabetical letters A to U.
- Level 2: 88 divisions identified by two-digit numerical codes (01 to 99).
- Level 3: 272 groups identified by three-digit numerical codes (01.1 to 99.0).
- Level 4: 629 classes identified by four-digit numerical codes (01.11 to 99.00).
The first four digits (the first four levels) are consistent across all European countries. National implementations may introduce additional levels. The fifth digit might vary by country, and suppliers of databases sometimes add further digits.
Example
If the NACE code A 01.11 (Growing of cereals (except rice), leguminous crops and oil seeds) applies to the business, supply the value as follows:
nace_code = "A 01.11"
Reference List
Visit the Eurostat Reference Data site for the full list of NACE code values required for your implementation. The list is available in multiple languages.
Requirements
- Mandatory: NACE codes are required for B2B and freelancer customers in Germany, Italy, and Spain.
- Excluded: For France, NACE codes are not used. The CODE NAF system is used instead.
Using NACE codes replaces the fields industry and industry_key.
The following table includes the possible values for the field tax_country.
| Enum | Description |
|---|---|
AT | Austria |
BE | Belgium |
CZ | Czech Republic |
DE | Germany |
ES | Spain |
FR | France |
GB | United Kingdom |
IT | Italy |
LU | Luxembourg |
NL | The Netherlands |
PT | Portugal |
The following table includes the possible values for the field sector.
| Enum |
|---|
ECONOMICALLY_SELF_EMPLOYED |
ECONOMIC_DEPENDENT |
FOREIGN_COMPANIES |
FOREIGN_ECONOMIC_DEPENDENT |
FOREIGN_PRIVATE_INDIVIDUAL |
FOREIGN_SELF_EMPLOYED_PRIVATE_PERSON |
GERMAN_BANKS |
MUNICIPALITY_AND_MUNICIPALITY_ASSOCIATION |
OTHER_COMPANIES |
OTHER_COMPANIES_WORKMAN |
OTHER_PRIVATE_INDIVIDUAL |
The selected value for the field tax_country influences the accepted values for the field legal_form. The following lists show the possible values for legal_form for each tax_country.
Austria (AT)
AT_SEAT_OHGAT_KGAT_AGAT_GESMBHAT_EGAT_GBRAT_EVAT_SOLE_PROPRIETORSHIPAT_SELF_EMPLOYEDAT_AMTAT_KORAT_STIFTUNGENAT_GMBHAT_GMBH_CO_KG
Belgium (BE)
BE_SNCBE_SCSBE_SABE_SPRLBE_SEBE_SCABE_SCBE_SCRIBE_SEPBE_SFBE_SPRLUBE_SOLE_PROPRIETORSHIPBE_SELF_EMPLOYED
Bulgaria (BG)
BG_ADBG_OODBG_KDABG_KDBG_SDBG_SELF_EMPLOYEDBG_SOLE_PROPRIETORSHIP
Croatia (HR)
HR_DDHR_DOOHR_JDOOHR_KDHR_JTDHR_SELF_EMPLOYEDHR_SOLE_PROPRIETORSHIPHR_ORTA
Czech Republic (CZ)
CZ_ASCZ_SROCZ_KSCZ_VOSCZ_DRUZSTVOCZ_FYZICKA_OSOBACZ_SOLE_PROPRIETORSHIPCZ_SELF_EMPLOYED
France (FR)
FR_AEFR_EIFR_SNCFR_SCSFR_SAFR_SASFR_SARLFR_SEFR_SCAFR_EURLFR_SCFR_SCOPFR_SELARLFR_SOLE_PROPRIETORSHIPFR_SELF_EMPLOYED
Germany & Others (Default) Solaris accepts the following legal forms for companies in Germany and other countries not specified in this list:
AGEGEKEVNEVGBRGMBHGMBH_CO_KGGMBH_I_GRKGKGAALTDMUNICIPALITYMUNICIPAL_COMPANYNONEOHGPARTGPRIVATE_PERSONSAVINGS_BANKSESELF_EMPLOYEDSOLE_PROPRIETORSHIPUGUG_I_GRFOREIGN_CORPORATIONADORAMTKDORSTIFTUNGENSECOKGAGCOKG
Hungary (HU)
HU_NYRTHU_KFTHU_BTHU_KKTHU_SOLE_PROPRIETORSHIPHU_SELF_EMPLOYEDHU_ORTA
Italy (IT)
IT_SEIT_SNCIT_SASIT_SPAIT_SRLIT_SAPAIT_SCPAIT_SCARLIT_SCOPIT_SSIT_SOLE_PROPRIETORSHIPIT_SELF_EMPLOYED
Luxembourg (LU)
LU_SNCLU_SCSLU_SALU_SARLLU_SELU_SCALU_SCSPLU_SARLSLU_SCLU_SCOPLU_SOLE_PROPRIETORSHIPLU_SELF_EMPLOYEDLU_SECALU_ASBLLU_FONLU_SP
Poland (PL)
PL_SAPL_SPZOOPL_SEPL_SKAPL_SPKPL_SPJPL_SELF_EMPLOYEDPL_OTHER
Portugal (PT)
PT_SNCPT_SCPT_SAPT_LDAPT_SEPT_SUNIPT_EIRLPT_SCIVPT_COPPT_SOLE_PROPRIETORSHIPPT_SELF_EMPLOYED
Romania (RO)
RO_SARO_SRLRO_SCARO_SCSRO_SNCRO_SELF_EMPLOYEDRO_SOLE_PROPRIETORSHIP
Serbia (RS)
RS_ADRS_DOORS_KDRS_ODRS_SELF_EMPLOYEDRS_SOLE_PROPRIETORSHIP
Slovenia (SI)
SI_DDSI_DOOSI_KDDSI_KDSI_DNOSI_SELF_EMPLOYEDSI_SOLE_PROPRIETORSHIP
Spain (ES)
ES_SRCES_SCES_SAES_SASES_SRLES_SEES_SCAES_SLNEES_SAUES_SLUES_SPROES_SCOPES_SOLE_PROPRIETORSHIPES_SELF_EMPLOYED
Switzerland (CH)
CH_DE_AGCH_FR_SACH_IT_SACH_DE_GMBHCH_FR_SARLCH_IT_SAGLCH_SECH_DE_KOMAGCH_FR_SCACH_IT_SACACH_DE_KGCH_FR_SCMCH_IT_SACCH_DE_KIGCH_FR_SNCCH_IT_SNCCH_DE_EGCH_FR_SSCH_IT_SSCH_SELF_EMPLOYEDCH_SOLE_PROPRIETORSHIPCH_DE_KMG
The Netherlands (NL)
NL_VOFNL_CVNL_NVNL_BVNL_SENL_CVOANL_COPVNL_MTSNL_SOLE_PROPRIETORSHIPNL_SELF_EMPLOYEDNL_VERENIGINGNL_STICHT
Turkey (TR)
TR_ADI_SIRTR_ASTR_LSTR_KOM_STITR_KOLL_STITR_SELF_EMPLOYEDTR_SOLE_PROPRIETORSHIP
United Kingdom (GB)
GB_SEGB_PARTNERSHIPGB_LPGB_PLCGB_LTDGB_COPSGB_UASGB_PRCUGB_PUCUGB_SOLE_PROPRIETORSHIPGB_SELF_EMPLOYED
Dependencies exist between the fields tax_country, sector, and legal_form. The value selected for one field determines the accepted values for the next.
The following sections outline these dependencies.
The selected value for the field tax_country influences the accepted values for the field sector. The following table gives an overview about the mapping of values between the field tax_country and sector.
| Tax country | Allowed values for sector |
|---|---|
DE |
|
| All other countries |
|
The selected value for the field sector influences the accepted values for the field legal_form. The following table gives an overview about the mapping of values between the field sector and legal_form.
| Sector | Allowed values for legal form |
|---|---|
OTHER_COMPANIES |
|
OTHER_COMPANIES_WORKMAN |
|
FOREIGN_COMPANIES |
|
GERMAN_BANKS |
|
MUNICIPALITY_AND_MUNICIPALITY_ASSOCIATION |
|
ECONOMICALLY_SELF_EMPLOYED |
|
NON_PROFIT_ORGANIZATION |
|
The following table includes the possible values for the field status for the video identification process carried out by IDnow and the related description of each status.
| Status | Description |
|---|---|
created | The identification resource has been created for the customer. |
pending | The identification process has been triggered, and the video identification URL and reference have been generated. Redirect the customer to the URL to complete the identification. |
pending_failed | The identification is currently under review by the provider. You cannot offer banking services to the customer at this stage. |
successful | The video identification was successful. The customer can be onboarded. Note that the customer's data might have been updated during the identification session. |
aborted | The customer aborted the identification process. They can retry using the same URL. |
canceled | The provider canceled the video identification. The customer should retry using the same URL. |
failed | The identification was unsuccessful. You cannot onboard the customer or offer any banking services to them. |
expired | The identification link has expired (validity period passed). You must create a new identification request. |
IDnow provides a reason whenever the identification has a canceled or aborted status. No reason is disclosed for the final failed status.
The following table includes the possible values for the field legal_identification_status. This status tracks the progress of the legal checks performed by Solaris on the business entity.
| Status | Description |
|---|---|
created | The legal identification has been initiated and will be conducted shortly. |
information_required | Solaris is missing one or more required documents or information. Check the legal_identification_missing_information array to see what is missing. |
pending | The legal review is currently in progress. This status is set after you call the mark_as_ready endpoint. |
blocked_internally | The legal identification is put on hold due to additional internal checks. |
successful | The legal identification was completed successfully. |
failed | The legal identification failed. Check the legal_identification_reason field for details. |
expired | The legal identification was not completed within the required timeframe (90 days). |
The following table includes the possible values for the field status, which refers to the overall status of the business identification process (BKYC). This includes the legal identification of the business entity carried out by Solaris and the video identification of the business's natural persons.
| Status | Description |
|---|---|
created | The business identification resource has been created. The legal review and video identification steps will begin shortly. |
pending | The business identification is currently in progress. This may mean Solaris is reviewing the legal documents or waiting for the legal representatives to complete their video identification. |
successful | Both steps of the business identification process (legal review and video identifications) were completed successfully. |
failed | The business identification process failed and will not continue. To understand why, check the status of the legal_identification or the individual video identifications. |
expired | The business identification process was not completed within the allowed timeframe (usually 6 months). Either the legal identification or one of the video identifications was not finished on time. |
The following table lists the required documents for identification for each legal form.
For all registered legal forms, customers must input their business data (registration_number and registration_issuer).
Once the customer enters this data, Solaris automatically retrieves the required company documents, eliminating the need to request them during the onboarding flow.
Inaccurate data (registration_number and registration_issuer) causes automated retrieval to fail. In this case, you must request documents manually from the customer using the request information and request document endpoints.
Solaris may request further documents during the onboarding process depending on factors such as legal entities acting as beneficial owners, complex business structures, or specific service types.
| Legal Form | Documents required | Document Type | Data can be retrieved by Solaris |
|---|---|---|---|
| ADÖR | Register extract | REGISTER_EXTRACT | Yes - Automated |
| ADÖR | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| AG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| AG | "Aktionärsliste" for AG or AG/SE as General Partner | SHAREHOLDER_LIST | No |
| AG | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| AG_CO_KG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| AG_CO_KG | "Aktionärsliste" for AG or AG/SE as General Partner | SHAREHOLDER_LIST | No |
| AG_CO_KG | Articles of Association (Satzung) for AG/SE as General Partner | FOUNDATION_DOCUMENT | No |
| EG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| EG | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| EK | Register extract | REGISTER_EXTRACT | Yes - Automated |
| GbR | Gesellschaftsvertrag (partnership/shareholder agreement) | OTHER or SHAREHOLDER_AGREEMENT | No |
| eGbR | Register extract | REGISTER_EXTRACT | Yes - Automated |
| eGbR | Gesellschaftsvertrag (partnership/shareholder agreement) | OTHER or SHAREHOLDER_AGREEMENT | No |
| Gemeinde | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| gGmbH | Register extract | REGISTER_EXTRACT | Yes - Automated |
| gGmbH | List of Shareholders | SHAREHOLDER_LIST | Yes - Automated |
| GMBH | Register extract | REGISTER_EXTRACT | Yes - Automated |
| GMBH | List of Shareholders | SHAREHOLDER_LIST | Yes - Automated |
| GMBH_CO_KG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| GMBH_CO_KG | Shareholderlist for GmbH/UG General Partner | SHAREHOLDER_LIST | No |
| GMBH_I_GR | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| GMBH_I_GR | Gesellschaftsvertrag (partnership/shareholder agreement) | OTHER or SHAREHOLDER_AGREEMENT | No |
| GMBH_I_GR | Notariell beglaubigte Urkundenrolle/Musterprotokoll | OTHER | No |
| gUG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| gUG | List of Shareholders | SHAREHOLDER_LIST | Yes - Automated |
| KDOR | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| KG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| KGAA | Register extract | REGISTER_EXTRACT | Yes - Automated |
| KGAA | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| LTD | Register extract | REGISTER_EXTRACT | Yes - Automated |
| LTD | List of Shareholders | SHAREHOLDER_LIST | No |
| LTD | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| NEV | List of Shareholders (List of Board members) | SHAREHOLDER_LIST | No |
| NEV | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| OHG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| PARTG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| PARTG | Gesellschaftsvertrag (Partnerschaftsvertrag) | OTHER or SHAREHOLDER_AGREEMENT | No |
| SE | Register extract | REGISTER_EXTRACT | Yes - Automated |
| SE | List of Shareholders | SHAREHOLDER_LIST | No |
| SE_CO_KG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| SE_CO_KG | "Aktionärsliste" for AG or AG/SE as General Partner | SHAREHOLDER_LIST | No |
| SE_CO_KG | Articles of Association (Satzung) for AG/SE as General Partner | FOUNDATION_DOCUMENT | No |
| SE_CO_KG | Gesellschaftsvertrag (partnership/shareholder agreement) | OTHER or SHAREHOLDER_AGREEMENT | No |
| SOLE_PROPRIETORSHIP | Register extract | REGISTER_EXTRACT | No |
| Stiftungen | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| Stiftungen | Trustee Agreement / Stiftungssatzung or Statement signed by the Legal Representatives | OTHER | No |
| UG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| UG | List of Shareholders | SHAREHOLDER_LIST | Yes - Automated |
| UG_CO_KG | Register extract | REGISTER_EXTRACT | Yes - Automated |
| UG_CO_KG | Shareholderlist for GmbH/UG General Partner | SHAREHOLDER_LIST | No |
| UG_CO_KG | Gesellschaftsvertrag (partnership/shareholder agreement) | OTHER or SHAREHOLDER_AGREEMENT | No |
| UG_I_GR | Articles of Association (Satzung) | FOUNDATION_DOCUMENT | No |
| UG_I_GR | Gesellschaftsvertrag (partnership/shareholder agreement) | OTHER or SHAREHOLDER_AGREEMENT | No |
| UG_I_GR | Notariell beglaubigte Urkundenrolle/Musterprotokoll | OTHER | No |
The following table includes testing samples for the GET Search for business commercial registration endpoint, including values for the fields country, registration_number, registration_issuer, and name.
| Country | Registration number | Registration issuer | Company name |
|---|---|---|---|
| DE | HRA204605 | Oldenburg (Oldenburg) | Stiftung St. Josef-Stift |
| DE | HRB18686 | Bonn | Tekcor 1. V V UG |
| DE | HRA201632 | Lüneburg | EWIV für Unternehmensberatung |
| DE | HRA12751 | Dortmund | Industrial Mercantile International Co. |
| DE | HRB39889 | Berlin (Charlottenburg) | OKV-Ostdeutsche Kommunalversicherung auf Gegenseitigkeit |
| DE | HRA928 | Koblenz | Hans Leininger, Textilgroßhandlung |
| DE | HRA551344 | Ulm | Ravensburger Verkehrs- und Versorgungsbetriebe |
| DE | GnR729 | Landshut | BürgerEnergie Niederbayern eG |
| ES | A31239833 | ---- | BEKO ERROTA SAL |
| ES | A82234113 | ---- | HOTEL BAHIA TROPICAL SA |
| ES | D92943109 | ---- | MICHAEL SCHMIDT Y CIA ENERGIA SOLAR [...] |
| ES | B40547747 | ---- | CACTUS DIGITAL SIGNAGE SOCIEDAD LIMITADA |
| ES | V54433230 | ---- | EL SECRETO DE SUS OJOS AIE |
| ES | B93050672 | ---- | PURAENVIDIA CONSULTING SL |
| ES | G83086751 | ---- | BARCLAYS GESTION FI |
| ES | B57761249 | ---- | GRUPO SA VINYA IBIZA, SOCIEDAD LIMITADA |
| ES | A79102331 | ---- | UNIDAD EDITORIAL SA |
| FR | 304141732 | ---- | ROGER & GALLET |
| FR | 790241467 | ---- | SR SIGNALETIC |
| FR | 807956966 | ---- | MENTON PARC AUTO |
| FR | 321470072 | ---- | GROUP ETUD CONSTR HAB CONSEIL |
| FR | 642050199 | ---- | AUTOMOBILES CITROEN |
| FR | 330034968 | ---- | INNOVATION ANIMATION CULTURE TOURISME |
| FR | 388843930 | ---- | RISKAUDIT IRSN-GRS INTERNATIONAL |
| FR | 332856574 | ---- | JEAN BAPTISTE POLIZZI |
| FR | 702006230 | ---- | SOFILOGIS |
| FR | 521753418 | ---- | HOLMES AND TOOLS |
| IT | BA543920 | ---- | FONDAZIONE NICOLA E VITO ANTONIO RUGGIERI |
| IT | TP131030 | ---- | MAIORANA GIUSEPPE PICCOLO IMPRENDITORE EDILE |
| IT | BA520383 | ---- | SPECIAL CARS SRL |
| IT | BI11627 | ---- | ALLEANZA COOPERATIVA TORINESE*A.C.T. |
| IT | MI152555 | ---- | UNICREDIT SERVICES S.C.P.A |
| IT | BS505351 | ---- | FUNGHI ENERGIA & SALUTE S.R.L. |
| IT | RM1046737 | ---- | CONSORZIO G.T.I. - GRUPPO TECNOLOGIE INTEGRATE IN LIQUIDAZIONE |
| IT | ME239092 | ---- | RUACH S.C. A R.L. - CONSORZIO STABILE |
For non-DE companies, the registration_issuer field is not necessary.
The following table lists industries connected with license requirements depending on the services provided by the business customer. Upload the license with document_type as OTHER.
| Industries that require licenses |
|---|
| Alcoholic Beverages (Ausschanklizenz) |
| Brokerage or Consultancy on Financial Investments |
| Waste/ Rubbish Collection, Transportation, Trade, or Brokerage |
| Insurance broker / Insurance advisor |
| Fee-based financial investment advisor |
| Realtor (Immobilienmakler) |
| Real Estate Loan Brokerage (Immobiliardarlehensvermittler) |
| Residential Property Manager (Wohnimmobilienverwalter) |
| Site supervisor (Baubetreuer) |
| Property developer (Bauträger, Bauherr) |
| Drones |
| Tour Operator (Reisevermittler) |
| Labour Leasing (Arbeitnehmerüberlassung) |
| Tax Advisor/ Tax Consultancy (Steuerberater) |
| Taxi Business (Taxenverkehr/ Taxiservice) |
| Provision of Ambulatory (Non-stationary) Care |
| Geriatric Nurses (Altenpflegerinnen und Altenpfleger) |
| Employment Agency (Arbeitsvermittlung) |
| Auctioneer/ auction houses (Auktionator) |
| Gastronomy Establishments Without Alcoholic Beverages |
| Accommodation Establishments (Beherbergungsbetriebe) |
| Loan brokerage (Darlehensvermittler) |
| Wholesale of Medicinal Products |
| Road Haulage (Güterkraftverkehr) |
| Ambulance Services (Krankentransport) |
| Trade Fairs, Exhibitions, Markets |
| Pawn Shops (Pfandleihgewerbe) |
| Podiatrist/ Medical Podiatrist |
| Showman on Funfairs (Reisegewerbe) |
| Pension Advisor (Rentenberater) |
| Pest Control (Schädlingsbekämpfung) |
| Debtor and consumer insolvency advisor |
| Covid Test Centre (Corona Schnelltestzentrum) |
| Payment service providers (Zahlungsdienstleister) |
| Register Court |
|---|
| Aachen |
| Altenburg |
| Amberg |
| Ansbach |
| Apolda |
| Arnsberg |
| Arnstadt |
| Arnstadt Zweigstelle Ilmenau |
| Aschaffenburg |
| Augsburg |
| Aurich |
| Bad Hersfeld |
| Bad Homburg v.d.H. |
| Bad Kreuznach |
| Bad Oeynhausen |
| Bad Salzungen |
| Bamberg |
| Bayreuth |
| Berlin (Charlottenburg) |
| Bielefeld |
| Bochum |
| Bonn |
| Braunschweig |
| Bremen |
| Chemnitz |
| Coburg |
| Coesfeld |
| Cottbus |
| Darmstadt |
| Deggendorf |
| Dortmund |
| Dresden |
| Duisburg |
| Düren |
| Düsseldorf |
| Eisenach |
| Erfurt |
| Eschwege |
| Essen |
| Flensburg |
| Frankfurt am Main |
| Frankfurt/Oder |
| Freiburg |
| Friedberg |
| Fritzlar |
| Fulda |
| Fürth |
| Gelsenkirchen |
| Gera |
| Gießen |
| Gotha |
| Göttingen |
| Greiz |
| Gütersloh |
| Hagen |
| Hamburg |
| Hamm |
| Hanau |
| Hannover |
| Heilbad Heiligenstadt |
| Hildburghausen |
| Hildesheim |
| Hof |
| Homburg |
| Ingolstadt |
| Iserlohn |
| Jena |
| Kaiserslautern |
| Kassel |
| Kempten (Allgäu) |
| Kiel |
| Kleve |
| Koblenz |
| Köln |
| Königstein |
| Korbach |
| Krefeld |
| Landau |
| Landshut |
| Langenfeld |
| Lebach |
| Leipzig |
| Lemgo |
| Limburg |
| Lübeck |
| Ludwigshafen a.Rhein (Ludwigshafen) |
| Lüneburg |
| Mainz |
| Mannheim |
| Marburg |
| Meiningen |
| Memmingen |
| Merzig |
| Mönchengladbach |
| Montabaur |
| Mühlhausen |
| München |
| Münster |
| Neubrandenburg |
| Neunkirchen |
| Neuruppin |
| Neuss |
| Nordhausen |
| Nürnberg |
| Offenbach am Main |
| Oldenburg (Oldenburg) |
| Osnabrück |
| Ottweiler |
| Paderborn |
| Passau |
| Pinneberg |
| Pößneck |
| Pößneck Zweigstelle Bad Lobenstein |
| Potsdam |
| Recklinghausen |
| Regensburg |
| Rostock |
| Rudolstadt |
| Saarbrücken |
| Saarlouis |
| Schweinfurt |
| Schwerin |
| Siegburg |
| Siegen |
| Sömmerda |
| Sondershausen |
| Sonneberg |
| Stadthagen |
| Stadtroda |
| Steinfurt |
| Stendal |
| St. Ingbert (St Ingbert) |
| Stralsund |
| Straubing |
| Stuttgart |
| St. Wendel (St Wendel) |
| Suhl |
| Tostedt |
| Traunstein |
| Ulm |
| Völklingen |
| Walsrode |
| Weiden i. d. OPf. |
| Weimar |
| Wetzlar |
| Wiesbaden |
| Wittlich |
| Wuppertal |
| Würzburg |
| Zweibrücken |
The company I am about to register is a „Gesellschaft mit beschränkter Haftung“ (GmbH) – who is my legal representative?
The easiest and surest way to figure that out is to check your current register excerpt (Handelsregisterauszug). It lists all the official legal representatives you must submit. As a further indication, these people must also be listed in the Imprint of your website (Impressum).
The Legal Representative has sole representation rights – do I need to add the other legal representatives as well?
Yes. Even though this legal representative could conclude the process on behalf of the company alone in the following steps, Solaris needs the complete set of information for regulatory purposes. Therefore, enter the information for all legal representatives associated with the business.
One of our legal representatives is currently unavailable – do we need to reach them to complete the process?
Yes. All legal representative(s) must be identified in a video identification session to complete the business identification process (BKYC).
Our legal representatives are about to change soon – shall I include the new ones already?
No; submit the information as it is currently written in the official register. If you already know that these individuals will change, inform your Onboarding Manager immediately.
Why do I have to submit all legal representatives here?
As a bank, Solaris must keep a record of the companies it works with and verify the provided information. The law stipulates that Solaris must collect this information for all legal representatives.
What is a “Beneficial Owner”?
A "Beneficial Owner" is a natural person (an individual) who directly or indirectly owns more than 25% of a legal entity's voting shares. Ultimately, it is the person who benefits from the agreement and holds decision-making power. It can never be another company; Solaris must identify the natural person behind any corporate ownership.
The company has no beneficial owners – how should I proceed?
If a thorough investigation shows that no individual directly or indirectly holds more than 25% of the voting shares, Solaris is required to identify the legal representatives as "fictitious" beneficial owners. Enter their information accordingly.
I don't know the ownership structure of the company – how shall I proceed?
The ownership structure is determined in the shareholder agreement (Gesellschaftsvertrag), signed when founding the entity. Any changes should be noted in amendments or updates to this contract. Consult these documents to verify ownership.
Another company owns the company – what shall I do now?
Submit the information of the natural person (individual) who owns that shareholder company. If the shareholder is also a company (holding or corporate structure), follow the trail of indirect ownership until you find an individual or the ownership is diluted below 25%.
What do you mean by direct or indirectly & how do I calculate that?
Direct ownership: A natural person owns voting shares in the business directly.
Indirect ownership: A person owns an entity that, in turn, owns a part of the business. You must also calculate ownership if entities are stacked (multi-level hierarchy) or if one individual holds shares via multiple entities. To determine the indirect quota, multiply the ownership percentages through each level of the hierarchy. If the total exceeds 25%, that person is a beneficial owner.
Example:
Adello GmbH is the company being identified.
Shareholders of Adello GmbH:
- Peter: 30% (Direct BO)
- Susi: 10%
- Anne: 10%
- Toscana GmbH: 50%
Shareholders of Toscana GmbH:
- Hugo: 75%
- Marie: 25%
Resulting Beneficial Owners of Adello GmbH:
- Peter: Yes (Direct owner with >25%)
- Hugo: Yes (Indirect owner). Calculation: 50% (Toscana's share in Adello) x 75% (Hugo's share in Toscana) = 37.5%.
- Marie: No. Calculation: 50% x 25% = 12.5% (Below the 25% threshold).
We have different kinds of shares – which shares are the decisive ones?
Use the shares with voting power, as the beneficial owner is defined by their ability to control the company's decisions.
Does the UBO need to do something, for instance, sign something or perform a video identification?
No. Submit the information exactly as stated in their official documents (ID card or passport). Beneficial owners do not need to perform a video identification or sign documents during this process.