Schnittstellenbeschreibung Integration

Transkript

1 Anmeldung für elpay payment Entwicklungssupport Dienstleister/Netzbetreiber Abnahmeunterlagen für elpay payment Sehr geehrte Damen und Herren, wir freuen uns, dass Sie mit uns einen neuen Weg im bargeldlosen Zahlungsverkehr gehen und die Einbindung unserer Software elpay payment in Ihre Software realisieren. elpay payment ist für die wichtigsten und führenden Dienstleister / Netzbetreiber zugelassen. Diese Zulassungen beinhalten verbindliche Vorgaben (bestimmte elpay payment Funktionen die aufgerufen werden müssen, Belegvorschriften der Dienstleister / Netzbetreiber usw.) die bei der Abwicklung von ec- und berücksichtigt werden müssen. Diese Vorgaben sind in der Schnittstellenbeschreibung elpay payment definiert und sind die Grundlage für die Einbindung in Ihre Software. Beigefügt erhalten Sie für Ihre Programmierung und für die Abnahme die in der Anlage beigefügte Checkliste. Registrieren Sie sich bei unserem Entwicklungssupport. Verwenden Sie hierfür die Anmeldung für elpay Entwicklungssupport. Bitte füllen Sie die Abnahmeunterlagen aus und senden Sie diese inklusive der aufgeführten Belege an: per Post an : GWK GmbH Entwicklungssupport Bültbek Siek per an : support@elpay.de per Fax an : / Sie erhalten nach Prüfung der Unterlagen Ihre Zertifizierung. Sie haben noch Fragen, dann rufen Sie uns bitte an. Wir freuen uns auf eine angenehme und erfolgreiche Zusammenarbeit mit Ihrem Hause und verbleiben mit freundlichen Grüßen GWK Gesellschaft für Warenwirtschaftsund Kundenbindungssysteme mbh Peter Koschmal GWK GmbH Siek, Stand Seite 1 von 9

2 Anmeldung für elpay payment Entwicklungssupport per Fax an: / per an: support@elpay.de Wir haben die elpay payment Unterlagen von erhalten. Bitte registrieren Sie unsere Firma für Ihre Einbindungsunterstützung. Wir werden elpay payment in unsere Software einbinden. Die uns vom Dienstleister mitgeteilte Test-Terminal-ID* lautet: Bei Abnahme EVA-HOST (afc Rechenzentrum GmbH): Es werden u.a. folgende Funktionsbereiche (siehe Abnahmeunterlagen) von uns implementiert: Trinkgeld Vorautorisierungen Wir werden elpay payment in Verbindung mit einem Hardwareterminal (HT) für PIN-Zahlungen einbinden. Den elpay-plus-partnervertrag haben wir zur Kenntnis genommen. Wir werden elpay-pluspartner. Den Vertrag erhalten Sie bis zum. Firmenbezeichnung/Anschrift: Internet: Name Softwareprodukt: Betriebssystem: Branche(n): Geschäftsführer: Telefon: Fax: Ansprechpartner Vertrieb: Telefon: Fax: Ansprechpartner Programmierung: Telefon: Fax: * entfällt bei der afc Rechenzentrum GmbH siehe auch Abnahmeunterlagen Dienstleister / Netzbetreiber GWK GmbH Siek, Stand Seite 2 von 9

3 Dienstleister / Netzbetreiber Ansprechpartner, geforderte Abnahme und Verfügbarkeit der Testzugänge für elpay payment Adresse und Ansprechpartner Abwicklung von: detaillierte Auskünfte bitte beim Dienstleister erfragen geforderte Abnahme CD-Schlüssel, Verfügbarkeit Testzugänge und Kommunikation afc Rechenzentrum GmbH Bültbek Siek Lastschrift online Abnahme 1 EB44 Testzugang vorhanden und immer verfügbar. Telefon: / Telefax: / Kommunikation: TCP/IP oder ISDN. Vertrieb Köln: Frau Saskia Pokrantz spokrantz@afc.de Tel: Fax: Lastschrift mit Prüfung gegen -Sperrlistendatei online / offline PIN mittels HT B + S Card Service GmbH POS-Systemsupport Lyoner Straße Frankfurt T: 069/ Abnahme 3 EF74 Testzugang vorhanden, aber nicht immer verfügbar. Eigene Test-Terminal-ID beantragen. * Kommunikation: ISDN. fep-support@bs-cardservice.com BCB Betriebs-Center für Banken Processing GmbH Eckenheimer Landstrasse Frankfurt Telefon: 069/ Telefax: 069/ Frankfurter Straße Abnahme 2 EE33 Testzugang vorhanden, aber nicht immer verfügbar. Eigene Test-Terminal-ID beantragen. * Kommunikation: ISDN. CardProcess GmbH Geschäftsstelle Frankfurt Hahnstraße Frankfurt Abnahme 3 Telefon: 0721 / ICP Sales und Service GmbH Hofmannstr München Abnahme 3 EG03 Testzugang vorhanden, aber nicht immer verfügbar. Eigene GWK GmbH Siek, Stand Seite 3 von 9

4 Herr Mike Weller Lastschrift online Test-Terminal-ID beantragen. * Kommunikation: ISDN. Telefon: 089 / Telefax: 089 / Telecash Kommunikations- Service GmbH Theodor-Heuss-Straße Stuttgart Herr Günther Waibel guenter.waibel@telecash.de Theodor Heuss-Straße Stuttgart T: 0711/ F: Kundenkarten: Breuninger, Ikea Abnahme 3 EU82 Testzugang vorhanden, aber nicht immer verfügbar. Eigene Test-Terminal-ID beantragen. * Kommunikation: ISDN. Dienstleister / Netzbetreiber in Vorbereitung: Abkürzungen: PIN: -Zahlungen über HT mit Eingabe der Geheimzahl * Beantragen Sie bei diesen Dienstleistern eine eigene Test-Terminal-ID. Für Ihre Abnahme und Tests mit dem von Ihnen ausgewählten Dienstleister empfehlen wir Ihnen, sich vom Dienstleister eine eigene Test-Terminal-ID einrichten zu lassen. Test-Terminal-ID für und autorisierungen: Die Test-Terminal-ID sollte für die Akzeptanz aller möglichen Zahlungsarten, die vom jeweiligen Dienstleister angeboten werden, frei geschaltet sein. Test-Terminal-ID und HT für PIN-Zahlungen (nur afc Rechenzentrum GmbH): Eine gesonderte Abnahme der PIN-Zahlungsfunktion erfolgt nicht. Lizensierung Test-Terminal-ID`s durch GWK GmbH: Entfällt, wenn Testzugänge beim Dienstleister in elpay payment vorbelegt und verfügbar sind. Bitte die vom Dienstleister vergebene Test-Terminal-ID mit der Anmeldung für elpay Entwicklungssupport mitteilen oder, wenn erst später vorhanden, nachreichen. Sie erhalten umgehend von uns die notwendigen Lizensierungsdaten für die Freischaltung von elpay payment. Lizensiert wird ein 2-Platz-Netzwerk. GWK GmbH Siek, Stand Seite 4 von 9

5 Abnahmeunterlagen elpay payment Abnahme elpay payment Einbindung Firmenbezeichnung/Anschrift: GF: Ansprechpartner Vertrieb: Telefon: Fax: Ansprechpartner Programmierung: Telefon: Fax: Internet: Unsere Produktbeschreibung (Für mehrere Produkte bitte diese Unterlagen kopieren) Softwarename Version Kurzbeschreibung Betriebssystem Branche Grundlage der Abnahme ist die der o.g. Firma vorliegende Dokumentation Schnittstellenbeschreibung elpay payment der GWK GmbH. Die Schnittstellenbeschreibung definiert den gesamten Umfang der einzubindenden Funktionen, Belege usw. für die Abwicklung von und über unterschiedliche Dienstleister / Netzbetreiber, im folgenden Dienstleister genannt. Die Checkliste dient der Kontrolle, welche Funktionen von elpay payment durch die o.g. Software unterstützt werden. Sie beinhaltet die wesentlichen Funktionen für die Einbindung von elpay payment und ist Grundlage für die Abnahme. Die Abnahme 1 erfolgt ausschließlich durch die GWK GmbH. Die Abnahmen 2 und 3 erfolgt durch die GWK GmbH und durch den von Ihnen ausgewählten Dienstleister. Siehe hierzu die beigefügte Anlage Dienstleister / Netzbetreiber. Für jeden zugelassenen Dienstleister muss eine eigene Abnahme erfolgen. Führen Sie für eine Abnahme immer alle Autorisierungen über das entsprechende Testsystem des Dienstleisters durch. Soll die Abnahme für mehrere Dienstleister erfolgen, so bitten wir Sie, diese Unterlagen zu kopieren und mit den entsprechenden Belegen an die GWK GmbH zu senden. Verlangt der Dienstleister gemäß Abnahme 2 / Abnahme 3 eine eigene Abnahme, so veranlassen wir die Abnahme bei den von Ihnen ausgewählten Dienstleistern. Der Einsatz der o.g. Software in Verbindung mit elpay-produkten darf erst nach erteilter Abnahme durch die GWK GmbH erfolgen. Die Prüfung dieser Abnahmeunterlagen erfolgt unmittelbar nach Zusendung an die GWK GmbH. Die Erteilung der Abnahme erfolgt schriftlich durch die GWK GmbH. GWK GmbH Siek, Stand Seite 5 von 9

6 Die Tests haben wir mit dem Netzbetrieb des folgenden Dienstleisters duchgeführt. (Für Abnahmen mit mehreren Dienstleistern bitte diese Unterlagen für die einzelnen Dienstleister kopieren und mit den entsprechenden Belegen an die GWK GmbH in Siek senden.) Dienstleister / Netzbetreiber: Abnahme elpay payment (Checkliste mit Beschreibung des Aufrufes). Kassenschnitt täglich Aufruf erfolgt lediglich über elpay payment (Servermodul) ist zusätzlich eingebunden wird täglich automatisch mit der Funktion (1) aufgerufen ist zusätzlich aufrufbar Aufruf im Programm (2): Diagnose ist eingebunden - Aufruf im Programm (2): Schnittstelle elpay payment (Server) ist eingebunden (Pflicht) (1) bitte ergänzen, z.b. "Kassenabschluss", "Tagesende", etc (2) bitte ergänzen, z.b.: im Menü "Extras / Funktion", etc GWK GmbH Siek, Stand Seite 6 von 9

7 Abnahme 1 Dienstleister afc Rechenzentrum GmbH (EVA Host) Die abzunehmenden Bereiche müssen durchgeführt werden. Die entstandenen Belege (Kassen- und Kundenbelege) müssen an die GWK GmbH in Siek geschickt werden. Einreichen der Belege kann per Fax, (JPG, BMP, GIF, PDF) oder per Post erfolgen. Zugang via ISDN oder TCP/IP (Daten sind voreingestellt) Terminal ID = (Autorisierung und ) Lizenznummer = Funktionsnummer = Terminal ID = (Vorautorisierung ) Lizenznummer = Funktionsnummer = Terminal ID = (Trinkgeld und ) Lizenznummer = Funktionsnummer = Standardfunktionen TID (in den einzelnen Teilbereichen müssen alle Belege erzeugt werden) ELV / PIN 1 Buchung 1,00 2 Buchung 2,00 3 Storno 1,00 Buchung 1 4 Buchung 19,14 Fehlerbeleg (3014) 5 Buchung 35 6 Buchung 18,10 7 Buchung 18,20 Fehlerbeleg (5000) 8 Buchung 5,50 Fehlerbeleg (Es muss im elpay payment Setup eine Zahlungsgarantie von 500 ct eingetragen sein) 9 KK Buchung 2,00 10 KK Buchung 45,00 11 KK Storno 2,00 Buchung 9 12 KK Buchung 111,00 Fehlerbeleg (3002) 13 KK Buchung 1,91 Fehlerbeleg (3005) 2. Zusatzfunktionen (optional) TID KK Buchung Manuell 3,00 15 KK Storno Manuell 3,00 Buchung KK Telefonische Autorisierung 111,00 Mit Autorisierungsnummer KK Gutschrift 2,00 18 KK Gutschrift Manuell 1,00 19 KK Buchung Manuell (Mailorder) 3,87 Hier wird die KPN der Kreditkarte im Infile 20 KK Storno Manuell (Mailorder) 3,87 mit übergeben ELV Zahlungsgarantie (Es muss im elpay paymentsetup eine Zahlungsgarantie von 500 ct eingetragen sein) 21 Buchung 5,50 mit Parameter ZGBuchen 3. Trinkgeld (optional) TID ELV 22 TG Update 5,00 Buchung 2 23 TG Storno 5,00 Buchung KK TG Update 4,00 Buchung KK TG Storno 4,00 Buchung KK TG Update Manuell 3,00 Buchung KK TG Storno Manuell 3,00 Buchung 26 GWK GmbH Siek, Stand Seite 7 von 9

8 4. Vorautorisierungen (optional) TID KK Erstreservierung 100,00 29 KK Endsumme einer Erstreservierung 100,00 Buchung 28 Storno Endsumme 30 KK 100,00 Buchung 29 Erstreservierung 31 KK Erstreservierung 120,00 32 KK Reservierung Erweiterung 80,00 Buchung KK Endsumme nach Erweiterungen 200,00 Buchung KK Storno Endsumme nach Erweiterung(en) 35 KK Erstreservierung 80,00 200,00 Buchung KK Reservierung Erweiterung 90,00 Buchung KK Storno Erweiterungsreservierung 90,00 Buchung KK Storno Erstreservierung 80,00 Buchung Diagnose (Pflicht) TID Diagnose Diagnosebeleg 6. Kassenschnitt (empfohlen) TID Automatisch nach Uhrzeit vom elpay payment ausgeführt 7. Zusatzinformation i3380 zur Abnahme Integration elpay payment (Pflicht) Als Anlage zu Ihrer Abnahme / Zertifizierung Integration elpay payment und zu unserer Information benötigen wir Ihre Angaben, wie Sie folgende Punkte bzgl. der Anbindung i3380 realisiert haben: i3380 angebunden: realisiert JA Nein Spurdaten lesen über i3380: realisiert JA Nein Zahlungswunsch PIN: realisiert JA Nein Zahlungswunsch ELV: realisiert JA Nein GWK GmbH Siek, Stand Seite 8 von 9

9 Abnahme 2 abhängig vom Dienstleister (ausgedruckte Belege bitte mit diesen Unterlagen an GWK senden). -Lastschrift Storno girocarrd-lastschrift Kreditkarte Zahlung Storno Kreditkarte Gutschrift Kreditkarte Kreditkarte Manuelle Buchung Fehlerfall -Lastschrift (PC Datum = ) Fehlerfall Kreditkarte mit Gültigkeit bis 10/98 Fehlerfall Kreditkarte Zahlung (PC Uhrzeit 1 Stunde abweichend zur realen Uhrzeit) Fehlerfall Kreditkarte Zahlung (ISDN-Stecker gezogen) Kassenschnitt Fehlerfall Kassenschnitt (ISDN-Stecker gezogen) Abnahme 3 abhängig vom Dienstleister (ausgedruckte Belege bitte mit diesen Unterlagen an GWK senden). 1. -Lastschrift 5,00 2. Storno -Lastschrift (1) 5,00 3. POZ Zahlung / 50,00 ** (ENTFÄLLT) 50,00 4. Storno POZ Zahlung (3) ** (ENTFÄLLT) 50,00 5. Zahlung Kreditkarte 11,00 6. Storno Zahlung Kreditkarte (5) 11,00 7. Gutschrift Kreditkarte (6) 12,00 8. Storno Gutschrift Kreditkarte (7) 12,00 9. Zahlung Kreditkarte 13, Storno Zahlung Kreditkarte (9) 13, Erstreservierung Kreditkarte 20, Storno Erstreservierung Kreditkarte (11) 20, Erstreservierung Kreditkarte 100, Reservierungserweiterung (13) 100, Storno Reservierungserweiterung (14) 100, Reservierungserweiterung (13) 150, Buchung auf Reservierungserweiterung (16) 120, Storno Buchung auf Reservierungserweiterung (17) 120, Fehler 04 bei POZ Zahlung ** (ENTFÄLLT) 100, Fehler 91 bei zahlung 20,91 * 21. Fehler 82 bei zahlung 20,82 * 22. Fehler 84 bei zahlung 20,84 * 23. Fehler 96 bei zahlung 20,96 * 24. Fehler 98 bei zahlung 20,98 * 25. Kauf mit späterem Trinkgeld 50, Storno Kauf mit Trinkgeld (25) 50, Kauf mit Späterem Trinkgeld 60, Trinkgeld Update 5, Storno Trinkgeldupdate (28) 5,00 Kassenschnitt Fehlerfall Kassenschnitt (ISDN-Stecker gezogen) (n) Die Zahl in Klammern (Spalte 1) bezieht sich auf die zu stornierende bzw. zu erweiternde Positions-Nr. * Die Übergabe von krummen Nachkommastellen ergibt einen Fehler. Die übergebenen Nachkommastellen entsprechen der Fehlernummer. Beispiel: 3,98 würde "Datum Uhrzeit falsch" ergeben. ** (ENTFÄLLT) Diese Belege müssen nur dann erstellt werden, wenn der Netzbetreiber das POZ-Verfahren unterstützt. Es gelten die Allgemeinen Geschäftsbedingungen der GWK GmbH und die Lizenzbedingungen der elpay-produkte. Die Kenntnisnahme der AGB s und Lizenzbedingungen, dieser Abnahmeunterlagen und die Richtigkeit aller Angaben und Belege wird durch die Unterschrift bestätigt. Ort, Datum Firmenstempel, Unterschrift GWK GmbH Siek, Stand Seite 9 von 9