Über Amazon Pay

Allgemeines zu Amazon Pay

Amazon Pay bietet Käufern eine sichere, vertrauenswürdige und bequeme Möglichkeit, sich anzumelden und ihre Einkäufe auf Ihrer Website zu bezahlen, indem sie ihre Amazon-Anmeldeinformationen verwenden. Siehe Browser-Support für Information über die von Amazon Pay unterstützten Betriebssysteme, Browser und Browserversionen.

Diese Anleitung bietet einen Überblick über das Käufererlebnis und zeigt Ihnen, wie Sie die neueste Checkout-Technologie von Amazon Pay integrieren können.

Das Checkout-Erlebnis von Amazon Pay

Der Käufer klickt auf die Amazon-Pay-Schaltfläche, um den Checkout zu starten.
Der Käufer meldet sich an, bestätigt sein bevorzugtes Zahlungsinstrument und wählt optional eine Lieferadresse auf der von Amazon Pay gehosteten Seite aus.
Der Käufer wird zur Bestätigung auf Ihre Bestellübersichtsseite zurückgeleitet.
Der Käufer schließt den Checkout auf der von Amazon Pay gehosteten Seite ab, indem er auf die Aufforderung zur Multi-Faktor-Authentifizierung (Identitätsprüfung) antwortet, falls er dazu aufgefordert wird, oder indem er eine andere Zahlungsmethode auswählt, wenn die Zahlung abgelehnt wurde.
Amazon Pay leitet den Käufer auf Ihre Bestätigungsseite zurück.

Weitere Informationen finden Sie auch auf der:

Webseite von Amazon Pay
Checkout Demo-Seite von Amazon: Demo-Seite

Auf dieser Seite

Konfiguration für Amazon Pay

Es gibt zwei nutzbare Optionen, je nachdem, ob Sie ein neuer oder ein bestehender Kunde sind.

Bestehende Kunden

Bereits bestehende Kunden müssen sich bei ihren Konten anmelden und einen neuen Satz von API-Schlüsseln erzeugen, die mit Amazon Pay Checkout Version.2 verwendet werden.

Wir haben bereits die erforderlichen Daten für Ihre Konten für den ursprüngliche Checkout v.1 erzeugt.

Bitte beachten Sie unten die "Anleitung zum Erstellen von API-Schlüsseln".

Neuer Kunde

Vor der Nutzung von Amazon Pay müssen Sie sich unter https://pay.amazon.de/signup registrieren.

Eine Alternative ist die Anmeldung bei Amazon basierend auf dem Land mit folgenden Schritten;

folgen Sie der obigen URL
wählen Sie das nötige Land anhand der Landesflagge oben rechts aus:

Wenn Sie an der Amazon Verkäuferzentrale angemeldet sind, sollten Sie 2 Konten haben, zwischen denen Sie umschalten können:

Sandbox
Produktion

Die erforderlichen Daten für das Onboarding sind die folgenden:

Amazon Cv.2	Anmerkung
Ländercode*	Code des verwendeten Amazon-Marktes (DE=EU, UK, JP und US)
MerchantID	aus der Amazon Verkäuferzentrale
MWS Autorisierungs-Token	Beispiel: amzn.mws.a4a8d852-3d9e-f441-0674-d042baa3cf6452
merchant Store Name	Name des Geschäfts
StoreID	Beispiel: amzn1.application-oa2-client.7150fff45acf49f8acd519fa485142a2

Wenn Sie mehrere Märkte haben, müssen Sie uns diese Informationen für jeden benötigten Markt geben.

Bitte befolgen Sie nachstehende Anleitung, um die nötigen API-Schlüssel zu erzeugen.

Wichtig: Wenn Sie die Option zum Erzeugen von API-Schlüsseln nicht sehen, müssen Sie zuerst einen Shop anlegen und dann die API-Schlüssel erzeugen.

Unter der "Integrationszentrale" ganz unten können Sie dies über den dortigen Link tun:

MWS Autorisierungs-Token

Ein wichtiger Teil der nötigen Daten ist das MWS Autorisierungs-Token von Amazon, das Computop die Erlaubnis gibt, Transaktionen für Ihren Shop durchzuführen.

Der zweite Schritt ist das Generieren eines MWS Auth Token. Das sind die benötigten Daten:

Deutsch/EU:

Developer name: CT_Sandbox_EU
Developer account number: 0143-6461-8727

United Kingdom/Großbritannien:

Developer name: Computop Ltd
Developer account number: 8662-2365-985

Anleitung

Wenn Sie in der Verkäuferzentrale von Amazon angemeldet sind, gehen Sie oben rechts auf die Seite, klicken auf Einstellungen und wählen "Benutzerberechtigungen":

Dies führt Sie zur Seite "Benutzerberechtigungen", die Ihnen die aktuellen Benutzer anzeigt. Hier können Sie Ihrem Konto einen externen Entwickler hinzufügen und klicken dafür bitte auf "Ihre Apps verwalten öffnen":

Dies führt zu einer neuen Seite, auf der Sie Entwickler sehen können, die Zugriff haben. Hier können Sie Berechtigungen hinzufügen, löschen und erneuern. Bitte klicken Sie auf "Neuen Entwickler autorisieren":

Auf der neuen Seite müssen Sie den oben angegebenen Entwicklernamen und die ID hinzufügen. Füllen Sie die Informationen aus und klicken auf "Weiter":

Auf der letzten Seite müssen Sie den Geschäftsbedingungen zustimmen, um einem Entwickler Zugriff auf das Konto zu gewähren.

Wenn Sie auf „Weiter“ klicken, wird eine Erfolgsseite mit Informationen angezeigt:

Mit dem letzten Klick auf „Weiter“ gelangen Sie zurück zur ursprünglichen „Benutzerberechtigung“, wo nun der Entwickler angezeigt wird:

Hier können Sie nun auf „Anzeigen“ klicken und auf den „MWS Authorization Token“ zugreifen und diesen auch kopieren.

Dann senden Sie das erhaltene MWS Autorisierungs-Token auf einem sicheren Weg an den Computop Helpdesk zur Konfiguration.

Anleitung zum Erzeugen von API-Schlüsseln

Um neue API-Schlüssel zu erzeugen, wählen Sie oben auf der Seite eines Ihrer Konten aus, entweder Produktion oder Sandbox. Der Vorgang muss für beide Konten durchgeführt werden. Die Amazon-Beschreibung finden Sie hier.

Klicken Sie bitte links auf das Symbol mit den 3 horizontalen Strichen.

Im erscheinenden Menü gehen Sie bitte zu "Integration" und wählen "Integrationszentrale".

In der Integrationszentrale gehen Sie zum Abschnitt "API-Schlüssel erzeugen" und klicken dort auf die Schaltfläche.

Es erscheint ein Popup-Fenster, in dem Sie "API-Zugangsdaten erzeugen" wählen müssen. Hier müssen Sie den Schlüsseln auch einen eindeutigen Namen geben:

Die neu erstellten Schlüssel sind sofort in der "Integrationszentrale" sichtbar. Dort wählen Sie die Option "Details anzeigen":

Bei den Details können Sie die Daten ansehen oder im JSON-Format herunterladen:

JSON-Beispiel:

Wichtig:

Diese Daten werden für Ihr Onboarding benötigt und müssen zur Konfiguration auf sicherem Weg an den Computop Helpdesk gesendet werden.
Der gleiche Vorgang muss für das zweite Konto wiederholt werden, je nachdem, welches Sie zuerst ausgeführt haben.

Benachrichtigungs-URL

Kunden müssen auch die folgende Paygate Benachrichtungs-URL speichern/konfigurieren.

URL: https://www.computop-paygate.com/amazonpaycomplete.aspx

Gehen Sie zum Menü oben links:

Im erscheinenden Menü gehen Sie bitte zu "Integration" und wählen "MWD Access Key":

Unten auf der Seite sehen Sie die Option für IPN (Instant Payment Notification):

Nach einem Klick auf den blauen Link öffnen sich weitere Seiten mit Integrationseinstellungen:

Klicken Sie hier bitte auf die Schaltfläche "Bearbeiten":

Fügen Sie hier bitte die folgende URL zur Integrator-URL hinzu und klicken auf die Schaltfläche "Aktualisieren".

https://www.computop-paygate.com/amazonAPAV2Notify.aspx

2. Der Händler kann auf Wunsch auch eine eigene Benachrichtigungs-URL hinterlegen. Computop fragt bei der Anfrage auch nach der NotifyURL.

Wichtig: Bitte achten Sie darauf, die per Server-zu-Server gesendeten Benachrichtigungen zu verwenden und sich nicht nur auf die SuccessURLs/FailureURLs zu verlassen.

Schritte im Ablauf

Der grundsätzliche Ablauf einer Bezahlung mit Amazon setzt sich aus mehreren Schritten zusammen:

	Schritt	Beschreibung
1	Schaltfläche Amazon Pay anzeigen	Die Schaltfläche Amazon Pay muss auf der Seite des Webshops ordnungsgemäß implementiert sein und bei jedem Zahlungsvorgang aufgerufen werden. Nachfolgend finden Sie das Code-Snippet als Beispiel.
2	Zahlung über amazonAPA.aspx initialisieren (Server-zu-Server)	Sie rufen den Paygate-Endpunkt https://www.computop-paygate.com/amazonapa.aspx gemäß nachstehender Beschreibung auf. Das Paygate antwortet mit Parametern, mit denen Sie die Schaltfläche Amazon Pay aktualisieren müssen.
3	Weiterleitung zu Amazon	Nach dem Aktualisieren der Schaltfläche Amazon Pay wird der Kunde zu Amazon weitergeleitet.
4	Redirect zurück zu Ihrem Webshop	Nach Bestätigung des bevorzugten Zahlungsmittels des Kunden und optional der Lieferadresse auf der von Amazon Pay gehosteten Seite wird der Kunde zur Bestellübersichtsseite in Ihrem Webshop zurückgeleitet.
5	Abschluss des Kaufes	Nachdem der Kunde die Bestellung bestätigt hat, leiten Sie ihn an die Amazon-URL weiter, die Sie als Antwort vom Paygate erhalten haben.
6	Redirect zurück zu Ihrem Webshop	Nachdem der Kunde die Zahlung auf der Amazon-Seite abgeschlossen hat, wird er basierend auf dem Ergebnis der Zahlung (URLSuccess / URLFailure) zu Ihrer definierten URL zurückgeleitet.
7	Benachrichtigung von Computop wird per S2S gesendet	Stellen Sie bitte sicher, dass Sie die NotifyURL einrichten und verwenden, um eine endgültige Bestätigung über den Erfolg/Fehler der Anfrage zu erhalten.

Wichtig

Bitte stellen Sie sicher, dass Sie die 2 Hauptaufgaben für Händler einplanen:

Hinzufügen der neuen Schaltfläche Amazon Cv.2 (Schritt 1)
Bei der Rückleitung zum Shop (Schritt 2), wo Änderungen stattfinden können, muss der Händler sicherstellen, dass Adresse (falls zutreffend) und Zahlungsmethode geändert werden können. Auch die Möglichkeit einer Betragsänderung sollte mit einem Anruf an das Paygate weitergegeben werden.

Schaltfläche Amazon Pay integrieren

Der folgende Beispiel-Code zeigt, wie Sie die Schaltfläche Amazon Pay button in Ihren Webshop integrieren.

Wenn der Kunde auf diese Schaltfläche klickt, rufen Sie das Paygate auf, um zusätzliche Daten zu erhalten, die für die Aktualisierung der Schaltfläche Amazon Pay nötig sind.

var amazonPayButton = amazon.Pay.renderButton('#AmazonPayButton', {

   merchantId: 'xxxxx',
   publicKeyId: 'SANDBOX-xxxxxxxxxx', 
   ledgerCurrency: 'EUR',          
   checkoutLanguage: 'en_GB', 
   productType: 'PayAndShip', 
   placement: 'Cart',
   buttonColor: 'Gold'
});

amazonPayButton.onClick(function(){
  const [payload, signature, publicKeyId] = your_call_to_paygate();
  
  amazonPayButton.initCheckout({
    createCheckoutSessionConfig: { 
      payloadJSON: payload,
      signature: signature,
      publicKeyId: publicKeyId
    }
  });
});

In diesem Fall müssen folgende Parameter in der Schaltfläche vorhanden sein:

Parameter	Beschreibung	Wert
merchantId	Von Amazon vergebene SellerId
ledgerCurrency	Ihre Hauptbuchwährung. Für EU/UK-Konten kann eine andere Darstellungswährung für die Authentifizierung/Buchung verwendet werden.	Zulässige Werte: US-Händler ‒ 'USD' EU-Händler ‒ 'EUR' UK-Händler ‒ 'GBP' JP-Händler ‒ 'JPY'
placement	Platzierung der Schaltfläche	Zulässige Werte: Cart
buttonColor	Der Parameter buttonColor definiert die Farbe der Schaltfläche	Zulässige Werte: Gold, LightGray, DarkGray
productType	Der Parameter productType definiert, ob die Transaktion für physische oder digitale Güter erfolgt. Der Standardwert ist PayAndShip.	Zulässige Werte: PayAndShip ‒ physische Waren PayOnly ‒ digitale Güter
checkoutLanguage	Der Parameter checkoutLanguage ist option, um die Sprache im Checkout-Prozcess festzulegen. Das ist insbesondere in einer mehrsprachigen Shopumgebung hilfreich. Ohne Angabe des Sprach-Parameters verwendet Amazon automatisch die am besten geeignete Sprache für den Checkout.	Zulässige Werte: US-Händler ‒ 'en_US' EU/UK-Händler ‒ 'en_GB', de_DE', 'fr_FR', 'it_IT', 'es_ES' JP-Händler ‒ 'ja_JP'
estimatedOrderAmount	Dies ist der geschätzte Bestellbetrag an der Kasse. Er muss nicht mit dem endgültigen Bestellbetrag übereinstimmen, wenn der Käufer seine Bestellung nach dem Start der Kasse aktualisiert. Amazon Pay verwendet diesen Wert, um das Transaktionsrisiko einzuschätzen und zu verhindern, dass Käufer Zahlungsmethoden auswählen, die nicht zur Bearbeitung der Bestellung verwendet werden können Verwenden Sie updateButtonInfo(), um den estimatedOrderAmount zu aktualisieren, wenn sich der geschätzte Bestellwert ändert, z. B. wenn der Käufer etwas aus seinem Warenkorb entfernt oder ihm etwas hinzufügt. Diese Funktion kann die Benutzeroberfläche der Schaltfläche aktualisieren und der neue estimatedOrderAmount wird verwendet, um festzustellen, ob die Bestellung den Mindestbestellwert des Ratenzahlungsanbieters trifft. Funktion Beispiel: <script type="text/javascript" charset="utf-8"> amazonPayButton.updateButtonInfo({"amount":"120.99","currencyCode":"USD"}); </script>	Beispiel: { "amount": "50.99", "currencyCode":"USD"},

Weitere Informationen finden Sie in der Dokumentation von Amazon Pay.

Review Page

Bei Verwendung der vollständigen Kaufabwicklung von Amazon Pay v2 ist die Bewertungsseite auf der Seite des Händlers zu verwenden, um eine:

Änderung der Adresse
Änderung der Zahlungsmethode

Eine Änderung von einem oder beiden ist möglich.

Review Page Beispiel

Computop Data

Dies sind die Computop-Daten, die dem Händler für die Review-Page geliefert werden

mid
PayID
XID
TransID
Status=REQUEST
Code=0
AmountAuth=0
AmountCap=0
AmountCred=0
bdaddrstreet2
bdaddrcity
bdaddrcountrycode
bdaddrname
bdphonenumber
bdaddrzip
AddrStreet
AddrCity
AddrCountryCode
addrname
phonenumber
AddrZip
addrstate
amazonmerchantid
rtf=onetime
amazonstatus=Open
amazonpayredirecturl
amazoncheckoutsessionid
amazonpaymentdescriptor

JS Beispiel

Dies ist ein Beispiel für das Java Script, das Händler verwenden können, um gegebenenfalls Änderungen vorzunehmen

let session = document.getElementById('sessionId').value;
let link = document.getElementById('redirectUrl').value;
let buyNow = document.getElementById('buy-now');
buyNow.addEventListener('click', () => {
  window.location = link;
})
amazon.Pay.bindChangeAction('#change-paymethod', {
  amazonCheckoutSessionId: session,
  changeAction: 'changePayment'
});
amazon.Pay.bindChangeAction('#change-shipping', {
  amazonCheckoutSessionId: session,
  changeAction: 'changeAddress'
});

Die Amazon-Beschreibung finden Sie hier:

https://developer.amazon.com/de/docs/amazon-pay-checkout/display-shipping-payment-info.html#2-enable-shipping-and-payment-updates

Betrag aktualisieren

Wenn der Betrag sich während des Review-Prozesses ändert, muss der folgende Request ans Paygate gesendet werden:

Request URL:

https://www.computop-paygate.com/amazonAPA.aspx

Request Parameter:

Amount=999&
Currency=EUR&
CountryCode=EU&
eventToken=UpdateAuthorizeAmount&
PayId=be30427125a94801a4c3757f4ea2111


Response Parameter:

mid=ct_teamtest
PayID=be30427125a94801a4c3757f4ea21111
TransID=n/a
Status=AUTHORIZE_REQUEST
Code=0
XID=d1708fcca09945e6b3e195156848b2f8
AmountAuth=0
AmountCap=0
AmountCred=0

Diagrammm zum Prozessablauf

Version mit möglichen Änderungen an Lieferadresse, Zahlungsmittel oder Betrag.
Gültig für OTP (einmalige Zahlungen) oder für EInrichtung wiederkehrender Zahlungen (RTF=I)

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjEwNzA4NjA4NiIsImRpYWdyYW1OYW1lIjoiQW1hem9uUGF5X0NUIiwiYXNwZWN0IjoiIiwibGlua3MiOiJhdXRvIiwiY2VvTmFtZSI6IkFtYXpvbiBQYXkgQ2hlY2tvdXQgdjIiLCJ0YnN0eWxlIjoidG9wIiwiY2FuQ29tbWVudCI6ZmFsc2UsImRpYWdyYW1VcmwiOiIiLCJjc3ZGaWxlVXJsIjoiIiwiYm9yZGVyIjp0cnVlLCJtYXhTY2FsZSI6IjEiLCJvd25pbmdQYWdlSWQiOjQ4NjMxOTI1LCJlZGl0YWJsZSI6ZmFsc2UsImNlb0lkIjo0ODYzMTkyNSwicGFnZUlkIjoiIiwibGJveCI6dHJ1ZSwic2VydmVyQ29uZmlnIjp7ImVtYWlscHJldmlldyI6IjEifSwib2RyaXZlSWQiOiIiLCJyZXZpc2lvbiI6MCwibWFjcm9JZCI6ImVlMGJiZTIyLTFhYWItNGFlOC05ZTQwLTNlY2ZkMWZjMzUzOCIsInByZXZpZXdOYW1lIjoiQW1hem9uUGF5X0NULnBuZyIsImxpY2Vuc2VTdGF0dXMiOiJPSyIsInNlcnZpY2UiOiIiLCJpc1RlbXBsYXRlIjoiIiwid2lkdGgiOiIxMTA5Iiwic2ltcGxlVmlld2VyIjpmYWxzZSwibGFzdE1vZGlmaWVkIjoiSnVuIDI4LCAyMDIzLCAxMDowMzo0OSBQTSIsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9

Nachfolgende wiederkehrende Zahlungen

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjEwNzA4NjA4OCIsImRpYWdyYW1OYW1lIjoiQW1hem9uUGF5X3JlY3VycmluZ19DVCIsImFzcGVjdCI6IiIsImxpbmtzIjoiYXV0byIsImNlb05hbWUiOiJBbWF6b24gUGF5IENoZWNrb3V0IHYyIiwidGJzdHlsZSI6InRvcCIsImNhbkNvbW1lbnQiOmZhbHNlLCJkaWFncmFtVXJsIjoiIiwiY3N2RmlsZVVybCI6IiIsImJvcmRlciI6dHJ1ZSwibWF4U2NhbGUiOiIxIiwib3duaW5nUGFnZUlkIjo0ODYzMTkyNSwiZWRpdGFibGUiOmZhbHNlLCJjZW9JZCI6NDg2MzE5MjUsInBhZ2VJZCI6IiIsImxib3giOnRydWUsInNlcnZlckNvbmZpZyI6eyJlbWFpbHByZXZpZXciOiIxIn0sIm9kcml2ZUlkIjoiIiwicmV2aXNpb24iOjAsIm1hY3JvSWQiOiJlNmZhODk2ZC1kOTdjLTRiZjctODBjMy00Njc5ZDI5MmE5ZGUiLCJwcmV2aWV3TmFtZSI6IkFtYXpvblBheV9yZWN1cnJpbmdfQ1QucG5nIiwibGljZW5zZVN0YXR1cyI6Ik9LIiwic2VydmljZSI6IiIsImlzVGVtcGxhdGUiOiIiLCJ3aWR0aCI6IjExMDkiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOiJNYXkgMTUsIDIwMjMsIDExOjAzOjI2IEFNIiwiZXhjZWVkUGFnZVdpZHRoIjpmYWxzZSwib0NsaWVudElkIjoiIn0=

Nachfolgende Aktionen

Buchung einer Zahlung

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjEwNzA4NjA5MiIsImRpYWdyYW1OYW1lIjoiQW1hem9uUGF5X2NhcHR1cmVfQ1QiLCJhc3BlY3QiOiIiLCJsaW5rcyI6ImF1dG8iLCJjZW9OYW1lIjoiQW1hem9uIFBheSBDaGVja291dCB2MiIsInRic3R5bGUiOiJ0b3AiLCJjYW5Db21tZW50IjpmYWxzZSwiZGlhZ3JhbVVybCI6IiIsImNzdkZpbGVVcmwiOiIiLCJib3JkZXIiOnRydWUsIm1heFNjYWxlIjoiMSIsIm93bmluZ1BhZ2VJZCI6NDg2MzE5MjUsImVkaXRhYmxlIjpmYWxzZSwiY2VvSWQiOjQ4NjMxOTI1LCJwYWdlSWQiOiIiLCJsYm94Ijp0cnVlLCJzZXJ2ZXJDb25maWciOnsiZW1haWxwcmV2aWV3IjoiMSJ9LCJvZHJpdmVJZCI6IiIsInJldmlzaW9uIjowLCJtYWNyb0lkIjoiYmQ3YjE0OTUtZjAwOS00MzEyLWFkYWUtYzAzMDg1OWFlODkzIiwicHJldmlld05hbWUiOiJBbWF6b25QYXlfY2FwdHVyZV9DVC5wbmciLCJsaWNlbnNlU3RhdHVzIjoiT0siLCJzZXJ2aWNlIjoiIiwiaXNUZW1wbGF0ZSI6IiIsIndpZHRoIjoiMTEwOSIsInNpbXBsZVZpZXdlciI6ZmFsc2UsImxhc3RNb2RpZmllZCI6Ik1heSAxNSwgMjAyMywgMTE6MDI6MzYgQU0iLCJleGNlZWRQYWdlV2lkdGgiOmZhbHNlLCJvQ2xpZW50SWQiOiIifQ==

Gutschrift einer Zahlung

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjEwNzA4NjA5NiIsImRpYWdyYW1OYW1lIjoiQW1hem9uUGF5X2NyZWRpdF9DVCIsImFzcGVjdCI6IiIsImxpbmtzIjoiYXV0byIsImNlb05hbWUiOiJBbWF6b24gUGF5IENoZWNrb3V0IHYyIiwidGJzdHlsZSI6InRvcCIsImNhbkNvbW1lbnQiOmZhbHNlLCJkaWFncmFtVXJsIjoiIiwiY3N2RmlsZVVybCI6IiIsImJvcmRlciI6dHJ1ZSwibWF4U2NhbGUiOiIxIiwib3duaW5nUGFnZUlkIjo0ODYzMTkyNSwiZWRpdGFibGUiOmZhbHNlLCJjZW9JZCI6NDg2MzE5MjUsInBhZ2VJZCI6IiIsImxib3giOnRydWUsInNlcnZlckNvbmZpZyI6eyJlbWFpbHByZXZpZXciOiIxIn0sIm9kcml2ZUlkIjoiIiwicmV2aXNpb24iOjAsIm1hY3JvSWQiOiJlMjRiZjQ2NC0wZjYyLTRkNWYtYjlkMi0xODEzNWFkMzg0YWUiLCJwcmV2aWV3TmFtZSI6IkFtYXpvblBheV9jcmVkaXRfQ1QucG5nIiwibGljZW5zZVN0YXR1cyI6Ik9LIiwic2VydmljZSI6IiIsImlzVGVtcGxhdGUiOiIiLCJ3aWR0aCI6IjExMDkiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOiJNYXkgMTUsIDIwMjMsIDExOjAxOjUxIEFNIiwiZXhjZWVkUGFnZVdpZHRoIjpmYWxzZSwib0NsaWVudElkIjoiIn0=

Storno einer Bestellung

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjEwNzA4NjEwMiIsImRpYWdyYW1OYW1lIjoiQW1hem9uUGF5X3JldmVyc2VfQ1QiLCJhc3BlY3QiOiIiLCJsaW5rcyI6ImF1dG8iLCJjZW9OYW1lIjoiQW1hem9uIFBheSBDaGVja291dCB2MiIsInRic3R5bGUiOiJ0b3AiLCJjYW5Db21tZW50IjpmYWxzZSwiZGlhZ3JhbVVybCI6IiIsImNzdkZpbGVVcmwiOiIiLCJib3JkZXIiOnRydWUsIm1heFNjYWxlIjoiMSIsIm93bmluZ1BhZ2VJZCI6NDg2MzE5MjUsImVkaXRhYmxlIjpmYWxzZSwiY2VvSWQiOjQ4NjMxOTI1LCJwYWdlSWQiOiIiLCJsYm94Ijp0cnVlLCJzZXJ2ZXJDb25maWciOnsiZW1haWxwcmV2aWV3IjoiMSJ9LCJvZHJpdmVJZCI6IiIsInJldmlzaW9uIjowLCJtYWNyb0lkIjoiZmNlM2M2ZTMtZGI5Ni00OGZlLThkOTktZGM2NWUzNDkxYTgyIiwicHJldmlld05hbWUiOiJBbWF6b25QYXlfcmV2ZXJzZV9DVC5wbmciLCJsaWNlbnNlU3RhdHVzIjoiT0siLCJzZXJ2aWNlIjoiIiwiaXNUZW1wbGF0ZSI6IiIsIndpZHRoIjoiMTEwOSIsInNpbXBsZVZpZXdlciI6ZmFsc2UsImxhc3RNb2RpZmllZCI6Ik1heSAxNSwgMjAyMywgMTE6MDA6MzcgQU0iLCJleGNlZWRQYWdlV2lkdGgiOmZhbHNlLCJvQ2xpZW50SWQiOiIifQ==

Paygate-Schnittstelle

Definitionen

Datenformate:

Format	Beschreibung
a	alphabetisch
as	alphabetisch mit Sonderzeichen
n	numerisch
an	alphanumerisch
ans	alphanumerisch mit Sonderzeichen
ns	numerisch mit Sonderzeichen
bool	Bool’scher Ausdruck (true oder false)
3	feste Länge mit 3 Stellen/Zeichen
..3	variable Länge mit maximal 3 Stellen/Zeichen
enum	Aufzählung erlaubter Werte
dttm	ISODateTime (JJJJ-MM-TTThh:mm:ss)

Abkürzungen:

Abkürzung	Beschreibung	Kommentar
CND	Bedingung (condition)
M	Pflicht (mandatory)	Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein
O	optional	Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich
C	bedingt (conditional)	Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist

Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.

Amazon Pay Schnittstelle initialisieren

Um eine Zahlung mit Amazon Pay zu initialisieren, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/amazonAPA.aspx

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
CountryCode	an2	M	Country code of used marketplace. Options EU, US and JP.	Ländercode des verwendeten Marktplatzes. Optionen EU, US und JP.

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
URLSuccess	ans..256	M	The buyer is redirected to this URL if action was successful	Der Käufer wird zu dieser URL weitergeleitet, wenn die Aktion erfolgreich war
URLFailure	ans..256	M	The buyer is redirected to this URL if action was unsuccessful	Der Käufer wird zu dieser URL weitergeleitet, wenn die Aktion nicht erfolgreich war

Key	Format	CND	Description	Beschreibung
URLNotify	ans..256	M	Complete URL which Paygate calls up in order to notify the shop about the payment result. The URL may be called up only via port 443. It may not contain parameters: Use the UserData parameter instead. Common notes: We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.	Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von Paygate zu erhalten Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key	Format	CND	Description	Beschreibung
URLCancel	ans..256	M	The buyer is redirected to this URL if the operation is cancelled	Der Käufer wird zu dieser URL weitergeleitet, wenn der Vorgang abgebrochen wird
ShopUrl	ans..256	M	Order review page where customer is redirected after confirming customer's preferred payment instrument and optionally shipping address on the Amazon Pay-hosted page	Bestellüberprüfungsseite, auf die der Kunde weitergeleitet wird, nachdem er das bevorzugte Zahlungsmittel und optional die Lieferadresse auf der von Amazon Pay gehosteten Seite bestätigt hat
TxType	an..20	C	Payment flow for charging the buyer. Supported values: 'AuthorizeWithCapture' – Authorize and capture funds immediately, is default 'Authorize' – Authorize funds immediately and capture at a later time	Zahlungsablauf für die Belastung des Käufers. Unterstützte Werte: 'AuthorizeWithCapture' – Sofortiges Autorisieren und Einziehen von Geldern ist die Standardeinstellung 'Authorize' – Gelder sofort autorisieren und zu einem späteren Zeitpunkt buchen
LocalCurrency	a3	C	The currency that the buyer will be charged in ISO 4217 format. Only possible for Amazon EU and UK markets.	Die Währung, die dem Käufer in Rechnung gestellt wird, im ISO-4217-Format. Nur möglich für Amazon EU- und UK-Märkte.
Scope	a..128	O	The buyer details that you're requesting access to. Possible values: "name" "email" "phoneNumber" "billingAddress" If not included, all buyer information is requested.	Die Käuferdetails, auf die Sie Zugriff anfordern. Mögliche Werte: "name" "email" "phoneNumber" "billingAddress" Wenn nicht enthalten, werden alle Käuferinformationen angefordert.
ChDesc	ans..16	C	Only for sale type transactions: AuthorizeWithCapture. Default: "AMZ*<SELLER_NAME> pay.amazon.com"	Nur für Sale-Transaktionen: AuthorizeWithCapture. Standardwert: "AMZ*<SELLER_NAME> pay.amazon.com"
OrderDesc	ans..127	O	Use this parameter for the simulation mode. During live mode this parameter has no effects.	Verwenden Sie diesen Parameter für den Simulationsmodus. Im Live-Modus hat dieser Parameter keine Auswirkungen.
			Recurring	Recurring (wiederholte Zahlungen)
RTF	ans1	O	For repeated payments (subscriptions): I = Initial payment of series of payments. Default is OTP, one time payment.	Bei wiederholten Zahlungen (Abonnements): I = Erstzahlung einer Reihe von Zahlungen. Standard ist OTP, einmalige Zahlung.
cycle	an..7	C	Cycle. Supported values: 'Year', 'Month', 'Week', 'Day', 'Variable'	Zyklus. Unterstützte Werte: 'Jahr', 'Monat', 'Woche', 'Tag', 'Variabel'
Value	n..4	C	Number of frequency units per billing cycle. For example, to specify a weekly cycle set unit to Week and value to 1. You must set value to 0 if you're using variable unit. year: 1-3 Month: 1-36 Week: 1-57 Day: 1-1095	Anzahl der Frequenzeinheiten pro Abrechnungszeitraum. Um beispielsweise einen wöchentlichen Zyklus anzugeben, setzen Sie die Einheit auf Woche und den Wert auf 1. Sie müssen den Wert auf 0 setzen, wenn Sie eine variable Einheit verwenden.. Jahr: 1-3 Monat: 1-36 Woche: 1-57 Tag: 1-1095
InstallmentAmount	n..10	C	Transaction amount – choose zero if is not a fixed amount	Transaktionsbetrag – wählen Sie Null, wenn es sich nicht um einen festen Betrag handelt
currency	a3	C	Transaction currency code in ISO 4217 format. Example: EUR	Währungscode der Transaktion im Format ISO 4217. Beispiel: EUR

Verschlüsselte Parameter zum Initialisieren einer Zahlung mit Amazon Pay

Zwischenantwort mit zusätzlichen Parametern der Schaltfläche

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
buttonsignature	ans..256	M	Signature for the Amazon button	Signatur für die Amazon-Schaltfläche
buttonpayload	ans..256	M	Payload for the Amazon button	Payload für die Amazon-Schaltfläche
buttonpublickeyid	ans..256	M	Public Key ID for the Amazon button	Public-Key-ID für die Amazon-Schaltfläche

Antwortparameter nach dem Initialisieren einer Zahlung mit Amazon Pay

Der folgende Beispielcode zeigt die aktualisierte und vollständige Amazon-Pay-Schaltfläche, die den Kunden zu Amazon weiterleitet.

<div id="AmazonPayButton"></div>
<script src="https://static-na.payments-amazon.com/checkout.js"></script>
<script type="text/javascript" charset="utf-8">
var amazonPayButton = amazon.Pay.renderButton('#AmazonPayButton', {
merchantId: 'xxxxx',
ledgerCurrency: 'EUR',          
checkoutLanguage: 'en_GB', 
productType: 'PayAndShip', 
placement: 'Cart',
buttonColor: 'Gold'
});

amazonPayButton.onClick(function(){
// Here you need to call your shop server, which creates the initial Call towards Paygate
// and then returns the required data payloadJSON, signature, publicKeyId from the response
var buttonData = getSignedButtonData()

amazonPayButton.initCheckout({
    createCheckoutSessionConfig: { 
    payloadJSON: buttonData.payloadJSON,
    signature: buttonData.signature,
    publicKeyId: buttonData.publicKeyId
    }
});
</script>

Zwischenantwort mit Kundeninformationen an Ihre ShopUrl

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key	Format	CND	Description	Beschreibung
Code	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
RTF	ans1	O	Onetime or recurring. For repeated payments (subscriptions): I = Initial payment of series of payments.	Einmalig oder wiederkehrend. Bei wiederholten Zahlungen (Abonnements): I = Erstzahlung einer Reihe von Zahlungen.

Antwortparameter nach dem Initialisieren einer Zahlung mit Amazon Pay

Amazon Pay Zahlung buchen

Um eine autorisierte Zahlung mit Amazon Pay zu buchen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/capture.aspx

Die folgenden Tabellen beschreiben die Übergabeparameter und Rückgabewerte, die über die Socket-Verbindung ausgetauscht werden. Der Ablauf der Server-zu-Server-Kommunikation ist im Handbuch Programmiergrundlagen beschrieben.

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
ChDesc	ans..16	O	Text printed on the customer’s credit card bill alongside the payee	Text der auf der Abrechnung des Kreditinstituts des Kunden erscheint
OrderDesc	ans..127	M	Use this parameter for the simulation mode. During live mode this parameter has no effects.	Nutzen Sie diesen Parameter für den Simulationsmodus. Im Livebetrieb hat dieser Parameter keine Auswirkungen.

Key	Format	CND	Description	Beschreibung
ReqId	ans..32	O	To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.	Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Verschlüsselte Parameter zur Buchung einer autorisierten Amazon-Pay-Zahlung

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key	Format	CND	Description	Beschreibung
Code	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
chargeid	ans..256	M	Amazon Pay Charge ID	Amazon Pay Charge ID
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.	Bestellstatus bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
chargepermissionid	ans..256	M	Amazon Pay Permission ID	Amazon Pay Permission ID

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Antwort-Parameter nach Buchung einer autorisierten Amazon-Pay-Zahlung

Nach einer Buchung erhalten Sie eine Benachrichtigung an die angegebene URLNotify mit den folgenden Parametern:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key	Format	CND	Description	Beschreibung
Code	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
chargeid	ans..256	M	Amazon Pay Charge ID	Amazon Pay Charge ID
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.	Bestellstatus bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
chargepermissionid	ans..256	M	Amazon Pay Permission ID	Amazon Pay Permission ID
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefID	ans..27	M	Unique ID for the transaction issued by Amazon	Von Amazon vergebene eindeutige ID für die Transaktion

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
NotificationType	a..25	M	Describes the type of notification. Fixed value: <CaptureNotification>	Beschreibt die Art der Benachrichtigung. Fester Wert: <CaptureNotification>

Antwort-Parameter für URLNotify nach Buchung einer autorisierten Amazon-Pay-Zahlung

Amazon Pay Zahlung gutschreiben

Um eine gebuchte Zahlung mit Amazon Pay wieder gutzuschreiben, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/credit.aspx

Die folgenden Tabellen beschreiben die Übergabeparameter und Rückgabewerte, die über die Socket-Verbindung ausgetauscht werden. Der Ablauf der Server-zu-Server-Kommunikation ist im Handbuch Programmiergrundlagen beschrieben.

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..127	M	Description of purchased goods, unit prices etc. for credit	Beschreibung der gekauften Waren, Einzelpreise etc. für die Gutschrift
chargeid	ans..256	M	Amazon Pay Charge ID	Amazon Pay Charge ID

Key	Format	CND	Description	Beschreibung
ReqId	ans..32	O	To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.	Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Verschlüsselte Parameter zur Gutschrift einer Amazon-Pay-Zahlung

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key	Format	CND	Description	Beschreibung
Code	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.	Bestellstatus bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
chargeid	ans..256	M	Amazon Pay Charge ID	Amazon Pay Charge ID
refundid	ans..256	M	Amazon Pay Refund ID	Amazon Pay Refund ID

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Antwort-Parameter nach Gutschrift einer autorisierten Amazon-Pay-Zahlung

Nach einer Gutschrift erhalten Sie eine Benachrichtigung an die angegebene URLNotify mit den folgenden Parametern:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key	Format	CND	Description	Beschreibung
Code	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.	Bestellstatus bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
chargeid	ans..256	M	Amazon Pay Charge ID	Amazon Pay Charge ID
refundid	ans..256	M	Amazon Pay Refund ID	Amazon Pay Refund ID

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
NotificationType	a..25	M	Describes the type of notification. Fixed value: <CreditNotification>	Beschreibt die Art der Benachrichtigung. Fester Wert: <CreditNotification>

Antwort-Parameter für URLNotify nach Gutschrift einer Amazon-Pay-Zahlung

Amazon Pay Bestellung stornieren

Um eine komplette Bestellung mit Amazon Pay mit der Funktion „CancelOrderReference“ zu stornieren, verweden Sie bitte folgende URL:

https://www.computop-paygate.com/reverse.aspx

Die folgenden Tabellen beschreiben die Übergabeparameter und Rückgabewerte, die über die Socket-Verbindung ausgetauscht werden. Der Ablauf der Server-zu-Server-Kommunikation ist im Handbuch Programmiergrundlagen beschrieben.

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
Reason	a..1024	O	Reason for reversal	Grund der Stornierung
chargeid	ans..256	M	Amazon Pay Charge ID	Amazon Pay Charge ID

Key	Format	CND	Description	Beschreibung
ReqId	ans..32	O	To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.	Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Verschlüsselte Parameter zum Stornieren einer Amazon-Pay-Zahlung

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Key	Format	CND	Description	Beschreibung
Code	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
chargeid	ans..256	M	Amazon Pay Charge ID	Amazon Pay Charge ID
chargepermissionid	ans..256	M	Amazon Pay Permission ID	Amazon Pay Permission ID

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Antwort-Parameter nach Stornierung einer Amazon-Pay-Zahlung

Space shortcuts

Page tree

Über Amazon Pay

Allgemeines zu Amazon Pay

Das Checkout-Erlebnis von Amazon Pay

Auf dieser Seite

Konfiguration für Amazon Pay

Bestehende Kunden

Neuer Kunde

MWS Autorisierungs-Token

Anleitung

Anleitung zum Erzeugen von API-Schlüsseln

Benachrichtigungs-URL

Schritte im Ablauf

Wichtig

Schaltfläche Amazon Pay integrieren

Review Page

Review Page Beispiel

Computop Data

JS Beispiel

Betrag aktualisieren

Diagrammm zum Prozessablauf

Nachfolgende wiederkehrende Zahlungen

Nachfolgende Aktionen

Buchung einer Zahlung

Gutschrift einer Zahlung

Storno einer Bestellung

Paygate-Schnittstelle

Definitionen

Amazon Pay Schnittstelle initialisieren

Zwischenantwort mit zusätzlichen Parametern der Schaltfläche

Zwischenantwort mit Kundeninformationen an Ihre ShopUrl

Amazon Pay Zahlung buchen

Amazon Pay Zahlung gutschreiben

Amazon Pay Bestellung stornieren

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Amazon Pay Checkout v2

Über Amazon Pay

Allgemeines zu Amazon Pay

Das Checkout-Erlebnis von Amazon Pay

Auf dieser Seite

Konfiguration für Amazon Pay

Bestehende Kunden

Neuer Kunde

MWS Autorisierungs-Token

Anleitung

Anleitung zum Erzeugen von API-Schlüsseln

Benachrichtigungs-URL

Schritte im Ablauf

Wichtig

Schaltfläche Amazon Pay integrieren

Review Page

Review Page Beispiel

Computop Data

JS Beispiel

Betrag aktualisieren

Diagrammm zum Prozessablauf

Nachfolgende wiederkehrende Zahlungen

Nachfolgende Aktionen

Buchung einer Zahlung

Gutschrift einer Zahlung

Storno einer Bestellung

Paygate-Schnittstelle

Definitionen

Amazon Pay Schnittstelle initialisieren

Zwischenantwort mit zusätzlichen Parametern der Schaltfläche

Zwischenantwort mit Kundeninformationen an Ihre ShopUrl

Amazon Pay Zahlung buchen

Amazon Pay Zahlung gutschreiben

Amazon Pay Bestellung stornieren