Kreditkartenzahlungen mit einem Drittanbieter in der Kasse verwalten

Bevor Sie beginnen

Zur Verwaltung von Kreditkartenzahlungen über einen externen Drittanbieter über die Kasse müssen Sie folgende Voraussetzungen erfüllen:

• Sie müssen jede Implementierung mit ihrer Umgebung und die Schnittstelle zu der speziell für die Kreditkartenverwaltung verwendeten Software sichern.
• Definieren Sie die in Konfigurieren der Schnittstelle zur Kreditkartenverwaltung aufgeführten Einstellungen.
• Definieren Sie die verwendete Kasse in einer physischen Kasse (Kassentyp = 1), und aktivieren Sie das extern verwaltete Feld für Kreditkartenzahlungen in "Kasse. Öffnen" (OIS210).
• Stellen Sie sicher, dass die in (OIS215) verwendete Zahlungsmethode in "Zahlungsmethode Debitoren. Öffnen" (CRS076) als Kreditkartenzahlungsmethode definiert ist.
• Die Bilder B und D von (OIS215) werden mit einem Skript in H5 für den externen Drittanbieter personalisiert.
• Definieren Sie die E-Mail-Adresse des Kunden (Typ 01) in "E-Mail-Adresse. Öffnen" (CRS111).
• Firma und Division müssen in "Benutzer. Öffnen" (MNS150) auf dieselbe Firma und Division eingestellt sein, über die die Kasse in (OIS215) verbunden ist.

Einschränkungen

• Wenn Teilzahlungen vorgenommen werden, werden die Steuerinformationen für die teilweise bezahlte Rechnung nicht an den Drittanbieter gesendet, wenn OIS215MI LstLineCrCrd verwendet wird.
• Die Ergebnismeldung des Drittanbieters wird nicht übersetzt.
• Die Funktion kann nur im H5 Client aktiviert werden.
• OIS215MI LstCrCrd: Wenn ein Habenbetrag verarbeitet werden soll, werden die Rechnungsinformationen nicht angezeigt.

Barzahlung mit Kreditkarte angeben

Wenn in (OIS215) eine Zahlungsmethode für Kreditkarten angegeben wird und bei der verwendeten Kasse das extern verwaltete Feld "Kreditkartenzahlung" aktiviert ist, überprüft M3, ob eine Drittanbieter-ID gemäß den Einstellungen in "Verbindung Drittanbieter-ID. Öffnen" (CRS439) und "Settings Kr.-Kartenschnittstelle. Öffnen" (CRS434) vorhanden ist.

Wenn der Drittanbieter existiert, werden diese Felder in (OIS215) angezeigt und können im JavaScript als Schnittstelle zum Drittanbieter verwendet werden:

• Zahlungsnummer
• Drittanbieter und Drittanbieter-ID
• Kreditkarten-Referenznummer
• Ergebnis
• Standard-E-Mail (Die E-Mail-Adresse des Kunden (Typ 01) des angegebenen Zahlers, kann jedoch geändert werden.)
• Beleg senden
• Kartenoption – Dieses Feld wird in "Zahlungsmethode Debitoren. Öffnen" (CRS076) eingerichtet und wird angezeigt, wenn der Wert ungleich null ist.

Geben Sie die zu zahlenden Rechnungen und den Zahlungsbetrag ein, und drücken Sie dann die Eingabetaste, um das System des Drittanbieters zu starten. Geben Sie im System des Drittanbieters die Kreditkartendaten an, und klicken Sie auf "Übermitteln". "Barzahlung. Öffnen" (OIS215) wird automatisch angezeigt und der Betrag wird aktualisiert. Die vom Drittanbieter abgerufene Kreditkarten-Referenznummer wird im Feld "Kreditkarten-Referenznummer" angezeigt. Wenn alle Zahlungen verarbeitet wurden, validieren Sie die Zahlungen wie gewohnt in der Kasse.

Das Ergebnis der Transaktion wird mit einem Ergebniscode und der vom Drittanbieter abgerufenen Meldung angezeigt. Wenn ein Fehlercode ausgegeben wird, wird die Zahlung nicht aktualisiert.

In der Kassentabelle (OPAYMH) werden der Drittanbieter, die Drittanbieter-ID, der Transaktionstyp, der Kartentyp, die letzten vier Ziffern der Kartennummer und der Name auf der Karte aktualisiert und können in "Barzahlung. Anzeigen" (OIS219) durch Erstellung einer konfigurierbaren Ansicht angezeigt werden.

Sie können auch Werte für diese Felder hinzufügen und in der Kassentabelle OPAYMH speichern:

• Kreditkartenzahlungsmethode
• PAN-Sequenznummer
• Anwendungsidentifikator
• Freigabecode
• Terminal-ID
• Prüfmethode
• Kreditkartentransaktionszeit
• Zusatzinformation.

Diese Felder können für den Ausdruck des Kasseneingangs im XML-Format OIS213PF konfiguriert werden.

Eine vorhandene Zahlung kann gelöscht werden (Transaktion stornieren), solange die Zahlung noch nicht in (OIS215) validiert wurde. Wenn die Löschung einer Kreditkartenzahlung in (OIS215/D) bestätigt wurde, wird das Drittanbietersystem gestartet, und möglicherweise wird eine ungültige Transaktion durchgeführt.

Die API-Transaktion AddVoid in OIS215MI kann verwendet werden, um ungültige Transaktionen eines Drittanbieters in (OIS215) zu speichern. Ein ungültiger Datensatz kann nicht gelöscht werden, und sein Betrag ist nicht in den Summen enthalten. Nach der Validierung der Zahlung in (OIS215) wird für die ungültige Transaktion in der Kassenzahlungstabelle OPAYMH ein Datensatz mit Transaktionstyp (CDTT) "12-Ungültig" gespeichert, der in (OIS219) eingesehen werden kann. Ungültige Datensätze gehen nach der Validierung der Kasse in "Kasse. Validieren" (OIS217) direkt in den Status PTST 80 = Nebenbuch und Hauptbuch wurden aktualisiert über, obwohl keine Buchung erfolgt. Die Informationen in der Antwort des Drittanbieters bezüglich der ungültigen Transaktion werden dem XML-Datenstrom zum Zwecke der Konfiguration des Ausdrucks hinzugefügt.

Eine bezahlte Rechnung kann nicht storniert werden, wenn die Zahlung über einen Drittanbieter abgewickelt wurde, da die Rechnungsinformationen an den Drittanbieter weitergeleitet wurden.

Wenn ein zurückgewiesener Zahlungs- oder Unterschriftenbeleg aus M3 BE gedruckt werden muss, weil er nicht von der Kreditkartensoftware gedruckt wird, kann die API-Transaktion PrtCCReceipt in der Kassen-API OIS215MI verwendet werden.

Die API-Transaktion löst einen Ausdruck namens OIPRTR aus, bei dem die Eingabedaten der API-Transaktion für Konfigurationszwecke in den Metadaten des XML-Ausdrucks zur Verfügung gestellt werden. Informationen wie Name und Adresse des Zahlers und Name der Kasse werden anhand der Eingabedaten abgerufen und in den XML-Metadaten zur Verfügung gestellt.

Es ist möglich, die Druckerkonfiguration durch die API-Transaktion zu übersteuern. Mit dem Eingabeparameter "Drucker" können Sie die Druckereinstellungen in "Auswahl Ausgabemedium. Öffnen" (MNS205) und "Kasse. Öffnen" (OIS210) übersteuern, indem Sie angeben, welcher Drucker verwendet werden soll. Verfügbare Drucker, die als Eingabe verwendet werden können, werden in "Drucker. Öffnen" (CRS290) definiert.

Die Kreditkartendetails können im XML-Format auf dem Ausdruck des Kasseneingangs (OIS213PF) konfiguriert werden.

Technische Lösung

Wenn (OIS215) personalisiert wurde und Sie dann den erhaltenen Betrag eingeben und die Eingabetaste drücken, wird JavaScript ausgeführt, um die URL zum Drittanbieter zu erstellen.

Das JavaScript ruft Informationen aus der (OIS215)-Ansicht ab (Zahlungsnummer, Zahler, Drittanbieter, Drittanbieter-ID, E-Mail, Beleg senden und Bareingang). Von anderen API-Programmen können weitere Informationen bezogen werden.

Verwendete API-Programme

• CRS610MI Adresse abrufen
• OIS215MI LstCrCrd (ruft Informationen über die bezahlten Rechnungen ab)
  Hinweis

  Wenn ein Habenbetrag verarbeitet werden soll, werden die Informationen in den Rechnungen nicht angezeigt.

• OIS215MI ValidateCCdata sucht nach inkorrekten Eingaben, bevor der Drittanbieter aktiviert wird. Bei einer Warnung oder Stoppmeldung gibt das API-Programm "NOK" aus, und der Benutzer wird zurück zu (OIS215) geleitet.
• CRS434MI Get3rdPartyId

Wenn vom Drittanbieter eine Antwort-URL abgerufen wird, wird M3 Business Engine mit den vom Drittanbieter abgerufenen Informationen mit OIS215MI AddPayment aktualisiert.

Der Ergebniscode und die Meldung wird mit OIS215MI Add3rdpResult aktualisiert.

Die folgende Tabelle zeigt alle vom JavaScript unterstützten Transaktionstypen:

Transaktionstyp	Beschreibung
Haben	Wird bei negativem Zahlungsbetrag verwendet.
Verkauf	Wird bei positivem Zahlungsbetrag verwendet.
Ungültig	Wird verwendet, wenn die Schaltfläche in Bild (OIS215/D) gedrückt wird.