Getting Started - Input Parameter Validation
Introduction
In general, validation constraints are defined in the GiroIdent API specification - despite a few complex constraints, that are described in the following section.
Fail fast on your user interface!
finAPI recommends implementing user input validators on your website, that reflect the validation constraints of the GiroIdent API.
Additional Validation of Input Parameter for GiroIdent Plus and GWG Variants
The GiroIdent Plus and GWG variants integrate web services provided by the SCHUFA. These APIs have strict constraints for input parameters for user name and address.
Allowed characters for the SCHUFA web services:
A-Z a-z
ß
äöü ÄÖÜ
0-9
/:(),'.-
finAPI APIs implement special character mappings and filter non-compliant characters to improve the robustness of the software; nevertheless, it is the customer’s responsibility to validate the details provided by the user (e.g. in a GUI), to achieve the best possible user experience.
Further constraints:
Parameter | Constraint |
|---|---|
Zip Code | must be a known valid ZIP code for the given country |
Forename | must not start with a digit/number |
Surname | must contain at least one character |
Date of Birth | age of the user must be at least 7 and less or equal to 130 years |
For validation-related details please refer to the official SCHUFA API documentation. The following details are provided for reference only, finAPI does not guarantee completeness or up-to-dateness.
In case you require more information regarding the SCHUFA validation errors, support is available directly from Schufa at: vp-anbindung@schufa.de.
Reference Documents (to be received together with the SCHUFA contracts):
SCHUFA Verfahrenshandbuch Online
SCHUFA Mapping Special Characters