Search

Skip to end of metadata
Go to start of metadata

Über Amazon Pay

Allgemeines zu Amazon Pay

Die Abwicklung von Zahlungen mit Amazon Pay (APA= Amazon Pay Advanced; LPA= Login and Pay with Amazon) bedingt das korrekte, zeitlich aufeinander abgestimmte Zusammenspiel mehrerer, getrennt voneinander arbeitender Systeme.

Für Sie als Händler ist zum Initiieren einer Zahlung bzw. eines Logins mit Amazon immer eine direkte Interaktion mit Amazon nötig. Dazu muss ein von Amazon bereitgestelltes Button-Widget korrekt in Ihrem Shop eingebunden werden.

Informationen aus der ersten, direkten Interaktion mit dem Amazon-Widgets werden im Folgeschritt an das Computop Paygate übermittelt. Computop Paygate übernimmt danach die Folgeaktionen des Vorgangs in einer direkten Kommunikation mit den Systemen von Amazon. Das Computop Paygate gibt alle Antworten der Amazon-Systeme an Ihre Systeme (z.B. Shop und ERP) zurück.

Bitte konsultieren Sie während der Konzeption zur Implementierung von Amazon Pay den Computop Helpdesk. Nur wenn alle Prozessschritte korrekt aufeinander abgestimmt sind, ist eine funktionale Schnittstelle gewährleistet.

Dieses Handbuch beschreibt die Grundlagen zur Einrichtung und Nutzung der Computop-Schnittstelle für Amazon Pay sowie:

  • die Parameter der Schnittstelle
  • die Batch-Nutzung der Schnittstelle


Logo

Info

“Amazon Pay und Login mit Amazon” ist ein kompletter Checkout- und Payment-Service. Er erlaubt Millionen von Amazon-Kunden, ihre Einkäufe durch Nutzung ihres Amazon-Kontos zu erledigen, ohne die Webseite des besuchten Online-Shops zu verlassen. Die A-Z-Garantie von Amazon sorgt dabei für umfassenden Schutz.

TypZahlungen per eWallet


Weitere Informationen finden Sie auch auf der Webseite von Amazon Pay.

Auf dieser Seite


Konfiguration für Amazon Pay

Vor der Nutzung von Amazon Pay registrieren Sie sich unter https://pay.amazon.com/de/signup. Auf dieser Seite richten Sie die Benachrichtigungs-URL ein. Folgen Sie dafür den Menüs Einstellungen – Integrationseinstellungen – Sofortbenachrichtigungs-Einstellungen – Ändern. Tragen Sie dort die Computop Integrator URL https://www.computop-paygate.com/AmazonAPANotify.aspx ein und speichern diese.

Im zweiten Schritt generieren Sie ein MWS Auth Token. Dazu öffnen Sie die Webseite https://developer.amazonservices.de/gp/mws/registration/register.html und geben dort folgende Computop-Kennungen ein:

Entwicklername: Computop GmbH
Entwickler-Kontonummer: 0143-6461-8727

Das abschließende erhaltene MWS Authorisation Token übermitteln Sie auf einem sicheren Wege an den Computop Helpdesk für die Einrichtung.


Schritte im Ablauf

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

Schritt

Beschreibung

Button-Widget anzeigen

Das Button-Widget von Amazon muss auf der Seite des Webshops korrekt eingebunden und für jeden Bezahl-/Login-Vorgang aufgerufen werden. Anschließend erfolgt ein Redirect von Amazon. Im Redirect werden Daten (AccessToken, TokenType, Expiry, Scope) von Amazon geliefert.

Zahlung via Computop Paygate (Server to Server) initialisieren

Mit den von Amazon gelieferten Daten aus dem Button-Widget (AccessToken, TokenType, Expiry, Scope) wird nun der Zahlvorgang über das Computop Paygate initiiert. Verwenden Sie hierzu den Eventtoken LGN. Als Rückgabeparameter erhalten Sie (je nach Scope) Kundeninformationen wie E-Mail-Adresse und UserID (Eindeutige ID des Amazon-Kontos). Mit diesen Informationen können Sie den Benutzer eindeutig zuordnen und mit Ihren Daten abgleichen.

Adress- und Wallet-Widgets laden und anzeigen

Beide Widgets müssen direkt in den Shop integriert werden. Die Widgets kommunizieren direkt mit ihrem Shop.

Es empfiehlt sich, zuerst das Adress-Widget zu laden, die „OrderReferenceID“ (vom Adress-Widget erzeugte OrderReferenceId – per JavaScript mittels „orderReference.getAmazonOrderReferenceId()“ auszulesen) zwischenzuspeichern und sofort einen Aufruf der AmazonAPA.aspx mit dem Eventtoken „SOD“ und der „orderReferenceID“ über das Computop Paygate auszuführen. Als Rückgabe erhalten Sie je nach "Scope" Lieferdaten wie Stadt, Land und Postleitzahl und können damit Standard-Versandkosten berechnen.

Somit zeigt das Wallet-Widget nur für diese Bestellung zulässige Zahlarten an.

Jede Änderung der Versandadresse (wenn der Kunde im Widget also eine andere Versandanschrift als die Standardadresse auswählt) bedingt ein „OnAddressSelect“ – auf welches Ihre Systeme reagieren müssen.

Neue Versandinformationen abfragen

Nach einem „OnAddressSelect“ muss via Computop Paygate ein weiterer Aufruf der AmazonAPA.aspx mit dem Eventtoken „GOD“ ausgeführt werden. In der Antwort erhalten Sie Informationen zur neu gewählten Versandadresse (nur bei Scope=payments:shipping_address, um die Versandkosten z.B. neu zu berechnen).

Führen Sie nun einen Aufruf der AmazonAPA.aspx mit dem Eventtoken SOD aus, um den etwaigen neuen Gesamtbetrag der Bestellung zu übergeben.

Kauf abschließen

Die Bestätigung des Einkaufs erfolgt ebenfalls via Computop Paygate mit wahlweise einem von zwei Eventtoken – „SCO“ „SetOrderDetails and ConfirmOrder“oder „COD“ „ConfirmOrderDetails“.

Der Aufruf mit dem Eventtoken „SCO“ ist vorzuziehen, bedingt er doch eine Vereinfachung der Folgeschritte durch die automatische Lieferung der finalen Lieferadresse (mit allen Adressdetails).

Dennoch sollte nach dem Erhalt der Antwort auf den Abschluss der Bestellung ein weiterer Aufruf der AmazonAPA.aspx mit Eventtoken „GOD“ erfolgen, um etwaige Lieferadressänderungen sofort mitzubekommen.

Nach dem Abschließen der Bestellung besteht noch kein Zahlungsanspruch gegenüber dem Kunden. Im Folgenden müssen von Ihren Systemen noch Autorisierungen und Buchungen (Captures) durchgeführt werden.

Bestätigungs-Ablauf

Wegen der Multifaktor-Authentisierung ist es nach erfolgreicher Bestätigung einer Bestellung nötig, einen neuen Javascript-Aufruf zu starten, den ConfirmationFlow. Damit kann Amazon Pay die Multifaktor-Authentisierung erledigen, sofern erforderlich.

Die für die Multifaktor-Authentisierung (MFA) erforderlichen Änderungen betreffen nur die Amazon-Plattformen für EUR und UK.

Autorisierung

Die Autorisierung des Zahlbetrages muss innerhalb von 180 Tagen erfolgen. Autorisierungen sind immer 30 Tage gültig und verfallen dann. Nach Verfall kann der Zahlbetrag neu autorisiert werden (innerhalb von 180 Tagen ab Bestellung).

Als Antwort auf eine Autorisierung mit Amazon erhalten Sie einen eindeutigen Paygate-Parameter „XID“ zurück. Bei diesem Parameter handelt sich um eine Sub-Vorgangsnummer, die im Paygate eindeutig mit einer „PayID“ verknüpft ist. Bitte stellen Sie sicher, dass dieser Parameter bei Ihnen am Vorgang abgespeichert wird. Ohne zugehörige „XID“ können keine Folgetransaktionen wie Capture oder Gutschrift ausgeführt werden. Buchungen und Gutschriften müssen sich bei Amazon immer eindeutig auf eine Autorisierung bzw. Buchung referenzieren (Autorisierung „blauer Pullover“, Buchung „blauer Pullover“, Gutschrift „blauer Pullover“).

Auf eine angelegte Amazon-Order können gleichzeitig zehn Autorisierungen eingereicht werden. Maximal können 50 Autorisierungen pro Order-Lebenszyklus eingereicht werden.

Besonderheit bei Autorisierungen mit Amazon:

Es gibt zwei unterschiedliche Autorisierungstypen: Synchrone und asynchrone Autorisierungen.

Synchrone Autorisierungen liefern immer sofort eine klare Aussage über den Ausgang der Autorisierung zurück, also ein OK oder FAILED.

Asynchrone Autorisierungen haben ein Notify zur Folge, welches nach einem bestimmbaren Maximalzeitraum eine Information über den Ausgang der Autorisierung gibt (das Notify kann jedoch schon früher eintreffen).

Der maximale Zeitraum zwischen Einreichung der Autorisierung und der spätesten Statusmeldung per Notify kann pro Paygate MID konfiguriert werden (in Minuten, Mehrfache von 5, maximal 1440 Minuten – Einstellung von 0 bedeutet synchrone Autorisierung).

Buchung

Autorisierungen können innerhalb von sieben Tagen ab Zeitpunkt der Autorisierung synchron gebucht werden. Das bedeutet, die Buchung erhält sofort ein „OK“ von Amazon. Nach sieben bis 30 Tagen ab Autorisierung erfolgen Buchungen asynchron und ziehen ein Notify an Ihre Notify-URL nach sich (gleichzeitig werden erweiterte Risikoprüfungen bei Amazon angestoßen). Bitte stellen Sie sicher, erst nach Erhalt des Notify mit der Auslieferung zu beginnen. Auf eine Autorisierung kann eine Buchung (Capture) ≤ Autorisierungsbetrag eingereicht werden. Für eine Buchung muss die „XID“ der zugrundeliegenden Autorisierung an das Computop Paygate übergeben werden. Buchungen ohne XID scheitern.

Wenn eine Buchung < Autorisierung eingereicht wurde, kann der Differenzbetrag sofort neu autorisiert werden. Das Computop Paygate übernimmt nicht automatisch die Neuautorisierung des Differenzbetrags.

Bestellvorgang nach erfolgter Auslieferung abschließen

Nach Abschluss des Bestellprozesses (z.B. nach Versand des letzten Artikels oder nach erfolgreicher letzter Buchung) empfiehlt es sich, den Vorgang bei Amazon zu schließen. Wird der Vorgang nicht geschlossen, sieht ihr Kunde immer eine offene Bestellung in seinem Backend von Amazon Pay. Nutzen Sie dazu bitte den Eventtoken „COR“. Nach Schließen des Vorgangs sind weiterhin Buchungen auf offene Autorisierungen und Gutschriften möglich – jedoch keine weitere Autorisierungen zu einem Bestellvorgang.

Schließen einer Autorisierung

Wenn es sicher ist, dass ein Artikel nicht mehr lieferbar ist (oder nicht geliefert werden muss) können bestehende, zur Buchung ausstehende Autorisierungen geschlossen werden. Nutzen sie hierfür den Eventtoken „RAN“.

Gutschriften

Gutschriften können laut Amazon zeitlich unbegrenzt eingereicht werden. Seitens von Computop besteht diese Möglichkeit maximal ein Jahr lang. Für eine Gutschrift muss die „XID“ der zugrundeliegenden Buchung an das Computop Paygate übergeben werden. Gutschriften ohne XID scheitern. Es sind bis zu 10 Gutschriften pro Buchung möglich.


Button-Widget einbinden

Folgender Beispielcode gibt an, wie das Button-Widget eingebunden werden kann:

<div id="AmazonPayButton"/>
<script type="text/javascript">
  var authRequest;
  OffAmazonPayments.Button("AmazonPayButton", "YOUR_SELLER_ID ", {
    type:  "ENTER_TYPE_PARAMETER",
    color: "ENTER_COLOR_PARAMETER",
    size:  "ENTER_SIZE_PARAMETER",
    language: "ENTER_LANGUAGE_PARAMETER",
    authorization: function() {
      loginOptions = {scope: "ENTER_SCOPES", popup: "ENTER_POPUP_PARAMETER"};            
      authRequest = amazon.Login.authorize (loginOptions, "YOUR_REDIRECT_URL ");
    },
    onError: function(error) {
      // your error handling code
    }
  });
</script>


Hinweis: Da Computop keinen Einfluss auf den Code der Widgets hat, empfehlen wir Ihnen, sich an der Dokumentation von Amazon Pay zu orientieren.

Dabei müssen folgende Parameter innerhalb des Widgets ausgefüllt werden:

Parameter

Beschreibung

Wert

YOUR_SELLER_ID

Von Amazon vergebene SellerId

 

Type

Der Type Parameter ist ein optionaler Parameter zur Definition des Button-Layouts des Button-Widgets.


Zulässige Werte:

LwA, Login, PwA,

Pay, A

Color

Der Parameter Color steuert die Farbe des Button-Widgets.

Zulässige Werte:

Gold, LightGray, DarkGray

Size

Der Parameter Size definiert die Größe des Button-Widgets.



Zulässige Werte bei normaler Display-Auflösung:

small, medium


Zulässige Werte für Retina Displays:

large, x-large

Language

Der Parameter Language dient optional zur Definition der Sprache des Checkout-Vorgangs. Er ist besonders in einer multilingualen Shop-Umgebung hilfreich.

Ohne Übergabe des Parameters Language wird von Amazon automatisch die am besten passende Sprache im Checkout gesetzt.

Zulässige Werte:

en-GB, de-DE, fr-FR, it-IT, es-ES

Scope

Der Parameter Scope definiert den Umfang der Return-Parameter nach dem Login des Kunden sowie die Inhalte der Einverständniserklärung des Kunden.

Beispiel: scope=payments:shipping_address liefert die Versandadresse des Käufers zurück.

Zulässige Werte:

profile, profil:user_id, payments:widget, pay-ments:shipping_address, pay-ments:billing_address


Weitere Informationen finden Sie in der Dokumentation von Amazon Pay.


Adressbuch- und Wallet-Widget einbinden

Folgender Beispielcode gibt an, wie das Adressbuch-Widget eingebunden werden kann:

<div id="addressBookWidgetDiv">
</div>
<script>
new OffAmazonPayments.Widgets.AddressBook({
  sellerId: 'YOUR_SELLER_ID_HERE',
  onOrderReferenceCreate: function(orderReference) {
    orderReference.getAmazonOrderReferenceId();
    // Send SetOrderDetails Request with OrderReferenceId to Computop to    
    // set the amount and get the default address    
  },
  onAddressSelect: function(orderReference) {
    // Send GetOrderDetails Request to get the selected address
  },
  design: {
    designmode: 'responsive'
  },
  onError: function(error) {
    // your error handling code
  }      
}).bind("addressBookWidgetDiv");
</script>


Folgender Beispielcode gibt an, wie das Wallet-Widget eingebunden werden kann:

<div id="walletWidgetDiv">

</div>
<script>
new OffAmazonPayments.Widgets.Wallet({
  sellerId: 'YOUR_SELLER_ID_HERE',
  onPaymentSelect: function(orderReference) {
    // Replace this code with the action that you want to perform
    // after the payment method is selected.
  },
  design: {
    designMode: 'responsive'
  },
  onError: function(error) {
    // your error handling code
  }
}).bind("walletWidgetDiv");
</script>


Die Option zur Abmeldung ist zumeist ein Link, um alle Benutzerinformationen von der Webseite zu entfernen und danach wieder die Anmeldung mittels der Methode amazon.Login.logout() anzuzeigen. Verwenden Sie dafür folgenden Code:

<script type="text/javascript">
  document.getElementById('Logout').onclick = function() {
    amazon.Login.logout();
  };
</script>


Weitere Informationen finden Sie in der Dokumentation von Amazon Pay.


Javascript für Bestätigungsablauf

Wegen der Multi-Faktor-Authentisierung ist es nach einer erfolgreiche Bestätigung einer Bestellung erforderlich, einen neuen Aufruf zu starten, den ConfirmationFlow.

Folgender Beispielcode gibt an, wie die Javascript-Funktion dafür eingebunden werden kann:

Function confirmationFlow()
{
    // Get the ResultCode from Computop Call AmazonAPA.aspx EventToken: COR
    var resultCode_Computop = callComputopAmazonAPA_Confirmation();
    // Your AmazonSellerID / AmazonMerchantID
    var amazonSellerId = ‚ABCDEFG123456‘;
    // AmazonOrderReferenceID generated by AdressWidget
    var orderReferenceId = ‚P02-1234567-1234567‘;
    // Initiate Conformation Flow
    OffAmazonPayments.initConfirmationFlow(amazonSellerId, orderReferenceId, function (confirmationFlow) {
        if(resultCode_Computop = ‚00000000‘)
        {
            // Do confirmationFlow with Success Confirm
            confirmationFlow.success();
        }
        else
        {
            // Do confirmationFlow with Failured Confirm
            confirmationFlow.error();
        }
    });
}



Verfügbare Event-Token

Für Amazon Pay gibt es zahlreiche mögliche Aktionen, deren Auswahl an der Schnittstelle über den Parameter EventToken gesteuert wird.

Folgende Tabelle gibt eine Übersicht der möglichen Eventtoken für AmazonAPA.aspx:

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

The table is being loaded. Please wait for a bit ...

EventToken

Action

Description

Beschreibung

LGN

Login

Initializing of a payment/login-process with Amazon via Computop Paygate

Initialisierung einer Zahlung/eines Login-Vorgangs mit Amazon über Computop Paygate

SOD

SetOrderDetails

Transfer of amount payable and further information – controls also the payment methods selectable for an order at Amazon

Übergabe des Zahlbetrags und weiterer Informationen – steuert auch die für eine Bestellung wählbaren Zahlarten bei Amazon

SCO

SetOrderDetailsAndConfirmOrder

Order confirmation again with transfer of amount payable and further information – with this Eventtoken the order is finalized. After successfully confirmation authorizations can be submitted to Amazon immediately.

Bestätigung der Bestellung mit nochmaliger Übergabe des Zahlbetrags und weiterer Informationen – durch dieses Eventtoken wird die Bestellung abgeschlossen, und es können bei erfolgreicher Bestätigung sofort Autorisierungen an Amazon eingereicht werden

COD

ConfirmOrderDetails

Optional, if amount payable and further information should not transferred once more for order confirmation (Computop recommends using the Eventtoken SCO for order confirmation.)

Optional, wenn zur Bestellbestätigung nicht nochmals die Übergabe von Zahlbetrag und weiteren Informationen erfolgen soll (Computop empfiehlt die Nutzung des Eventtoken SCO für die Bestellbestätigung)

GOD

GetOrderDetails

Request of order information, e.g. to get information about a newly selected delivery address. After a call with Eventtoken COD or SCO, GOD returns also the billing address oft he customer

When Scope enters “payments:shipping_address” and “payments:billing_address” you receive the full delivery and shipping address after the display of the Address widget. Please transfer the OrderReferenceId on call up.

Abfrage der Order-Informationen, um z.B. Informationen über eine neu gewählte Lieferadresse zu erhalten. Nach einem Aufruf mit Eventtoken COD oder SCO liefert GOD auch die Rechnungsadresse des Kunden zurück.

Bei Angabe von Scope „payments:shipping_address“ und “payments:billing_address” erhalten Sie die vollständige Liefer- und Versandadresse bereits nach Anzeige des Adress-Widgets. Übergeben Sie hierzu beim Aufruf bitte die OrderReferenceId.

ATH

Authorize

Eventtoken for authorization

Eventtoken für die Autorisierung

COR

CloseOrderReference

Closing an Amazon order. Captures related to open authorizations as well as credits are possible furthermore.

Schließen einer Order bei Amazon. Es sind weiterhin Buchungen auf offene Autorisierungen und Gutschriften möglich.

RAN

ReverseAuthorization

Closing an open authorization

Schließen einer offenen Autorisierung

ATD

AuthorizeDetails

Status request for an authorization

Statusabfrage einer Autorisierung

CAD

CaptureDetails

Status request for an capture

Statusabfrage einer Buchung (Capture)

CRD

CreditDetails

Status request for an credit

Statusabfrage einer Gutschrift (Credit)


Diagramm zum Prozessablauf

conditio

draw.io

Source page access restriction: Click the link below to check if the page is accessible.
/display/DEWORK/Amazon+Pay

Process flow for Amazon Pay within Paygate

Prozessablauf für Multi-Faktor Authentisierung

Diese Aktion sollte durch Klicken der Schaltfläche "Buy Now" ausgelöst werden. Wenn eine MFA erforderlich ist, zeigt der Bestätigungsablauf (siehe Javascript oben) dem Käufer die MFA-Challenge des Kreditkartenherausgebers an. Nachdem der Käufer mit dem Bestätigungsablauf interagiert hat (zum Beispiel die MFA-Challange abgeschlossen hat), wird der Käufer zur Webseite des Händlers zurückgeleitet (zum Beispiel auf die Seite der Bestellbestätigung). Der Händler sollte die Weiterleitung (URLSuccess / URLFailure) mit dem Ergebnis der MFA-Challenge handhaben können.

Falls der amazonstatus=Success ist, wird der Kauf abgeschlossen. Falls der amazonstatus=Failure oder amazonStatus=Abandoned ist, wird der Kunde auf die Seite URLFailure weitergeleitet und der Händler sollte die Bestellung durch Aufruf der reverse,aspx stornieren (siehe unten im Kapitel "Amazon Pay Order stornieren"). Der Kunde kann weitergeleitet werden, um eine andere Zahlungsart auszuwählen oder im Falle von Abandoned die Bestellung zu ersetzen und die MFA-Challange abzuschließen.

Anstelle der Ein-Schritt-Lösung mit dem EventToken=SCO kann der Prozess auch aufgeteilt werden in EventToken=SOD und EventToken=COD, gefolgt vom Bestätigungsablauf (Confirmation Flow).

Process flow for Multi-factor authentication with Amazon Pay (amazonstatus=Success)

Process flow for failed Multi-factor authentication with Amazon Pay (amazonstatus=Failure or Abandoned)


Paygate-Schnittstelle

Definitionen

Datenformate:

FormatBeschreibung

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ürzungBeschreibungKommentar

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.


Schnittstelle Amazon Pay initialisieren

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


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

CountryCode

an2

M

Country code of used marketplace. Presently only DE and GB permitted.

Länderkennung des genutzten Marketplace. Derzeit nur DE und GB erlaubt.

URLNotify

ans..256

C

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.
Optional if an URLNotify is permanently defined at the Paygate.

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.

Optional, wenn eine URLNotify am Paygate fest definiert ist.

AccessToken

a..512

M

Parameter „access_token“ which is transferred during the redirect from Amazon after the customer has logged in. Used to request the full delivery address during the checkout process.

Important: It can be used only, if for Scope is given at least „payments:shipping_address“ within the button widget.

Parameter „access_token“, der beim Redirect von Amazon nach Login durch den Kunden übermittelt wird. Dient der Abfrage der vollständigen Lieferadresse bereits während des Checkout-Prozesses.

Wichtig: Kann nur verwendet werden, wenn im Button-Widget als Scope mindestens „payments:shipping_address“ angegeben ist.

TokenType

ans..6

M

Parameter „token_type“ which is transferred during the redirect from Amazon after the customer has logged in.

Parameter „token_type“, der beim Redirect von Amazon nach Login durch den Kunden übermittelt wird.

Expiry

n..4

M

Parameter „expires_in“ which is transferred during the redirect from Amazon after the customer has logged in.

Parameter „expires_in“, der beim Redirect von Amazon nach Login durch den Kunden übermittelt wird.

Scope

a..128

M

Parameter „scope“ which is transferred during the redirect from Amazon after the customer has logged in.

Important: Within the button widget use at least the values „profile payments:widget and payments:shipping_address“.

Parameter „scope“, der beim Redirect von Amazon nach Login durch den Kunden übermittelt wird.

Wichtig: Verwenden Sie im Button-Widget mindestens die Werte „profile payments:widget payments:shipping_address“.

EventToken

enum

M

Abbreviation of the action to be done:

<LGN> = Login

Abkürzung der auszuführenden Aktion

<LGN> = Login

OrderDesc

ans..127

O

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.

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


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

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

(Info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
KeyFormatCNDShipping informationVersandinformationen

UserID

as..64

O

part of the userprofile information. Unique ID issued by Amazon per user.

Teil der Benutzerprofil-Informationen. Eindeutige von Amazon pro User vergebene ID.

BuyerName

as..50

O

part of the userprofile information. User name

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

part of the userprofile information. E-mail address

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrZip

as..128

O

part of the userprofile information. Postcode in the standard delivery address

Teil der Benutzerprofil-Informationen. Postleitzahl der Standard-Lieferadresse

Antwort-Parameter nach Initialisierung einer Amazon-Pay-Zahlung



Amazon Pay Order-Details festlegen

Um die Order-Details einer Zahlung mit Amazon Pay mit der Funktion „SetOrderDetails“ festzulegen, rufen Sie bitte folgende URL auf:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

OrderDesc

ans..127

M

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise etc.

OrderReferenceID

ans..19

O

OrderReferenceId generated by button widget or by address widget which is read out via JavaScript using „OrderReference.getAmazonOrderReferenceId()“

Vom Button-Widget oder Adress-Widget erzeugte OrderReferenceId, die per JavaScript mittels „orderReference.getAmazonOrderReferenceId()“ ausgelesen wird

StoreName

ans..1024

O

Name of the shop. Is printed in email to customer.

Name des Shops. Wird in E-Mail an Kunden abgedruckt.

EventToken

enum

M

Abbreviation of the action to be done:

<SOD> = SetOrderDetails

<SCO> = SetOrderDetailsAndConfirmOrder

Abkürzung der auszuführenden Aktion

<SOD> = SetOrderDetails

<SCO> = SetOrderDetailsAndConfirmOrder

URLSuccessans..256MThe buyer is redirected to this URL if the Multi Factor Authentication is successful.Der Käufer wird zu dieser URL weitergeleitet, wenn die Multi-Faktor-Authentisierung erfolgreich war.
URLFailureans..256OThe buyer is redirected to this URL if the Multi Factor Authentication is unsuccessful.Der Käufer wird zu dieser URL weitergeleitet, wenn die Multi-Faktor-Authentisierung nicht erfolgreich war.
AuthorizationAmountn..10O

The amount to authenticate during Multi Factor Authentication completion.

Use this parameter if you want to set a payment amount that is different than the OrderTotal provided in the SetOrderReferenceDetails operation call.

If this parameter is not set, the amount authenticated during Multi Factor Authentication will be equal to the OrderTotal provided in the SetOrderReferenceDetails operation call.

Der während der Multi-Faktor-Authentisierung zu authentisierende Betrag.

Verwenden Sie diesen Parameter, wenn Sie einen vom Wert in OrderTotal beim Aufruf von SetOrderReferenceDetails abweichenden Zahlungsbetrag festlegen wollen.

Wenn dieser Parameter nicht gesetzt wird, ist der bei der Multi-Faktor-Authentisierung authentisierte Betrag gleich dem Wert von OrderTotal aus dem Aufruf von SetOrderReferenceDetails.

KeyFormatCNDDescriptionBeschreibung
Plain

ans..50

O

A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. 

"Plain"-parameter is part of encrypted "Data" in Computop Paygateand therefore protected against manipulation. 

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt. 

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the Computop Paygate response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate Aufruf. Dadurch ist der Wert gegen Manipulation geschützt. 

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Verschlüsselte Parameter zum Aufruf SetOrderDetails und SetOrderDetailsAndConfirmOrder zu einer Amazon-Pay-Zahlung


Hinweis: Sie können den Aufruf SetOrderDetails und ConfirmOrderDetails zusammenfassen, indem Sie als EventToken <SCO> SetOrderDetailsAndConfirmOrder verwenden.


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

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

(Info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

KeyFormatCNDDescriptionBeschreibung
Plain

ans..50

O

A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. 

"Plain"-parameter is part of encrypted "Data" in Computop Paygateand therefore protected against manipulation. 

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt. 

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the Computop Paygate response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate Aufruf. Dadurch ist der Wert gegen Manipulation geschützt. 

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Key

Format

CND

Description

Beschreibung
KeyFormatCNDShipping informationVersandinformationen

BuyerName

a..50

O

part of the userprofile information. User name

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

part of the userprofile information. E-mail address

Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrNamea..50OFirst name and surname of addresseeVorname und Nachname des Adressaten
PhoneNumbera..128OPhone number of addresseeTelefonnummer des Adressaten
AddrCountryCodea2OCountry code of delivery country according to ISO 3166Ländercode des Lieferlandes gemäß ISO 3166
AddrStatea..50OFederal state of the delivery addressBundesland der Lieferadresse
AddrCountya..50OCounty of delivery addressLandkreis der Lieferadresse
AddrDistricta..50ODistrict of delivery addressBezirk der Lieferadresse

AddrZip

a..20

O

Postcode in the delivery address

Postleitzahl der Lieferadresse
AddrCitya..50OTown/city in the delivery addressOrtsname der Lieferadresse
AddrStreeta..180OCompany name (if given) or street name and street numberFirmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2a..60OStreet name and house numberStraßenname mit Hausnummer
AddrStreet3a..60OOther additionsSonstige Zusätze

Antwort-Parameter nach SetOrderDetails und SetOrderDetailsAndConfirmOrder einer Amazon-Pay-Zahlung



Amazon Pay Order-Details abfragen

Um die Order-Details einer Zahlung mit Amazon Pay mit der Funktion „GetOrderDetails“ abzufragen, rufen Sie bitte folgende URL auf:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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

EventToken

enum

M

Abbreviation of the action to be done:

<GOD> = GetOrderDetails

Abkürzung der auszuführenden Aktion

<GOD> = GetOrderDetails

OrderReferenceIDans..19OIf not already submitted for <SOD> SetOrderDetailsFalls noch nicht bei <SOD> SetOrderDetails übergeben

OrderDesc

ans..127

O

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.

Verschlüsselte Parameter zum Aufruf GetOrderDetails zu einer Amazon-Pay-Zahlung


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

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

(Info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
KeyFormatCNDShipping informationVersandinformationen

BuyerName

a..50

O

part of the userprofile information. User name

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

part of the userprofile information. E-mail address

Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrNamea..50OFirst name and surname of addresseeVorname und Nachname des Adressaten
PhoneNumbera..128OPhone number of addresseeTelefonnummer des Adressaten
AddrCountryCodea2OCountry code of delivery country according to ISO 3166Ländercode des Lieferlandes gemäß ISO 3166
AddrStatea..50OFederal state of the delivery addressBundesland der Lieferadresse
AddrCountya..50OCounty of delivery addressLandkreis der Lieferadresse
AddrDistricta..50ODistrict of delivery addressBezirk der Lieferadresse

AddrZip

a..20

O

Postcode in the delivery address

Postleitzahl der Lieferadresse
AddrCitya..50OTown/city in the delivery addressOrtsname der Lieferadresse
AddrStreeta..180OCompany name (if given) or street name and street numberFirmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2a..60OStreet name and house numberStraßenname mit Hausnummer
AddrStreet3a..60OOther additionsSonstige Zusätze
KeyFormatCNDBilling address (only for Scope="payments:billing_address")Rechnungsadresse (nur bei Scope="payments:billing_address")

bdAddrName

a..50

O

First name and surname of addressee in the billing address

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

a..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of the billing country according to ISO 3166

Ländercode des Rechnungslandes gemäß ISO 3166

bdAddrState

a..50

O

Federal state in the invoicing address

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

County of billing address

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

District of billing address

Bezirk der Rechnungsadresse

bdAddrZip

a..20

O

Postcode in the invoicing address

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Name of town/city in the billing address

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

Company name (if given) or street name and street number in the billing address

Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet2

a..60

O

Street name and street number in the billing address

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

Other additions in the billing address

Sonstige Zusätze der Rechnungsadresse

Antwort-Parameter nach GetOrderDetails einer Amazon-Pay-Zahlung



Amazon Pay Order-Details bestätigen

Um die Order-Details einer Zahlung mit Amazon Pay mit der Funktion „ConfirmOrderDetails“ zu bestätigen, rufen Sie bitte folgende URL auf:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

EventToken

a3

M

Abbreviation of the action to be done: <COD> = ConfirmOrderDetails

Abkürzung der auszuführenden Aktion: <COD> = ConfirmOrderDetails
URLSuccessans..256MThe buyer is redirected to this URL if the Multi Factor Authentication is successful.Der Käufer wird zu dieser URL weitergeleitet, wenn die Multi-Faktor-Authentisierung erfolgreich war.
URLFailureans..256OThe buyer is redirected to this URL if the Multi Factor Authentication is unsuccessful.Der Käufer wird zu dieser URL weitergeleitet, wenn die Multi-Faktor-Authentisierung nicht erfolgreich war.
URLNotifyans..256M

Complete URL which Computop 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.

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.

AuthorizationAmountn..10O

The amount to authenticate during Multi Factor Authentication completion.

Use this parameter if you want to set a payment amount that is different than the OrderTotal provided in the SetOrderReferenceDetails operation call.

If this parameter is not set, the amount authenticated during Multi Factor Authentication will be equal to the OrderTotal provided in the SetOrderReferenceDetails operation call.

Der während der Multi-Faktor-Authentisierung zu authentisierende Betrag.

Verwenden Sie diesen Parameter, wenn Sie einen vom Wert in OrderTotal beim Aufruf von SetOrderReferenceDetails abweichenden Zahlungsbetrag festlegen wollen.

Wenn dieser Parameter nicht gesetzt wird, ist der bei der Multi-Faktor-Authentisierung authentisierte Betrag gleich dem Wert von OrderTotal aus dem Aufruf von SetOrderReferenceDetails.

KeyFormatCNDDescriptionBeschreibung
Plain

ans..50

O

A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. 

"Plain"-parameter is part of encrypted "Data" in Computop Paygateand therefore protected against manipulation. 

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt. 

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the Computop Paygate response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate Aufruf. Dadurch ist der Wert gegen Manipulation geschützt. 

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Verschlüsselte Parameter zum Aufruf ConfirmOrderDetails zu einer Amazon-Pay-Zahlung


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

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

(Info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

KeyFormatCNDDescriptionBeschreibung
Plain

ans..50

O

A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. 

"Plain"-parameter is part of encrypted "Data" in Computop Paygateand therefore protected against manipulation. 

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt. 

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the Computop Paygate response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate Aufruf. Dadurch ist der Wert gegen Manipulation geschützt. 

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Key

Format

CND

Description

Beschreibung
KeyFormatCNDShipping informationVersandinformationen

BuyerName

a..50

O

part of the userprofile information. User name

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

part of the userprofile information. E-mail address

Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrNamea..50OFirst name and surname of addresseeVorname und Nachname des Adressaten
PhoneNumbera..128OPhone number of addresseeTelefonnummer des Adressaten
AddrCountryCodea2OCountry code of delivery country according to ISO 3166Ländercode des Lieferlandes gemäß ISO 3166
AddrStatea..50OFederal state of the delivery addressBundesland der Lieferadresse
AddrCountya..50OCounty of delivery addressLandkreis der Lieferadresse
AddrDistricta..50ODistrict of delivery addressBezirk der Lieferadresse

AddrZip

a..20

O

Postcode in the delivery address

Postleitzahl der Lieferadresse
AddrCitya..50OTown/city in the delivery addressOrtsname der Lieferadresse
AddrStreeta..180OCompany name (if given) or street name and street numberFirmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2a..60OStreet name and house numberStraßenname mit Hausnummer
AddrStreet3a..60OOther additionsSonstige Zusätze
KeyFormatCNDBilling address (only for Scope="payments:billing_address")Rechnungsadresse (nur bei Scope="payments:billing_address")

bdAddrName

a..50

O

First name and surname of addressee in the billing address

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

a..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of the billing country according to ISO 3166

Ländercode des Rechnungslandes gemäß ISO 3166

bdAddrState

a..50

O

Federal state in the invoicing address

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

County of billing address

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

District of billing address

Bezirk der Rechnungsadresse

bdAddrZip

a..20

O

Postcode in the invoicing address

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Name of town/city in the billing address

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

Company name (if given) or street name and street number in the billing address

Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet2

a..60

O

Street name and street number in the billing address

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

Other additions in the billing address

Sonstige Zusätze der Rechnungsadresse

Antwort-Parameter nach ConfirmOrderDetails einer Amazon-Pay-Zahlung


Im Fehlerfall (bspw. falls Amazon die Zahlung ablehnt) erhalten Sie ein Notify an die angegebene URLNotify mit folgenden Parametern:

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

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
NotificationTypea..25MDescribes the type of notifcation. Fixed value: <OrderNotification>Beschreibt die Art der Benachrichtigung. Fester Wert: <OrderNotification>

KeyFormatCNDDescriptionBeschreibung
Plain

ans..50

O

A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. 

"Plain"-parameter is part of encrypted "Data" in Computop Paygateand therefore protected against manipulation. 

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt. 

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the Computop Paygate response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate Aufruf. Dadurch ist der Wert gegen Manipulation geschützt. 

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Antwort-Parameter an URLNotify nach ConfirmOrderDetails einer Amazon-Pay-Zahlung



Amazon Pay Autorisierung abschließen

Um eine Zahlung mit Amazon Pay zu autorisieren, rufen Sie bitte folgende URL auf:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
Capture

an..6

OM

Determines the type and time of capture.

Capture ModeDescription
AUTOCapturing immediately after authorisation (default value).
MANUALCapturing made by the merchant. Capture is normally initiated at time of delivery.
<Number>Delay in hours until the capture (whole number; 1 to 696).

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture).

BuchungsartBeschreibung
AUTOBuchung sofort nach Autorisierung (Standardwert).
MANUALBuchung erfolgt durch den Händler - in der Regel die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.
<Zahl>Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

Key

Format

CND

Description

Beschreibung

OrderDesc

ans..127

M

Description of purchased goods, unit prices etc. for authorization

Beschreibung der gekauften Waren, Einzelpreise etc. zur Autorisierung
ChDescans..16OText printed on the customer’s credit card bill alongside the payee (only for Capture=AUTO or Capture=<NUMBER>)Text der auf der Abrechnung des Kreditinstituts des Kunden erscheint (nur bei Capture=AUTO oder Capture=<ZAHL>)
EventTokenenumMAbbreviation of the action to be done: <ATH> = AuthorizeAbkürzung der auszuführenden Aktion: <ATH> = Authorize

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


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

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

(Info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefIDans..27MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Key

Format

CND

Description

Beschreibung
KeyFormatCNDShipping informationVersandinformationen

BuyerName

a..50

O

part of the userprofile information. User name

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

part of the userprofile information. E-mail address

Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrNamea..50OFirst name and surname of addresseeVorname und Nachname des Adressaten
PhoneNumbera..128OPhone number of addresseeTelefonnummer des Adressaten
AddrCountryCodea2OCountry code of delivery country according to ISO 3166Ländercode des Lieferlandes gemäß ISO 3166
AddrStatea..50OFederal state of the delivery addressBundesland der Lieferadresse
AddrCountya..50OCounty of delivery addressLandkreis der Lieferadresse
AddrDistricta..50ODistrict of delivery addressBezirk der Lieferadresse

AddrZip

a..20

O

Postcode in the delivery address

Postleitzahl der Lieferadresse
AddrCitya..50OTown/city in the delivery addressOrtsname der Lieferadresse
AddrStreeta..180OCompany name (if given) or street name and street numberFirmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2a..60OStreet name and house numberStraßenname mit Hausnummer
AddrStreet3a..60OOther additionsSonstige Zusätze
KeyFormatCNDInvoicing addressRechnungsadresse

bdAddrName

a..50

O

First name and surname of addressee in the billing address

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

a..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of the billing country according to ISO 3166

Ländercode des Rechnungslandes gemäß ISO 3166

bdAddrState

a..50

O

Federal state in the invoicing address

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

County of billing address

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

District of billing address

Bezirk der Rechnungsadresse

bdAddrZip

a..20

O

Postcode in the invoicing address

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Name of town/city in the billing address

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

Company name (if given) or street name and street number in the billing address

Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet2

a..60

O

Street name and street number in the billing address

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

Other additions in the billing address

Sonstige Zusätze der Rechnungsadresse

Antwort-Parameter nach Autorisierung einer Amazon-Pay-Zahlung


Nach einer Autorisierung erhalten Sie ein Notify an die angegebene URLNotify mit folgenden Parametern:

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

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefIDans..27MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Key

Format

CND

Description

Beschreibung
KeyFormatCNDShipping informationVersandinformationen

BuyerName

a..50

O

part of the userprofile information. User name

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

part of the userprofile information. E-mail address

Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrNamea..50OFirst name and surname of addresseeVorname und Nachname des Adressaten
PhoneNumbera..128OPhone number of addresseeTelefonnummer des Adressaten
AddrCountryCodea2OCountry code of delivery country according to ISO 3166Ländercode des Lieferlandes gemäß ISO 3166
AddrStatea..50OFederal state of the delivery addressBundesland der Lieferadresse
AddrCountya..50OCounty of delivery addressLandkreis der Lieferadresse
AddrDistricta..50ODistrict of delivery addressBezirk der Lieferadresse

AddrZip

a..20

O

Postcode in the delivery address

Postleitzahl der Lieferadresse
AddrCitya..50OTown/city in the delivery addressOrtsname der Lieferadresse
AddrStreeta..180OCompany name (if given) or street name and street numberFirmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2a..60OStreet name and house numberStraßenname mit Hausnummer
AddrStreet3a..60OOther additionsSonstige Zusätze
KeyFormatCNDInvoicing addressRechnungsadresse

bdAddrName

a..50

O

First name and surname of addressee in the billing address

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

a..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of the billing country according to ISO 3166

Ländercode des Rechnungslandes gemäß ISO 3166

bdAddrState

a..50

O

Federal state in the invoicing address

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

County of billing address

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

District of billing address

Bezirk der Rechnungsadresse

bdAddrZip

a..20

O

Postcode in the invoicing address

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Name of town/city in the billing address

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

Company name (if given) or street name and street number in the billing address

Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet2

a..60

O

Street name and street number in the billing address

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

Other additions in the billing address

Sonstige Zusätze der Rechnungsadresse

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



Amazon Pay Zahlung buchen

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


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
ChDescans..16OText printed on the customer’s credit card bill alongside the payeeText der auf der Abrechnung des Kreditinstituts des Kunden erscheint
OrderDescans..127MUse 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.

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments / actions, enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction / 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 / action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action. Submissions with identical ReqID for an open status will be processed regularly.

Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

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


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

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

(Info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

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


Nach einer Buchung erhalten Sie ein Notify 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefIDans..27MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
NotificationTypea..25MDescribes 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, rufen Sie bitte folgende URL auf:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
ChDescans..16OText printed on the customer’s credit card bill alongside the payeeText der auf der Abrechnung des Kreditinstituts des Kunden erscheint
OrderDescans..127MDescription of purchased goods, unit prices etc. for authorizationBeschreibung der gekauften Waren, Einzelpreise etc. zur Buchung

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments / actions, enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction / 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 / action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action. Submissions with identical ReqID for an open status will be processed regularly.

Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

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


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

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

(Info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

Key

Format

CND

Description

Beschreibung
Statusa..30MREQUEST (Because credits are not carried out real time, the status is always pending.)REQUEST (Da Gutschriften nicht in Echtzeit ausgeführt werden, ist der Status zunächst stets wartend.)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

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


Nach einer Gutschrift erhalten Sie ein Notify 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefIDans..27MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
NotificationTypea..25MDescribes 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 Order schließen

Um eine Order mit Amazon Pay mit der Funktion „CloseOrder“ zu schließen, rufen Sie bitte folgende URL auf:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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
EventTokenan3M

Abbreviation of the action to be done: <COR> = CloseOrderReference

Abkürzung der auszuführenden Aktion: <COR> = CloseOrderReference

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
OrderDescans..127MUse this parameter for the simulation mode. During live mode this parameter has no effects.Nutzen Sie diesen Parameter für den Simulationsmodus. ImLivebetrieb hat dieser Parameter keine Auswirkungen.

Verschlüsselte Parameter zum Schließen einer Amazon-Pay-Zahlung


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

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

(Info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Key

Format

CND

Description

Beschreibung
KeyFormatCNDShipping informationVersandinformationen

BuyerName

a..50

O

part of the userprofile information. User name

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

part of the userprofile information. E-mail address

Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrNamea..50OFirst name and surname of addresseeVorname und Nachname des Adressaten
PhoneNumbera..128OPhone number of addresseeTelefonnummer des Adressaten
AddrCountryCodea2OCountry code of delivery country according to ISO 3166Ländercode des Lieferlandes gemäß ISO 3166
AddrStatea..50OFederal state of the delivery addressBundesland der Lieferadresse
AddrCountya..50OCounty of delivery addressLandkreis der Lieferadresse
AddrDistricta..50ODistrict of delivery addressBezirk der Lieferadresse

AddrZip

a..20

O

Postcode in the delivery address

Postleitzahl der Lieferadresse
AddrCitya..50OTown/city in the delivery addressOrtsname der Lieferadresse
AddrStreeta..180OCompany name (if given) or street name and street numberFirmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2a..60OStreet name and house numberStraßenname mit Hausnummer
AddrStreet3a..60OOther additionsSonstige Zusätze
KeyFormatCNDInvoicing addressRechnungsadresse

bdAddrName

a..50

O

First name and surname of addressee in the billing address

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

a..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of the billing country according to ISO 3166

Ländercode des Rechnungslandes gemäß ISO 3166

bdAddrState

a..50

O

Federal state in the invoicing address

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

County of billing address

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

District of billing address

Bezirk der Rechnungsadresse

bdAddrZip

a..20

O

Postcode in the invoicing address

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Name of town/city in the billing address

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

Company name (if given) or street name and street number in the billing address

Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet2

a..60

O

Street name and street number in the billing address

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

Other additions in the billing address

Sonstige Zusätze der Rechnungsadresse

Antwort-Parameter nach Schließen einer Amazon-Pay-Zahlung



Amazon Pay Order stornieren

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


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
Reasona..1024OReason for reversalGrund der Stornierung

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments / actions, enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction / 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 / action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action. Submissions with identical ReqID for an open status will be processed regularly.

Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion / Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung / weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion / Aktion zurück. Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

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


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

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

(Info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key

Format

CND

Description

Beschreibung
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Antwort-Parameter nach Stornierung einer Amazon-Pay-Zahlung


Hinweis: Wenn Sie eine Bestellung komplett stornieren, erhalten Sie ebenfalls ein Notify analog zum oben beschriebenen Notify nach einer fehlerhaften Bestellung.



Amazon Pay Autorisierung stornieren

Um eine einzelne Autorisierung mit Amazon Pay mit der Funktion „CancelAuthorize“ zu stornieren, rufen Sie bitte folgende URL auf:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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
Reasona..1024MReason for reversalGrund der Stornierung
EventTokenan3MAbbreviation of the action to be done: <RAN> = ReverseAuthorizationAbkürzung der auszuführenden Aktion: <RAN> = ReverseAuthorization

Verschlüsselte Parameter zum Storno einer Amazon-Pay-Autorisierung


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

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

(Info) 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MID

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
RefNr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

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
AmazonStatusa..20MOrder 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.
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefIDans..27MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table EN

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Key

Format

CND

Description

Beschreibung
KeyFormatCNDShipping informationVersandinformationen

BuyerName

a..50

O

part of the userprofile information. User name

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

part of the userprofile information. E-mail address

Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrNamea..50OFirst name and surname of addresseeVorname und Nachname des Adressaten
PhoneNumbera..128OPhone number of addresseeTelefonnummer des Adressaten
AddrCountryCodea2OCountry code of delivery country according to ISO 3166Ländercode des Lieferlandes gemäß ISO 3166
AddrStatea..50OFederal state of the delivery addressBundesland der Lieferadresse
AddrCountya..50OCounty of delivery addressLandkreis der Lieferadresse
AddrDistricta..50ODistrict of delivery addressBezirk der Lieferadresse

AddrZip

a..20

O

Postcode in the delivery address

Postleitzahl der Lieferadresse
AddrCitya..50OTown/city in the delivery addressOrtsname der Lieferadresse
AddrStreeta..180OCompany name (if given) or street name and street numberFirmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2a..60OStreet name and house numberStraßenname mit Hausnummer
AddrStreet3a..60OOther additionsSonstige Zusätze
KeyFormatCNDInvoicing addressRechnungsadresse

bdAddrName

a..50

O

First name and surname of addressee in the billing address

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

a..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of the billing country according to ISO 3166

Ländercode des Rechnungslandes gemäß ISO 3166

bdAddrState

a..50

O

Federal state in the invoicing address

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

County of billing address

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

District of billing address

Bezirk der Rechnungsadresse

bdAddrZip

a..20

O

Postcode in the invoicing address

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Name of town/city in the billing address

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

Company name (if given) or street name and street number in the billing address

Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet2

a..60

O

Street name and street number in the billing address

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

Other additions in the billing address

Sonstige Zusätze der Rechnungsadresse

Antwort-Parameter nach Storno einer Amazon-Pay-Autorisierung


Hinweis: Wenn Sie eine Autorisierung stornieren, erhalten Sie ebenfalls ein Notify analog zum oben beschriebenen Notify nach einer Autorisierung.



Amazon Pay Autorisierungsdetails abfragen

Um die Details einer Autorisierung mit Amazon Pay abzufragen, rufen Sie bitte folgende URL auf:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
OrderDescans..127OUse this parameter for the simulation mode. During live mode this parameter has no effects.Nutzen Sie diesen Parameter für den Simulationsmodus. ImLivebetrieb hat dieser Parameter keine Auswirkungen.
EventTokenan3M

Abbreviation of the action to be done: <ATD> = AuthorizeDetails

Abkürzung der auszuführenden Aktion: <ATD> = AuthorizeDetails