Transaction Api |
Adyen |
Create |
/ |
Prepare |
/ |
Reserve |
Terminal API |
Capture |
/ |
Refund |
Terminal api (async) löst eine Kommunikation mit dem Terminal aus und muss daher asynchron sein. Display leuchtet auch kurz auf. |
Void |
Void nach dem Capture liefert Unsupported Interaction |
Besonderheiten im Umgang mit Terminals
Allgemein: https://docs.adyen.com/point-of-sale/pre-authorisation#pre-authorise
Vorautorisierung (Pre-authorisation) und Autorisierungsanpassung:
In einem grundlegenden Zahlungsablauf wird der zu zahlende Betrag aus der Zahlungsanfrage autorisiert und dann erfasst. Manchmal möchten man jedoch den Betrag ändern oder die Dauer der Autorisierung vor der Erfassung der Zahlung verlängern. Dies wird mit dem Autorisierungstyp "Vorautorisierung" in der Zahlungsanfrage ermöglicht. In diesem Zahlungsablauf kann der autorisierte Betrag zu einem späteren Zeitpunkt erhöht oder verringert und dann die Zahlung erfasst werden. Solche Änderungen an einer vorautorisierten Zahlung werden als "Autorisierungsanpassungen" bezeichnet.
Vorautorisierung:
Dies ist für Anwendungsfälle gedacht, wie oben beschrieben, wenn der zu erfassende Betrag noch nicht bekannt ist. Der anfänglich autorisierte Betrag kann zu einem späteren Zeitpunkt mithilfe der API erhöht oder verringert werden.
Endgültige Autorisierung (Final authorisation):
Kann verwendet werden, wenn der endgültige Betrag im Voraus vereinbart wurde und die Transaktion definitiv vollständig erfasst wird. Es ist nicht möglich, den autorisierten Betrag anzupassen.
collana pay lässt derzeit keine Erhöhung von Beträgen zu, daher wird die endgültige Autorisierung verwendet. Die Verringerung von Beträgen scheint jedoch möglich zu sein (Es kann entweder eine vollständige oder teilweise Erfassung beantragt werden, aber mehrere teilweise Erfassungen werden nicht unterstützt).
Capture: https://docs.adyen.com/point-of-sale/capturing-payments
Wenn eine Point-of-Sale-Zahlung genehmigt wird, erfolgt die Verarbeitung in zwei Schritten:
Autorisierung:
Die Karte wird vom Kartenherausgeber überprüft, und die Gelder werden für die Transaktion reserviert.
Create:
Die reservierten Gelder werden auf das Händlerkonto überwiesen. Standardmäßig erfolgen diese Schritte gleichzeitig. Das bedeutet, dass die Zahlung unmittelbar nach der Autorisierung automatisch erfasst wird.
Die Zahlung kann auch später erfasst werden:
- Automatische Erfassung mit einer Erfassungsverzögerung: Dabei wird die Zahlung autorisiert, und es wird eine Verzögerung eingeräumt, bevor die Zahlung automatisch erfasst wird.
- Manuelle Erfassung: Dabei wird die Zahlung nur autorisiert. Um die Zahlung abzurechnen, ist eine explizite Erfassungsanfrage erforderlich.
collana pay verwendet die zweistufige Version mit Autorisierung und Erfassung. Dafür muss die Einstellung "POS Capture Delay" im Händlerkonto-Backend auf "manuell" gesetzt sein. Außerdem müssen die collana pay Konfigurationseinstellungen wie folgt gesetzt sein:
Refund: https://docs.adyen.com/point-of-sale/refund-payment?tab=partial_refund_2
Referenced refund:
Ein ReversalRequest. Referenzierte Rückerstattungen sind mit der ursprünglichen Zahlung verknüpft und verwenden einen eindeutigen Identifikator dieser Zahlung. Vollständige und teilweise Rückerstattungsanfragen sind sich sehr ähnlich, aber es gibt einige zusätzliche Parameter für eine teilweise Rückerstattung.
Unreferenced refund:
Eine PaymentRequest mit dem Zahlungstyp "Rückerstattung" (Refund). Unreferenzierte Rückerstattungen müssen manuell abgestimmt werden und ermöglichen es, einen beliebigen Betrag auf eine beliebige im Geschäft vorgelegte Karte zurückzuerstatten. Dies kann beispielsweise verwendet werden, um eine Rückerstattung an jemanden auszugeben, der die ursprüngliche Zahlung nicht getätigt hat, wie zum Beispiel einen Geschenkempfänger.
Terminal-Anzeige:
Nur wenn das Terminal das Cloud-Symbol anzeigt, ist es mit der Terminal-API verbunden. Wenn keine Verbindung besteht, ergeben die asynchronen Anfragen Null als Ergebnis.
Terminal-Verhalten:
Das Abbrechen am Terminal führt ebenfalls zu keiner Benachrichtigung und keiner Transaktion im Backend.
collana pay nutzt referenced refunds.
Merchant Account Setup:
Kontotyp
Für die Verwendung von Terminals sollte das Händlerkonto ein POS-Konto und kein E-Commerce-Konto sein. Diese Option ist unter Konto -> Einstellungen -> Standard-Interaktion mit Kunden zu sehen. Für die Terminalnutzung sollte es auf "POS" eingestellt sein, für alle anderen auf "E-Commerce".
POS Capture Delay
Standardmäßig ist die Verzögerung bei "sofortig", was bedeutet, dass die Erfassung direkt nach der Reservierung verarbeitet wird. Dieser Wert kann auch auf "manuell" geändert werden. Die Verzögerungswerte werden derzeit von collana pay nicht unterstützt. Sofortig oder manuell repräsentieren das "PspAutoCaptureEnabled"-Flag im Provider-Konto.
Auflistung Terminals im Adyen Backend
Point of sale -> Terminals
Zugangsdaten zum Terminal
TerminalId (POIID) zum Terminal
The unique ID of the terminal, in the format [device model]-[serial number]. For example, P400-123456789. (serial number always without hyphen (-))
Terminal API und Websockets müssen aktiviert sein
(1. Load new config on terminal and 2. check configuration afterwards)
- Admin menu -> Config -> Update
- Admin menu -> Network -> Diagnostics -> Terminal API