Skip to main content
Skip table of contents

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.