1.0.0
Ermittlung des Bezahldienst-Server DienstElements mit Hilfe der DVDV API
Der Onlinedienst ermittelt zunächst die Referenz auf den Bezahldienst, die den Behördenschlüssel (organizationKey) enthält. Die ebenfalls notwendige DienstbeschreibungsUri (serviceSpecificationUri) ermittelt der Onlinedienst direkt aus seiner überregional gültigen Konfiguration.
Mit diesen Informationen benutzt der Onlinedienst die methode findServiceDescription der DVDV-API-Bibliothek und ruft damit indirekt den Endpunkt /{entryPath}/findservicedescription mit den Parametern <organizationKey> und <serviceSpecificationUri> auf (siehe Dokumentation der DVDV-API).
Über das ServiceDescription-Rückgabeobjekt der Bibliotheksfunktion kann der Onlinedienst mittels getServiceElements() die Liste der DienstElemente ermitteln. Aus dieser Liste wählt er dasjenige DienstElement aus, dessen Methode getCustomServiceElementType() den Wert "Bezahldienst-Server" liefert. Das so identifizierte DienstElement liefert alle gesuchten Werte für Bezahldienste.
Zur Identifikation des Bezahldienstes ist der Schlüssel ServiceSpecificationUri bei der Benutzung der DVDV-API anzugeben. Der Wert dieses Schlüssels ist für alle Bezahldienste identisch und dem DVDV-Eintragungskonzept für Bezahldienste zu entnehmen. Stand Q2/2024 existiert nur ein experimentelles MVP-Eintragungskonzept, das den Wert für ServiceSpecificationUri auf "urn:dvdv:setup:example:bezahldienst:1" festlegt.