Alipay für Payment Pages

Konfiguration

1. Um diese Zahlungsmethode für Ihr Konto zu aktivieren, wenden Sie sich bitte an Ihren Kundenbetreuer.
   Wir stellen Ihnen ein Test-Sandbox-Konto zur Verfügung, das Sie zum Testen Ihrer Implementierung benötigen.
2. Ändern Sie Ihre POST an Payment Pages nach Bedarf:
   
   

   Name des Feldes	Erforderlich während der Zahlungssitzung (Entweder vom Händler in POST aufgenommen oder vom Kunden auf Payment Pages eingegeben)	Erforderlich in POST	Beschreibung
   applicationsystem	Nein	Bedingt	Erforderlich bei Verwendung der Schnittstelle Alipay In-App Payments (applicationtype ist "APP"). Definiert die Plattform, auf der die App ausgeführt wird. Unterstützte Werte sind "android" und "ios". Diese kann nicht vom Kunden auf der Seite mit den Zahlungsdetails eingegeben werden, sondern muss in der POST übermittelt werden.
   applicationtype	Nein	Bedingt	Erforderlich bei Verwendung von Alipay WAP oder der Schnittstelle für In-App-Zahlungen Bestimmt die Zahlungsschnittstelle, die dem Kunden angezeigt wird, nachdem er zur von Alipay gehosteten Kasse weitergeleitet wurde: Wenn Sie dieses Feld in Ihrer Anfrage nicht angeben, wird dem Kunden die standardmäßige Alipay E-Commerce-Kassenseite angezeigt (Standardverhalten). Bei Eingabe von "WAP" - Die Transaktion wird über die Schnittstelle Alipay WAP Payments (Wireless Application Protocol) abgewickelt, die in erster Linie für die Nutzung durch mobile Geräte konzipiert ist. Wenn "APP" übermittelt wird - Die Transaktion wird über die Schnittstelle Alipay In-App Payments abgewickelt, die in erster Linie für die Verwendung innerhalb von mobilen Apps konzipiert ist. Hinweis: Bevor Sie Transaktionen mit WAP oder In-App-Zahlungen (sowohl über die Sandbox-Umgebung als auch mit Live-Zahlungen) abwickeln können, müssen Sie sich an Alipay wenden und beantragen, dass diese Funktionen in Ihrem Alipay Konto aktiviert werden.
   billingcountryiso2a	Ja	Nein	Das für die Rechnungsadresse eingegebene Land im ISO2A-Format.
   orderreference	Ja	Ja	Eindeutige Auftragsreferenz, die auf den Systemen von Trust Payments und Alipaygespeichert werden kann. Empfohlene Länge 25 Zeichen oder weniger (genaue Länge abhängig von der erwerbenden Bank). Die Nichteinhaltung dieser Anforderung kann dazu führen, dass der Text in der Transaktion abgeschnitten wird.
   ruleidentifier	Nein	Nein	Wenn Ihr POST an Payment Pages bereits alle für die Zahlungsmethode erforderlichen Felder enthält, können Sie den Checkout-Prozess für den Kunden vereinfachen, indem Sie auch ruleidentifier=STR-14 übermitteln. Dadurch kann der Browser des Kunden sofort auf die von der Zahlungsmethode bereitgestellten Seiten gehen, um die Transaktion abzuschließen. (Wir bezeichnen dies als Journey C) Klicken Sie hier, um mehr über die verschiedenen Reisen zu erfahren.

Benachrichtigungen

Sobald eine Zahlung genehmigt wurde, wird der Betrag zu einem späteren Zeitpunkt, der von Alipay festgelegt wird, überwiesen.

Bevor Sie mit dem Testen beginnen, empfehlen wir Ihnen, sich mit unserem Support-Team in Verbindung zu setzen und zu beantragen, dass in Ihrem Konto Regeln aktiviert werden, die URL-Benachrichtigungen in den folgenden Szenarien an Ihr System übermittelt:

• Wenn eine Zahlung genehmigt wird.
• Wenn die Gelder abgewickelt sind.

Konfigurieren der Benachrichtigung Autorisierung

Wir empfehlen, mindestens die folgenden Felder in Ihre Autorisierung Meldung aufzunehmen:

• Antwortnachricht des Käufers (acquirerresponsemessage)
• Grundbetrag (baseamount) (z. B. €10,50 ist "1050")*
• Hauptbetrag (mainamount) (z.B. €10,50 ist "10.50")*
• Rechnungsland (billingcountryiso2a)
• Währung (currencyiso3a)
• Fehlercode (errorcode)
• Live-Status (livestatus)
• Auftragsnummer (orderreference)
• Zahlungsart (paymenttypedescription)
• Anforderungstyp (requesttypedescription)
• Abrechnungsstatus (settlestatus)
• Website-Referenz (sitereference)
• Transaktionsnummer (transactionreference)
• Zeitstempel Transaktionsstart (transactionstartedtimestamp)

*Bitte wählen Sie Ihr bevorzugtes Format.

Konfigurieren der Benachrichtigung Abrechnung

Wir empfehlen, die folgenden Felder in Ihre Abrechnung Meldung aufzunehmen:

• Abrechnungsstatus (settlestatus)
• Website-Referenz (sitereference)
• Transaktionsnummer (transactionreference)

Prüfen Sie die Benachrichtigung

Sie müssen den Inhalt jeder erhaltenen Meldung prüfen und entsprechend reagieren, indem Sie die in unseren URL-Benachrichtigungen Dokumentation beschrieben sind. Insbesondere müssen Sie auf den aktualisierten settlestatus Wert:

• Auf Genehmigung: Wenn die settlestatus auf "0", "1" oder "10" steht, wurde die Zahlung genehmigt und Sie müssen zu diesem Zeitpunkt keine weiteren Maßnahmen nehmen. Werte von "2" oder "3" bedeuten jedoch, dass die Gelder nicht zur Abrechnung vorgesehen sind (ausgesetzt bzw. storniert)
• Auf Abrechnung: Wenn die settlestatus auf "100" aktualisiert wurde, bedeutet dies, dass der Betrag beglichen wurde. Wenn der Wert auf "3" aktualisiert wurde, bedeutet dies, dass ein Problem aufgetreten ist und die Zahlung daraufhin storniert wurde.

Prüfung

Sie müssen Ihre Lösung testen, bevor Sie mit der Verarbeitung von Live-Zahlungen beginnen können. Testtransaktionen werden über Ihre Testlösung verarbeitet. Website-Referenz.

Voraussetzungen

Sie müssen sich mit unserem Support-Team in Verbindung setzen und die Details Ihres Alipay Testkontos angeben. Wir werden dann Ihren Test Website-Referenz so konfigurieren, dass er sich direkt mit der Alipay Testumgebung verbindet.

Bei der Durchführung von Testtransaktionen wird Ihr Browser auf die Testumgebung Alipay umgeleitet, um eine Zahlung zu simulieren. Ansonsten ist der Prozess genau derselbe wie bei der Verarbeitung von Live-Zahlungen.

Rückerstattungen

Nach der Bearbeitung einer Zahlung ist es möglich, dem Kunden über Portal eine Rückerstattung zu gewähren.

Erstattungen für Alipay werden sofort abgerechnet (settlestatus "100").

Voraussetzungen

• Sie können eine Zahlung erst dann erstatten, wenn die AUTH abgerechnet wurde (settlestatus ist "100").
• Sie können keinen höheren Betrag erstatten als ursprünglich abgerechnet wurde.