-Schnittstelle

Aufruf der Schnittstelle für eine Alipay Webseiten-Zahlung

Für Alipay-Zahlungen sind anschließend Stornierungen und Gutschriften gemäß folgender Kapitel möglich. Per Batch-Nutzung sind nur Gutschriften möglich. Für Transaktionen im stationären Handel (Point-of-Sale) verwenden Sie bitte die Anbindung Alipay Spot Payment oder Alipay QR-Code Payment.

Um eine Alipay Webseiten-Zahlung über ein -Formular abzuwickeln, verwenden Sie bitte folgende URL:

Parameter für Zahlungen mit Alipay Webseiten-Zahlung

Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure bei Alipay Webseiten-Zahlung

Aufruf der Schnittstelle für Zahlung mit Alipay Spot Payment

Um eine Zahlung mit Alipay Spot Payment über eine Server-zu-Server-Verbindung abzuwickeln, verwenden Sie bitte folgende URL:

Parameter für Zahlungen mit Alipay Spot Payment

Ergebnis-Parameter für Alipay Spot Payment

Aufruf der Schnittstelle für Zahlung mit Alipay QR-Code Payment

Um eine Zahlung mit Alipay QR-Code Payment über eine Server-zu-Server-Verbindung abzuwickeln, verwenden Sie bitte folgende URL:

Parameter für Zahlungen mit Alipay QR-Code Payment

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das als Antwort in einer Server-zu-Server-Verbindung zurücksendet, für eine Auftragserteilung des QR-Codes, der später vom Kunden gescannt wird. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

Parameter der synchronen Antwort von Alipay QR-Code Payment – Auftragserteilung für QR-Code

Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das an Ihre URLNotify übergibt, wenn die asynchrone Benachrichtigung von Alipay über die Zahlungsausführung eingetroffen ist. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

Parameter der asynchronen Antwort von Alipay QR-Code Payment – Zahlungsausführung

Aufruf der Schnittstelle für Zahlung mit Alipay In-App Payment

Um eine Zahlung mit Alipay In-App Payment über eine Server-zu-Server-Verbindung abzuwickeln, verwenden Sie bitte folgende URL:

Parameter für Zahlungen mit Alipay In-App Payment

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das als Antwort in einer Server-zu-Server-Verbindung zurücksendet, für eine Anforderung eines Anfrage-Strings zum Aufruf der API des In-App Payment. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

Parameter der synchronen Antwort von Alipay In-App Payment – Zusammenstellen des Anfrage-Strings für den API-Aufruf

Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das an Ihre URLNotify übergibt, wenn die asynchrone Benachrichtigung von Alipay über die Zahlungsausführung eingetroffen ist. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

Parameter der asynchronen Antwort von Alipay In-App Payment – Zahlungsausführung

Storno

Stornierungen einer Zahlung mit Alipay Spot Payment oder QR-Code Payment sind über eine Server-zu-Server-Kommunikation möglich. Das erlaubt Stornierungen, die sich auf eine vorher über das getätigte Zahlung oder Autorisierung beziehen. Wenn Sie sich bei einem Storno auf eine Zahlung beziehen, wird die komplette Zahlung storniert. Ein Storno ist nur vor dem täglichen Kassenschnitt bei Alipay möglich.

Für Alipay-Online-Zahlungen über alipay.aspx oder alipayApp.aspx sind keine Stornierungen möglich.

Um eine Stornierung für Alipay Spot Payment oder QR-Code Payment über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

Parameter für Storno von Alipay Spot Payment oder QR-Code Payment

Ergebnis-Parameter für Storno von Alipay Spot Payment oder QR-Code Payment

Gutschrift mit Referenz

Gutschriften einer Zahlung mit allen Alipay-Zahlungsvarianten sind über eine Server-zu-Server-Kommunikation möglich. Das erlaubt Gutschriften, die sich auf eine vorher über das getätigte Zahlung beziehen. Dabei ist die Höhe der Gutschrift auf die Höhe der vorangegangen Zahlung beschränkt.

Um eine Gutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:

Parameter für Gutschrift von Alipay-Zahlungen

Ergebnis-Parameter für Gutschrift von Alipay-Zahlungen

Statusabfrage für Alipay Spot Payment

Statusabfragen betreffen nur Zahlungen mit Alipay Spot Payment und sind über eine Server-zu-Server-Kommunikation möglich. Das erlaubt Statusabfragen, die sich auf eine vorher über das getätigte Zahlung beziehen. Eine Statusabfrage wird nötig, sobald Sie bei der Anlage einer Zahlung als Status den Wert AUTHORIZE_REQUEST zurückbekommen haben. Dann muss der Kunde die Zahlung nochmals per App mit seinem Payment-Passwort bestätigen.

Um eine Statusanfrage mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:

Parameter für Statusabfrage von Zahlungen mit Alipay Spot Payment

Ergebnis-Parameter für Statusabfrage bei Alipay Spot Payment

Batch-Nutzung der Schnittstelle

Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer Alipay-Zahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.

Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:

Beschreibung der möglichen Batch-Versionen

Der Aufbau für eine Alipay-Zahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

Beispiel für Master-MID-Funktion:

Beschreibung der Felder im Datensatz von Batch-Dateien

Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien