HBCI. Homebanking-Computer-Interface

Transkript

1 HBCI Homebanking-Computer-Interface - Schnittstellenspezifikation - Herausgeber: Bundesverband deutscher Banken e.v., Berlin Deutscher Sparkassen- und Giroverband e.v., Bonn/Berlin Bundesverband der Deutschen Volksbanken und Raiffeisenbanken e.v., Berlin Bundesverband Öffentlicher Banken Deutschlands e.v., Berlin

2 Die vorliegende Schnittstellenspezifikation für eine automatisiert nutzbare multibankfähige Homebanking-Schnittstelle (im folgenden: Schnittstellenspezifikation) wurde im Auftrag des Zentralen Kreditausschusses entwickelt. Sie wird hiermit zur Implementation in Kunden- und Kreditinstitutssysteme freigegeben. Die Schnittstellenspezifikation ist urheberrechtlich geschützt. Zur Implementation in Kundenund Kreditinstitutssysteme wird interessierten Herstellern unentgeltlich ein einfaches Nutzungsrecht eingeräumt. Im Rahmen des genannten Zwecks darf die Schnittstellenspezifikation auch - in unveränderter Form - vervielfältigt und zu den nachstehenden Bedingungen verbreitet werden. Umgestaltungen, Bearbeitungen, Übersetzungen und jegliche Änderung der Schnittstellenspezifikation sind untersagt. Kennzeichnungen, Copyright-Vermerke und Eigentumsangaben dürfen in keinem Fall geändert werden. Im Hinblick auf die Unentgeltlichkeit des eingeräumten Nutzungsrechts wird keinerlei Gewährleistung oder Haftung für Fehler der Schnittstellenspezifikation oder die ordnungsgemäße Funktion der auf ihr beruhenden Produkte übernommen. Die Hersteller sind aufgefordert, Fehler oder Auslegungsspielräume der Spezifikation, die die ordnungsgemäße Funktion oder Multibankfähigkeit von Kundenprodukten behindern, dem Zentralen Kreditausschuss zu melden. Es wird weiterhin ausdrücklich darauf hingewiesen, dass Änderungen der Schnittstellenspezifikation durch den Zentralen Kreditausschuss jederzeit und ohne vorherige Ankündigung möglich sind. Eine Weitergabe der Schnittstellenspezifikation durch den Hersteller an Dritte darf nur unentgeltlich, in unveränderter Form und zu den vorstehenden Bedingungen erfolgen. Dieses Dokument kann bei der HBCI-Leitstelle angefordert werden (info@hbci.de)

3

4 0 0 HBCI - Homebanking Computer Interface Inhaltsverzeichnis Versionsführung Hinzufügungen und Änderungen sind im Dokument in dieser Farbe und zusätzlich durch Unterstreichung und einen Randbalken markiert. Löschungen sind aufgrund der besseren Übersichtlichkeit nicht markiert. Hypertextlinks sind in dieser Farbe markiert. Das vorliegende Dokument wurde von folgenden Personen erstellt bzw. geändert: Name Organisatioon Datum Versi- Dokumente Anmerkungen Stein SIZ.0 HBCI_Laden_GeldKarte_ Geschäftsvorfall_v.doc

5 HBCI - Homebanking Computer Interface Inhaltsverzeichnis 0 Inhaltsverzeichnis Grundsätze... 2 Geschäftsvorfallerweiterung für Version An-/Abmeldung einer GeldKarte Registrierung einer GeldKarte Abmeldung einer GeldKarte... 4 Laden der GeldKarte Laden GeldKarte vorbereiten Laden GeldKarte einleiten Laden GeldKarte durchführen Laden GeldKarte bestätigen Laden GeldKarte Status Laden GeldKarte Storno Laden GeldKarte Storno vorbereiten Laden GeldKarte Storno durchführen Laden GeldKarte Storno bestätigen Data-Dictionary... 29

6 0 2 HBCI - Homebanking Computer Interface Inhaltsverzeichnis Literaturhinweise [] HBCI - Homebanking Computer Interface Schnittstellenspezifikation, Version, Zentraler Kreditausschuss, 0. Mai 2000 [2] HBCI - Homebanking Computer Interface Laden der GeldKarte, Konzept Version.0, Zentraler Kreditausschuss, 7. August 2002 [3] Schnittstellenspezifikation für die ec-karte mit Chip, GeldKarte - Ladeterminals, Version,

7 HBCI - Homebanking Computer Interface Abschnitt: Grundsätze An-/Abmeldung einer GeldKarte Grundsätze Das vorliegende Dokument spezifiziert den Nachrichtenaufbau des Geschäftsvorfalls für das Laden einer GeldKarte im Rahmen des HBCI-Protokolls []. Hierbei wird die Ladevariante Laden gegen andere Zahlungsmittel genutzt. Im vorliegenden Dokument werden lediglich die hierzu notwendigen HBCI-Transaktionen beschrieben, nicht aber die Abläufe im Endgerät sowie im Banksystem. Das Realisierungskonzept [2] ist gegen Unterzeichnung einer Vertraulichkeitserklärung über die HBCI-Leitstelle erhältlich. Das Laden einer GeldKarte über HBCI ist nur in Kombination mit einem Internet-Kundenterminal gemäß ZKA-Spezifikation zulässig.

8 2 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: An-/Abmeldung einer GeldKarte 2 Geschäftsvorfallerweiterung für Version Die nachfolgenden HBCI-Formatdefinitionen gelten ausschließlich für Version. In höheren HBCI-Versionen sind diese Definitionen durch die in der jeweiligen HBCI-Spezifikation enthaltenen Formate zu ersetzen. 2. An-/Abmeldung einer GeldKarte 2.. Registrierung einer GeldKarte Sofern der Kunde eine andere GeldKarte über HBCI laden möchte, als diejenige, die ihm vom Kreditinstitut, bei dem das Laden erfolgen soll, ausgehändigt wurde, muss sie hierfür einmalig kreditinstititutsseitig freigeschaltet werden (s. [2]). Dabei teilt der Kunde die eindeutige Kennung der zu ladenden GeldKarte sowie das Belastungskonto des Ladevorgangs mit. Diese Registrierung kann entweder auf dem Schriftwege, d.h. über eine separate Kundenvereinbarung, die der Kunde in der Filiale unterschreibt, oder mittels des nachfolgenden HBCI-Geschäftsvorfalls erfolgen. Allein auf Basis der Übermittlung dieses Geschäftsvorfalls darf die GeldKarte jedoch nicht zum Laden freigeschaltet werden, sondern die Daten müssen zusätzlich auf einem sicheren Weg bestätigt werden. Hierfür kommt ein Verfahren ähnlich dem Ini-Brief-Austausch beim RDH-Verfahren zum Einsatz, d.h. parallel zur elektronischen Übermittlung wird von der Kundensoftware ein Ini-Brief ausgedruckt, der die Kartenidentifikationsdaten und ggf. einen Hashwert über diese Daten enthält. Der Kunde muss die Angaben auf dem Ini-Brief mit seiner Unterschrift bestätigen. Nach Eingang dieses Briefes im Kreditinstitut und Prüfung gegen die elektronisch übermittelten Daten kann die GeldKarte zum Laden über HBCI freigeschaltet werden. Realisierung Bank: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird Realisierung Kunde: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird a) Kundenauftrag Laden GeldKarte registrieren HKLGR Bezugssegment: - Kunde bspw. Karten eines Familienangehörigen oder kontoungebundene GeldKarten, die der Kunde von einem anderen Institut erhalten hat

9 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: An-/Abmeldung einer GeldKarte 3 Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Kontoverbindung Auftraggeber DEG ktv # M 3 Kartenidentifikationsdaten DE bin 22 M HKLGR:4:+280:234567:: @22@<Kartenident ifikationsdaten> b) Kreditinstitutsrückmeldung Beschreibung Es werden keine Datensegmente zurückgemeldet. Ausgewählte Beispiele für Rückmeldungscodes Code Beispiel für Rückmeldungstext 000 GeldKarte wird nach Eingang des Ini-Briefs freigeschaltet 0020 GeldKarte wurde registriert 900 Registrierung der GeldKarte nicht möglich c) Bankparameterdaten Beschreibung Geschäftsvorfallspezifische Parameter existieren nicht. Laden Geldkarte registrieren Parameter HILGRS Bezugssegment: HKVVB Kreditinstitut Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Maximale Anzahl Aufträge DE num..3 M 3 Anzahl Signaturen mindestens DE num M 0,, 2, 3 HILGRS:2::5++2'

10 4 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: An-/Abmeldung einer GeldKarte 2..2 Abmeldung einer GeldKarte Dieser Geschäftsvorfall ist erforderlich, um eine GeldKarte zum Laden über HBCI abzumelden, um z.b. eine neue GeldKarte zu registrieren. Realisierung Bank: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird Realisierung Kunde: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird a) Kundenauftrag Laden GeldKarte abmelden HKLGA Bezugssegment: - Kunde Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Kontoverbindung DEG ktv # M Auftraggeber 3 Kartenidentifikationsdaten DE bin 22 M HKLGA:4:+280:234567:: @22@<Kartenident ifikationsdaten> b) Kreditinstitutsrückmeldung Beschreibung Es werden keine Datensegmente zurückgemeldet. Ausgewählte Beispiele für Rückmeldungscodes Code Beispiel für Rückmeldungstext 0020 GeldKarte wurde abgemeldet 900 Abmeldung der GeldKarte nicht möglich c) Bankparameterdaten Beschreibung Geschäftsvorfallspezifische Parameter existieren nicht.

11 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: An-/Abmeldung einer GeldKarte 5 Laden Geldkarte abmelden Parameter HILGAS Bezugssegment: HKVVB Kreditinstitut Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Maximale Anzahl Aufträge DE num..3 M 3 Anzahl Signaturen mindestens DE num M 0,, 2, 3 HILGAS:2::5++2'

12 6 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte Laden der GeldKarte Für die Durchführung des Ladevorgangs gelten einige Besonderheiten, die von den übrigen HBCI-Geschäftsvorfällen abweichen: Für den Ladevorgang ist die Abwicklung der vier folgenden Transaktionsschritte erforderlich: Laden GeldKarte vorbereiten Laden GeldKarte einleiten Laden GeldKarte durchführen Laden GeldKarte bestätigen Ein Kundenprodukt oder ein Kreditinstitutssystem, das den Geschäftsvorfall Laden GeldKarte unterstützt, muss immer alle vier Transaktionsschritte unterstützen. Das Kreditinstitut muss somit in den BPD alle vier Parametersegmente anbieten. Es wird empfohlen, anschließend den Geschäftsvorfall Laden GeldKarte Status durchzuführen. Die Transaktionsschritte müssen in der festgelegten Reihenfolge erfolgen. Der erste Transaktionsschritt ( Laden GeldKarte vorbereiten ) erfolgt im Rahmen eines üblichen HBCI-Dialoges. Bei den folgenden Transaktionsschritten wird der anonyme Zugang genutzt, d.h. der personalisierte Dialog ist zu beenden und im Anschluss ein anonymer Dialog zu öffnen. Durch die Nutzung des anonymen Dialoges steht die standardmäßige Verschlüsselung von HBCI nicht mehr zur Verfügung. Daher wird ein Sessionschlüssel in Form einer Zufallszahl von der Chipkarte generiert und im Endgerät im Klartext (skey) gespeichert. Dieser wird für die Verschlüsselung der Daten in den weiteren HBCI-Nachrichten verwendet. Damit die Kreditinstitutsseite ebenfalls über den Sessionschlüssel skey verfügt, wird dieser im nächsten Schritt HBCI-gesichert übertragen.

13 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte 7. Laden GeldKarte vorbereiten Realisierung Bank: optional Realisierung Kunde: optional a) Kundenauftrag Laden GeldKarte vorbereiten HKLGV Bezugssegment: - Kunde Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Kontoverbindung DEG ktv # M Auftraggeber 3 Kartenidentifikationsdaten DE bin 22 C M: für GeldKarte und HBCI werden nicht die selbe Karte benutzt N: sonst 4 Ladebetrag DEG btg # M >0 5 Kundensystem-ID DE id # M 6 Geldkartenstatus DE bin M 7 Sitzungsschlüssel skey DE bin 6 M HKLGV:4: ::280: @22@<Kartenident ifikationsdaten>+200,:dem+heimgaa085+@@<geldka rtenstatus>+@6@<sitzungsschlüssel skey> b) Kreditinstitutsrückmeldung Beschreibung Für die verschlüsselte Übertragung der Daten zum Endgerät in den nächsten Schritten wird ein weiterer Sitzungsschlüssel skey2 benötigt. Dieser wird von der Ladeanwendung generiert und bis zum Abschluss des Ladevorgangs gespeichert. Hierzu wird folgende HBCI-Antwortnachricht aufgebaut. Laden GeldKarte vorbereiten Antwort HILGV Bezugssegment: - Kreditinstitut

14 8 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Sessionnummer DE num..0 M 3 Sitzungsschlüssel skey2 DE bin 6 M HILGV:4: @6@<Sitzungsschlüssel skey 2> Ausgewählte Beispiele für Rückmeldungscodes Code Beispiel für Rückmeldungstext 0020 Auftrag ausgeführt 900 Autorisierungssystem nicht erreichbar 920 Vorgang mit selber GeldKarte noch offen 930 Kontodaten falsch 920 Konto nicht vorhanden 920 Ladebetrag muss größer 0 sein 920 Kundensystem-ID nicht zugelassen oder falsch 920 Kartendaten falsch 920 Sessionschlüssel skey fehlerhaft oder schwach 9230 Unzureichendes Guthaben des Kontos 9380 GeldKarte zum Laden von diesem Konto nicht zugelassen c) Bankparameterdaten Beschreibung Geschäftsvorfallspezifische Parameter existieren nicht. Laden GeldKarte vorbereiten Parameter HILGVS Bezugssegment: HKVVB Kreditinstitut Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Maximale Anzahl Aufträge DE num..3 M 3 Anzahl Signaturen mindestens DE num M 0,, 2, 3 HILGVS:2::5++0'

15 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte 9.2 Laden GeldKarte einleiten Es wird eine HBCI-Nachricht zum Einleiten des Ladens aufgebaut und zum Banksystem gesendet. Ziel dieser Nachricht ist es, das Geldkarten-Kommando Laden Einleiten vom Banksystem generieren zu lassen und abzuholen. Realisierung Bank: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird Realisierung Kunde: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird a) Kundenauftrag Laden GeldKarte einleiten HKLGE Bezugssegment: - Kunde Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (6 Byte) mit skey über den folgenden Daten: Nachrichtennummer: Es ist nur der Wert zulässig, der anzeigt, dass dies die zweite Nachricht (erste Nachricht des anonymen Zugangs) des Ladens der GeldKarte ist. Zufallszahl (binär, 8 Byte): Die für die externe Authentikation notwendige Zufallszahl der GeldKarte RND muss übertragen werden, damit ein korrektes Geldkarten-Kommando Laden Einleiten vom HBCI-Hintergrundsystem erzeugt werden kann. Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 6). Die fehlenden 7 Bytes werden mit '00' aufgefüllt. HKLGE:4: @6@<Chiffre> b) Kreditinstitutsrückmeldung Beschreibung Die Antwortnachricht enthält das Geldkartenkommando Laden Einleiten.

16 0 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte Laden GeldKarte einleiten Antwort HILGE Bezugssegment: - Kreditinstitut Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (56 Byte) mit skey2 über den folgenden Daten: Nachrichtennummer: Es ist nur der Wert zulässig, die anzeigt, dass dies die zweite Nachricht (erste Nachricht des anonymen Zugangs) des Ladens der GeldKarte ist. Geldkartenkommando Laden einleiten (binär, 5 Byte): Das Datenfeld enthält das komplette Kommando Laden Einleiten, dass ohne weitere Modifikationen an die GeldKarte weitergegeben werden kann. Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 56). Die fehlenden 4 Bytes werden mit '00' aufgefüllt. Ausgewählte Beispiele für Rückmeldungscodes Code Beispiel für Rückmeldungstext 0020 Auftrag ausgeführt 900 Ladevorgang abgebrochen 9030 Fehler bei der Entschlüsselung 920 Vorgang mit dieser GeldKarte noch nicht geöffnet 920 Falsche Reihenfolge der Nachrichten HILGE:4: @56@<Chiffre> c) Bankparameterdaten Beschreibung Geschäftsvorfallspezifische Parameter existieren nicht.

17 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte Laden GeldKarte einleiten Parameter HILGES Bezugssegment: HKVVB Kreditinstitut Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Maximale Anzahl Aufträge DE num..3 M 3 Anzahl Signaturen mindestens DE num M 0,, 2, 3 HILGES:2::5++0'

18 2 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte.3 Laden GeldKarte durchführen Realisierung Bank: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird Realisierung Kunde: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird a) Kundenauftrag Beschreibung Das nächste Chipkartenkommando Laden muss vom Kreditinstitutssystem angefordert werden. Laden GeldKarte durchführen HKLGD Bezugssegment: - Kunde Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (80 Byte) mit skey über den folgenden Daten: Nachrichtennummer: Es ist nur der Wert 2 zulässig, die anzeigt, dass dies die dritte Nachricht (2. Nachricht des anonymen Zugangs) des Ladens der GeldKarte ist. Geldkartendaten (binär, 66 Byte): Die Antwortdaten des in Schritt 2 ausgeführten Geldkarten-Kommandos Laden Einleiten müssen zur Ladezentrale übermittelt werden. Der Returncode der GeldKarte braucht nicht mit übermittelt zu werden. Zufallszahl (binär, 8 Byte): Die für die externe Authentikation notwendige Zufallszahl der GeldKarte RND3 muss übertragen werden, damit ein korrektes Geldkarten-Kommando Laden vom HBCI-Hintergrundsystem erzeugt werden kann. Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 80). Die fehlenden 5 Bytes werden mit '00' aufgefüllt. HKLGD:4: @80@<Chiffre>

19 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte 3 b) Kreditinstitutsrückmeldung Beschreibung Das Geldkarten-Kommando wird in eine HBCI-Antwortnachricht integriert. Laden GeldKarte durchführen Antwort HILGD Bezugssegment: - Kreditinstitut Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (72 Byte) mit skey2 über den folgenden Daten: Nachrichtennummer: Es ist nur der Wert 2 zulässig, die anzeigt, dass dies die dritte Nachricht (2. Nachricht des anonymen Zugangs) des Ladens der GeldKarte ist. Geldkartenkommando (binär, 66 Byte): Das Datenfeld enthält das komplette Kommando Laden, dass ohne weitere Modifikationen an die GeldKarte weitergegeben werden kann. Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 72). Die fehlenden 5 Bytes werden mit '00' aufgefüllt.

20 4 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte Ausgewählte Beispiele für Rückmeldungscodes Code Rückmeldungstext 0020 Auftrag ausgeführt 900 Zuständiges AS nicht erreichbar 900 Zuständiges AS nicht verfügbar 9030 Fehler bei der Entschlüsselung 920 Vorgang mit dieser GeldKarte noch nicht geöffnet 920 Falsche Reihenfolge der Nachrichten 920 Ladebetrag abweichend 920 Kartendaten abweichend 9340 Fehler in BMP 62, insbesondere MAC-Fehler 9340 Daten der GeldKarte falsch 9390 Sequenzfehler in BMP Die Karte ist nicht zugelassen 9400 Karte aus Sicherheitsgründen abweisen 9400 Gültigkeitsdauer überschritten oder Karte nicht aktiviert 9400 Entschlüsselte Kartendaten unbekannt oder fehlerhaft 9400 Die Karte ist gesperrt HILGD:4: @72@<Chiffre> c) Bankparameterdaten Beschreibung Geschäftsvorfallspezifische Parameter existieren nicht. Laden GeldKarte durchführen Parameter HILGDS Bezugssegment: HKVVB Kreditinstitut Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Maximale Anzahl Aufträge DE num..3 M 3 Anzahl Signaturen mindestens DE num M 0,, 2, 3 HILGDS:2::5++0'

21 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte 5.4 Laden GeldKarte bestätigen Um zu überprüfen, ob das Laden erfolgreich durchgeführt werden konnte, wird die Antwort der GeldKarte an das Kreditinstitutssystem gesendet. Dazu wird die folgende HBCI-Nachricht aufgebaut. Realisierung Bank: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird Realisierung Kunde: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird a) Kundenauftrag Laden GeldKarte bestätigen HKLGB Bezugssegment: - Kunde Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (24 Byte) mit skey über den folgenden Daten: Nachrichtennummer: Es ist nur der Wert 3 zulässig, der anzeigt, dass dies die vierte Nachricht (3. Nachricht des anonymen Zugangs) des Ladens der GeldKarte ist. Geldkartendaten (binär, 8 Byte): Die Antwortdaten des Geldkarten- Kommandos Laden (insbesondere der K LT -MAC der GeldKarte) müssen vom HBCI-Hintergrundsystem in seiner Eigenschaft als Ladeterminal überprüft werden. Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 24). Die fehlenden 5 Bytes werden mit '00' aufgefüllt. HKLGB:4: @24@<Chiffre>

22 6 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte b) Kreditinstitutsrückmeldung Laden GeldKarte bestätigen Antwort HILGB Bezugssegment: - Kreditinstitut Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (8 Byte) mit skey2 über die Nachrichtennummer. Als Nachrichtennummer ist der Wert 3 anzugeben, da dies die dritte Nachricht des anonymen Zugangs des Ladens der GeldKarte ist.. Da nur verschlüsselt werden kann, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist, werden die fehlenden 7 Bytes mit '00' aufgefüllt. HILGB:4: @8@<Chiffre> Ausgewählte Beispiele für Rückmeldungscodes Code Rückmeldungstext 0020 Auftrag ausgeführt 300 Laden nicht erfolgreich, Storno einleiten 9030 Fehler bei der Entschlüsselung 920 Vorgang mit dieser GeldKarte noch nicht geöffnet 920 Falsche Reihenfolge der Nachrichten 930 Kontodaten falsch 920 Geldkartendaten abweichend 920 Nachrichten-ID falsch c) Bankparameterdaten Beschreibung Geschäftsvorfallspezifische Parameter existieren nicht.

23 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden der GeldKarte 7 Laden GeldKarte bestätigen Parameter HILGBS Bezugssegment: HKVVB Kreditinstitut Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Maximale Anzahl Aufträge DE num..3 M 3 Anzahl Signaturen mindestens DE num M 0,, 2, 3 HILGBS:2::5++0'

24 8 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Status 2.3 Laden GeldKarte Status Das Laden der GeldKarte über HBCI beinhaltet eine komplexe Ablauflogik. Durch die vielen Dialogschritte ist die Wahrscheinlichkeit, dass ein Ladevorgang fehlschlägt, nicht zu vernachlässigen. Besonders nachteilig ist die Tatsache, dass Abbrüche in Situationen auftreten können, in denen für das Endgerät und damit für den Benutzer der Status des Ladevorgangs unklar ist. Daher können mit dem nachfolgenden Geschäftsvorfall die entsprechenden Hintergrundsysteme abgefragt und der Zustand des Ladevorgangs sowie die daraus für den Benutzer resultierenden Konsequenzen in einer verständlichen Form angezeigt werden. Realisierung Bank: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird Realisierung Kunde: verpflichtend, wenn der Geschäftsvorfall Laden GeldKarte vorbereiten unterstützt wird a) Kundenauftrag Laden GeldKarte Statusanfrage HKLGS Bezugssegment: - Kunde Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Terminal-ID DE id # M 3 Kartenidentifikationsdaten DE bin 22 C M: für die Applikationen GeldKarte und HBCI werden verschiedene Karten verwendet O: sonst 4 Geldkartenladeinformation DE bin 33 M HKLGS:4:+HEIMGAA085+@22@<Kartenidentifikations daten>+@33@<eintrag Ladelogdatei> b) Kreditinstitutsrückmeldung Laden GeldKarte Status HILGS Bezugssegment: - Kreditinstitut

25 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Status 9 Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Geldkartenladestatus DE num..2 M 3 Geldkartenladestatus, DE an..80 O Text Ausgewählte Beispiele für Rückmeldungscodes Code Beispiel für Rückmeldungstext 0020 Ladevorgang erfolgreich 920 Ladevorgang abgebrochen, Ladebetrag wird nicht eingezogen 920 Ladevorgang abgebrochen, Ladebetrag wird aus Sicherheitsgründen eingezogen HILGS:4:+7+Ladevorgang abgeschlossen c) Bankparameterdaten Beschreibung Geschäftsvorfallspezifische Parameter existieren nicht. Laden Geldkarte Statusanfrage Parameter HILGSS Bezugssegment: HKVVB Kreditinstitut Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Maximale Anzahl Aufträge DE num..3 M 3 Anzahl Signaturen mindestens DE num M 0,, 2, 3 HILGSS:2::5++2'

26 20 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Storno 2.4 Laden GeldKarte Storno 2.4. Laden GeldKarte Storno vorbereiten a) Kundenauftrag Laden GeldKarte Storno vorbereiten HKLGO Bezugssegment: - Kunde Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (6 Byte) mit skey über den folgenden Daten: Nachrichtennummer: Es ist nur der Wert 4 zulässig, die anzeigt, dass dies die erste Nachricht (4. Nachricht des anonymen Zugangs) des Stornos ist. Zufallszahl (binär, 8 Byte): Die für die externe Authentikation notwendige Zufallszahl der GeldKarte RND5 muss übertragen werden, damit ein korrektes Geldkarten-Kommando Laden Einleiten vom HBCI-Hintergrundsystem erzeugt werden kann. Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 6). Die fehlenden 7 Bytes werden mit '00' aufgefüllt. HKLGO:4: @6@<Geldkartenkommando> b) Kreditinstitutsrückmeldung Laden GeldKarte Storno vorbereiten Antwort HILGO Bezugssegment: HKLGO Kreditinstitut

27 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Storno 2 Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (56 Byte) mit skey2 über folgende Daten: Nachrichtennummer: Es ist nur der Wert 4 zulässig, der anzeigt, dass dies die erste Nachricht (4. Nachricht des anonymen Zugangs) des Stornos ist. Geldkarten-Kommando (binär, 5 Byte): Das Datenfeld enthält das komplette Kommando Laden Einleiten, dass ohne weitere Modifikationen an die GeldKarte weitergegeben werden kann (siehe dazu [3]). Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 56). Die fehlenden 4 Bytes werden mit '00' aufgefüllt. HILGO:4: @56@<Geldkartenkommando> Ausgewählte Beispiele für Rückmeldungscodes Code Beispiel für Rückmeldungstext 0020 Auftrag ausgeführt 9030 Fehler bei der Entschlüsselung 920 Vorgang mit dieser GeldKarte noch nicht geöffnet 920 Vorgang mit dieser GeldKarte bereits abgeschlossen 920 Falsche Reihenfolge der Nachrichten c) Bankparameterdaten Beschreibung Geschäftsvorfallspezifische Parameter existieren nicht. Laden GeldKarte Storno vorbereiten Parameter HILGOS Bezugssegment: HKVVB Kreditinstitut Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Maximale Anzahl Aufträge DE num..3 M 3 Anzahl Signaturen mindestens DE num M 0,, 2, 3

28 22 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Storno HILGOS:2::5++0'

29 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Storno Laden GeldKarte Storno durchführen a) Kundenauftrag Laden GeldKarte Storno durchführen HKLGT Bezugssegment: - Kunde Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (80 Byte) mit skey über den folgenden Daten: Nachrichtennummer ( Byte): Es ist nur der Wert 5 zulässig, der anzeigt, dass dies die zweite Nachricht (5. Nachricht des anonymen Zugangs) des Stornos ist. Geldkartendaten (binär, 66 Byte): Die Antwortdaten des in Schritt 2 ausgeführten Geldkarten-Kommandos Laden Einleiten müssen gemäß [3] zur Ladezentrale übermittelt werden. Der Returncode der GeldKarte braucht nicht mit übermittelt zu werden. Zufallszahl (binär, 8 Byte): Die für die externe Authentikation notwendige Zufallszahl der GeldKarte RND7 muss übertragen werden, damit ein korrektes Geldkarten-Kommando Laden vom HBCI-Hintergrundsystem erzeugt werden kann. Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 80). Die fehlenden 5 Bytes werden mit '00' aufgefüllt. HKLGT:4: @80@<Geldkartenkommando>

30 24 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Storno b) Kreditinstitutsrückmeldung Laden GeldKarte Storno durchführen Antwort HILGT Bezugssegment: HKLGT Kreditinstitut Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (72 Byte) mit skey2 über folgende Daten: Nachrichtennummer: Es ist nur der Wert 5 zulässig, der anzeigt, dass dies die zweite Nachricht (5. Nachricht des anonymen Zugangs) des Stornos ist. Geldkartenkommando (binär, 66 Byte): Das Datenfeld enthält das komplette Kommando Laden, dass ohne weitere Modifikationen an die GeldKarte weitergegeben werden kann (siehe dazu [3]). Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 72). Die fehlenden 5 Bytes werden mit '00' aufgefüllt. HILGT:4: @72@<Geldkartenkommando> Ausgewählte Beispiele für Rückmeldungscodes Code Beispiel für Rückmeldungstext 0020 Auftrag ausgeführt 900 Zuständiges AS nicht erreichbar 900 Zuständiges AS nicht verfügbar 9030 Fehler bei der Entschlüsselung 920 Vorgang mit dieser GeldKarte noch nicht geöffnet 920 Falsche Reihenfolge der Nachrichten 920 Ladebetrag abweichend 920 Kartendaten abweichend 9340 Fehler in BMP 62, insbesondere MAC-Fehler 9340 Daten der GeldKarte falsch 9390 Sequenzfehler in BMP Die Karte ist nicht zugelassen 9400 Karte aus Sicherheitsgründen abweisen 9400 Gültigkeitsdauer überschritten oder Karte nicht aktiviert 9400 Entschlüsselte Kartendaten unbekannt oder fehlerhaft

31 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Storno Die Karte ist gesperrt c) Bankparameterdaten Beschreibung Geschäftsvorfallspezifische Parameter existieren nicht. Laden GeldKarte Storno durchführen Parameter HILGTS Bezugssegment: HKVVB Kreditinstitut Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Maximale Anzahl Aufträge DE num..3 M 3 Anzahl Signaturen mindestens DE num M 0,, 2, 3 HILGTS:2::5++0'

32 26 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Storno Laden GeldKarte Storno bestätigen a) Kundenauftrag Laden GeldKarte Storno bestätigen HKLGX Bezugssegment: - Kunde Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre mit skey über den folgenden Daten: Nachrichtennummer: Es ist nur der Wert 6 zulässig, der anzeigt, dass dies die dritte Nachricht (6. Nachricht des anonymen Zugangs) des Stornos ist. GeldKarten-Daten (binär, 8 Byte): Wenn der gesamte Stornodialog von Schritt bis hierher abgearbeitet wurde, müssen die Antwortdaten des in Schritt ausgeführten Geldkartenkommandos Laden (insbesondere der K LT -MAC der GeldKarte) vom HBCI-Hintergrundsystem in seiner Eigenschaft als Ladeterminal überprüft werden. Muss nur der autorisierte Ladebetrag storniert werden, sind keine Geldkartendaten vorhanden; dieses Feld kann dann leer bleiben. Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 24 bzw. 8). Die fehlenden 5 bzw. 7 Bytes werden mit '00' aufgefüllt. Beispiel HKLGX:4: @24@<Geldkartenkommando>

33 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Storno 27 b) Kreditinstitutsrückmeldung Laden GeldKarte Storno Bestätigung HILGX Bezugssegment: HKLGX Kreditinstitut Nr. Name Typ Format Länge Status Anzahl kopf DEG M 2 Sessionnummer DE num..0 M 3 Geldkartenkommando DE bin..256 M Belegungsrichtlinien Geldkartenkommando CBC-Triple-DES-Chiffre (8 Byte) mit skey2 über folgende Daten: Nachrichtennummer: Es ist nur der Wert 6 zulässig, der anzeigt, dass dies die dritte Nachricht (6. Nachricht des anonymen Zugangs) des Stornos ist. Filler: Es kann nur verschlüsselt werden, wenn die Anzahl der zu verschlüsselnden Bytes ein ganzzahliges Vielfaches von 8 ist (in diesem Fall 8). Die fehlenden 7 Bytes werden mit '00' aufgefüllt. HIGLX:4: @8@<Geldkartenkommando> Ausgewählte Beispiele für Rückmeldungscodes Code Beispiel für Rückmeldungstext 0020 Auftrag ausgeführt 900 Storno nicht erfolgreich 900 Ladebetrag kann nicht erstattet werden 9030 Fehler bei der Entschlüsselung 920 Vorgang mit dieser GeldKarte noch nicht geöffnet 920 Falsche Reihenfolge der Nachrichten 930 Kontodaten falsch 920 GeldKarten-Daten abweichend 920 Nachrichten-ID falsch c) Bankparameterdaten Beschreibung Geschäftsvorfallspezifische Parameter existieren nicht.

34 28 HBCI - Homebanking Computer Interface Geschäftsvorfallerweiterung für Version Abschnitt: Laden GeldKarte Storno Laden GeldKarte Storno bestätigen Parameter HILGXS Bezugssegment: HKVVB Kreditinstitut Nr. Name Typ Formagtuzahl Län- Sta- An- kopf DEG M 2 Maximale Anzahl Aufträge DE num..3 M 3 Anzahl Signaturen mindestens DE num M 0,, 2, 3 HILGXS:2::5++0'

35 HBCI - Homebanking Computer Interface Abschnitt: Data-Dictionary Laden GeldKarte Storno 29 3 Data-Dictionary Anzahl Signaturen mindestens s. HBCI-Spezifikation Geldkartenkommando Kommando für die GeldKarte, CBC-Triple-DES-chiffriert. DE Format: bin Länge:..256 Geldkartenladeinformation Aktueller Zustand der GeldKarte und Informationen zum letzten Ladevorgang, beschrieben durch den Eintrag in Record des karteninternen Logfiles EF_LLOG. DE Format: bin Länge: 33 Geldkartenladestatus Status des Ladevorgangs einer GeldKarte. Die möglichen Stati sind in Abbildung 6 in [2] beschrieben. DE Format: num Länge:..2 Geldkartenladestatus, Text Klartextmeldung der Ladeanwendung, die dem Benutzer am Endgerät angezeigt werden soll DE Format: an Länge:..80 Geldkartenstatus Aktueller Zustand der GeldKarte, beschrieben durch das Statusbyte des letzten Eintrags des karteninternen Logfiles EF_LLOG.

36 30 HBCI - Homebanking Computer Interface Abschnitt: Data-Dictionary Laden GeldKarte Storno DE Format: bin Länge: Kartenidentifikationsdaten Diese Daten dienen zur Ableitung des kartenindividuellen Schlüssels K LT aus dem KGK LT. Sie können dem EF_ID der zu ladenden GeldKarte entnommen werden. DE Format: bin Länge: 22 Kontoverbindung Auftraggeber Von diesem Konto soll der Ladebetrag abgebucht werden. Das heißt, dass der Ladebetrag an diesem Konto autorisiert werden muss. DEG Format: ktv Länge: # Kundensystem-ID Die Kundensystem-ID wird in der Ladeanwendung dazu benutzt, den Endgerät-spezifischen Schlüssel K TRANS aus dem Masterschlüssel KGK TRANS abzuleiten. Außerdem muss eine eindeutige Identifikation des Endgerätes geliefert werden, weil in der Ladeanfrage an die Ladezentrale eine eindeutige Terminal-ID und der Standort des Ladeterminals mit zu übermitteln ist. DE Format: id Länge: # Ladebetrag Betrag, mit dem die GeldKarte geladen werden soll. Er muss größer 0 sein und darf z.zt. maximal 200 EUR betragen. DEG Format: btg Länge: # Maximale Anzahl Aufträge s. HBCI-Spezifikation kopf s. HBCI-Spezifikation

37 HBCI - Homebanking Computer Interface Abschnitt: Data-Dictionary Laden GeldKarte Storno 3 Sessionnummer Eindeutige Kennzeichnung des Dialoges, die dazu dient, dass die Ladeanwendung die nachfolgenden Schritte eindeutig dem in diesem Schritt eingeleiteten Vorgang zuordnen kann. Sie wird vom Kreditinstitut in der Nachricht Laden GeldKarte vorbereiten übermittelt. Die exakte Belegung der Sessionnummer ist institutsspezifisch. DE Format: num Länge:..0 Sessionschlüssel skey Chiffrierschlüssel, der zum Verschlüsseln der Daten des Endgerätes bzw. der GeldKarte innerhalb des anonymen Zugangs benutzt wird. DE Format: bin Länge: 6 Sessionschlüssel skey2 Chiffrierschlüssel, der zum Verschlüsseln der Daten der Ladeanwendung bzw. der Ladezentrale innerhalb des anonymen Zugangs benutzt wird. DE Format: bin Länge: 6 Terminal-ID Eindeutige Kennung des Geldkarten-Ladeterminals, die durch die Ladeanwendung vergeben wird. DE Format: id Länge: #