Search

Skip to end of metadata
Go to start of metadata

Über Amazon Pay Recurring

Allgemeines zu Amazon Pay Recurring

Die Abwicklung von wiederkehrenden Zahlungen mit Amazon Pay Recurring 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 Recurring 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 Recurring sowie die Parameter der Schnittstelle. Die anfängliche Konfiguration entspricht derjenigen für Amazon Pay.

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.

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.

Auf dieser Seite

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-, Wallet- und Consent-Widgets laden und anzeigen

Alle drei 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 „BillingAgreementId“ (vom Adress-Widget erzeugte BillingAgreementId – per JavaScript mittels „billingAgreement.getBillingAgreementId()“ auszulesen) zwischenzuspeichern und sofort einen Aufruf der AmazonAPA.aspx mit dem Eventtoken „SBA“ und der „BillingAgreementID“ ü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.

Bitte stellen Sie sicher, dass Sie die „BillingAgreementID“ bei Ihnen am Vorgang abgespeichert wird, da diese für wiederkehrende Autorisierungen benötigt wird.

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

Einverständnis zur Zahlung einholen

Über die Funktion „onConsent“ des Consent Widget stellen Sie sicher, dass der Kunde sich mit einer wiederkehrenden Zahlung einverstanden erklärt. Sollte der Kunde diese nicht bestätigen schlägt das Confirm im Folgeaufruf fehlt.

Kauf abschließen

Die Bestätigung des Einkaufs erfolgt ebenfalls via Computop Paygate mit wahlweise einem von drei Eventtoken – „SCA“ „SetBillingAgreement and Confirm and Authorize“, „SCB“ „SetBillingAgreement and Confirm“ oder „COB“ „Confirm“.

Der Aufruf mit dem Eventtoken „SCA“ ist vorzuziehen, wenn Sie direkt nach dem Kauf eine Autorisierung durchführen möchten. Der Aufruf liefert Ihnen die finale Lieferadresse, sowie die „XID“ zur Buchung der Autorisierung. Über den Parameter „CAPTURE=AUTO“ wird die Autorisierung sofort gebucht. 

Der Aufruf mit dem Eventtoken „SCB“ ist vorzuziehen, wenn keine Autorisierung direkt nach dem Kauf durchgeführt wird. Die Autorisierung wird separat mit dem Eventtoken „ABA“ ausgeführt. Der Aufruf vereinfacht die Folgeschritte, da hierbei automatisch die finale Lieferadresse (mit allen Adressdetails) zurückgegeben wird.

Wenn Sie noch keine Autorisierung durchgeführt haben besteht noch kein Zahlungsanspruch gegenüber dem Kunden. Im Folgenden müssen von Ihren Systemen noch Autorisierungen und Buchungen (Captures) durchgeführt werden.

Billing Agreement prüfen

Um das BillingAgreement zu überprüfen nutzen Sie das Eventtoken „VBA“ „Validate Billing Agreement“. Dieser Schritt ist Optional.

Autorisierung

Mit dem nun erzeugten BillingAgreement können Sie eine Autorisierung durchführen. Hierfür übermitteln Sie im Aufruf mit dem Eventtoken „ABA“ u.a. die BillingAgreementId. Dies ist die Referenz bei Amazon für die Vereinbarung zwischen Ihnen und dem Endkunden. Die Rückgabeparameter AmountLimitPerTimePeriod und CurrentRemainingBalanceAmount geben den insgesamt maximal zu autorisierenden Betrag bzw. den noch möglichen zu autorisierenden Betrag in der Periode an. Bitte beachten Sie, dass die Obergrenze mit Amazon Pay verhandelt werden muss.

Nutzen Sie den Parameter „CAPTURE=AUTO“, um den Betrag sofort buchen zu lassen. Für jede weitere Lieferung wiederholen Sie den Vorgang bis zum Ende der Vereinbarung mit Ihrem Kunden.

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.

Bestellvorgang nach erfolgter Auslieferung abschließen

Nach Abschluss einer einzelnen Zahlung (z.B. Lieferung der Ware innerhalb des Abonnements) empfiehlt es sich, den einzelnen Vorgang bei Amazon zu schließen. Dabei wird der Kunde per E-Mail darüber informiert, dass diese einzelne Lieferung beendet ist und keine weiteren Autorisierungen mehr durchgeführt werden. Der Kunde sieht im Backend von Amazon Pay, dass der Vorgang abgeschlossen ist. 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.

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-, Wallet- und Consent-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',
  agreementType: 'BillingAgreement',
  onReady: function (billingAgreement) {
     billingAgreement.getAmazonBillingAgreementId();
     // Send Request to AmazonAPA.aspx with Eventtoken SBA
     // (“SetBillingAgreement”) and BillingAgreementId to Computop Paygate
     // or save the BillingAgreementId for Request with Eventtoken SCA or
     // SCB
  },
  onAddressSelect: function(billingAgreement) {
    // Send Request to AmazonAPA.aspx with Eventtoken GBA
    // (“GetBillingDetails”) to get the selected address to Computop
    // Paygate
  },
  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',
  // amazonBillingAgreementId obtained from the AddressBook widget
  amazonBillingAgreementId: amazonBillingAgreementId,
  onPaymentSelect: function(orderReference) {
    // Send Request to AmazonAPA.aspx with Eventtoken GBA
    // (“GetBillingDetails”) to get the selected billing address
    // to Computop Paygate
  },
  design: {
    designMode: 'responsive'
  },
  onError: function(error) {
    // your error handling code
  }
}).bind("walletWidgetDiv");
</script>


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

<div id=" consentWidgetDiv">
</div>
<script>
new OffAmazonPayments.Widgets.Consent({  sellerId: 'YOUR_SELLER_ID_HERE',  // amazonBillingAgreementId obtained from the Amazon Address Book   // widget.   amazonBillingAgreementId: amazonBillingAgreementId,   design: {    designMode: 'responsive'  },  onReady: function(billingAgreementConsentStatus){    // Called after widget renders    buyerBillingAgreementConsentStatus =      billingAgreementConsentStatus.getConsentStatus();    // getConsentStatus returns true or false    // true – checkbox is selected    // false – checkbox is unselected - default  },  onConsent: function(billingAgreementConsentStatus) {    buyerBillingAgreementConsentStatus =      billingAgreementConsentStatus.getConsentStatus();    // getConsentStatus returns true or false    // true – checkbox is selected – buyer has consented    // false – checkbox is unselected – buyer has not consented     // Replace this code with the action that you want to perform    // after the consent checkbox is selected/unselected.   },  onError: function(error) {    // your error handling code   }}).bind("consentWidgetDiv ");
</script>


Die Option zur Abmeldung ist zumeist ein Link, um alle Benutzerinformationen von der Webseite zu entfernen. Erweitern Sie diesen Vorgang um folgenden Code um die Benutzerinformationen vom Kunden aus dem Cache des Browsers zu entfernen:

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


Weitere Informationen finden Sie in der Dokumentation von Amazon Pay.


Verfügbare Event-Token

Für Amazon Pay gibt Recurring 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

SBASetBillingAgreementTransmission of BillingAgreementID and return of delivery address (depending on scope in Button Widget).Übergabe der BillingAgreementID und Rückgabe der Lieferadresse (je nach Scope im Button Widget).
SCASetBillingAgreement and Confirm and AuthorizeOrder confirmation and simultaneous first authorization – with this event token the order is finished and the first authorization will be made. In case of successful confirmation further authorizations can be submitted to Amazon.Bestätigung der Bestellung und gleichzeitige erste Autorisierung – durch dieses Eventtoken wird die Bestellung abgeschlossen und eine erste Autorisierung angelegt. Bei erfolgreicher Bestätigung können weitere Autorisierungen an Amazon eingereicht werden.
SCBSetBillingAgreement and ConfirmOrder confirmation – with this Eventtoken the order is finalized. After successfully confirmation authorizations can be submitted to Amazon immediately.Bestätigung der Bestellung – durch dieses Eventtoken wird die Bestellung abgeschlossen, und es können bei erfolgreicher Bestätigung sofort Autorisierungen an Amazon eingereicht werden.
COBConfirm Billing Agreement

Optional, if the order confirmation has to be carried out separately. (Computop recommends using event token SCB or SCA for order confirmation)

Optional, wenn die Bestellbestätigung separat ausgeführt werden muss. (Computop empfiehlt die Nutzung des Eventtoken SCB oder SCA für die Bestellbestätigung)

GBAGetBillingAgreement

Request of information about BillingAgreement, e.g. to get information about a newly selected delivery address. After a request with event token SCA, SCB or COB, GOD returns also the billing address of the 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.

Abfrage der Informationen zum Billing Agreement, um z.B. Informationen über eine neu gewählte Lieferadresse zu erhalten. Nach einem Aufruf mit Eventtoken SCA, SCB oder COB liefert GBA 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.

ABAAuthorize

Event token for authorization. The request uses the BillingAgreementID and initiates a new transaction (PayID) with Computop.

Eventtoken für die Autorisierung. Der Aufruf erfolgt mit der BillingAgreementID und erzeugt einen neuen Vorgang (PayId) bei Computop.

CLBClose Billing AgreementClose a recurring order with Amazon. Captures related to open authorizations as well as credits are possible furthermore.Schließen einer wiederkehrenden Bestellung bei Amazon. Es sind weiterhin Buchungen auf offene Autorisierungen und Gutschriften möglich.
VBAValidate Billing AgreementValidation of a Billing AgreementÜberprüfen eines Billing Agreement

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)

Diagramme zum Prozessablauf

Process flow for Amazon Pay Recurring within Paygate

 

Please note that calling event token SCB in step 56 can be replaced with request with event token SCA. By this way together with the confirmation also an authorization of the requested amount is made and den validation request in step 61 becomes superfluous.

Process flow for Amazon Pay Recurring EventToken=SCA within Paygate

 

Then the authorization of recurring payments is done with one request.

Process flow for Amazon Pay Recurring EventToken=APA within Paygate


Amazon Pay Recurring testen

Für Amazon Pay Recurring stehen Ihnen die gewohnten Simulationsmöglichkeiten zur Verfügung. Hierbei können Sie mittels Übergabe des Wertes „TEST:[letzte 4 Stellen ErrorCode]“ im Parameter „OrderDesc“ Fehler oder mittels „TEST:0000“ eine erfolgreiche Zahlung simulieren.

Zusätzlich besteht die Möglichkeit, Fehler bei Amazon Pay zu testen und somit auch vom nachgelagertem System Fehlermeldungen zu erhalten. Übergeben Sie dafür einfach den „Simulation String“ (Siehe Amazon Dokumentation) im Parameter „OrderDesc“ im entsprechenden Request. Details entnehmen Sie bitte der Dokumentation von Amazon Pay.


Adress-Parameter einer Adresse zuordnen

Das Computop Paygate übermittelt bei verschiedenen Requests (z.B. bei dem Aufruf mit Eventtoken=GBA (Get Billing Agreement Details)) Adressparameter zurück. Folgender Pseudo-Code kann Ihnen die Zuordnung der Adressdaten für Kunden aus DE und AT in Ihrem Backend erleichtern. Die Beschreibung gilt sowohl für die Liefer- als auch die Rechnungsadressparameter.

if (AddrCountryCode in ("AT","DE")) {
   if (addrstreet3 != "") {
      Street = addrstreet3
      if (addrstreet1 isNumber or addrstreet1 + addrstreet2 contains “Packstation”) {
         PO box = addrstreet1 + addrstreet2
      }
      else{
         Company = addrstreet1 + addrstreet2
      }
      } else if (addrstreet2 != "") {
         Street = addrstreet2
         if (addrstreet1 isNumber or addrstreet1 contains “Packstation”) {
            PO box = addrstreet1
         } else {
            Company = addrstreet1
         }
      } else if (addrstreet1 != "") {
         Street = addrstreet1
      }
   } else {
      Street = “”
      if (addrstreet1 != "") {
         Street .= addrstreet1
      }
      if (addrstreet2 != "") {
         Street .= addrstreet2
     }
     if (addrstreet3 != "") {
         Street .= addrstreet3
     }
}



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.


Amazon Pay Recurring: Login

Um das Login über Amazon Pay durchzuführen, 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 für Login mit Amazon Pay Recurring


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 Login mit Amazon Pay Recurring



Amazon Pay Recurring: SetBillingAgreementDetails

Um die Daten zum BillingAgreement an Amazon zu übertragen, rufen Sie bitte folgende URL auf:


Hinweis: Der Aufruf der Schnittstelle SetBillingAgreementDetails ist nicht notwendig, wenn Sie den Aufruf SetBillingAgreement and Confirm (Eventtoken=“SCB“) durchführen.

Hinweis: Bitte beachten Sie, dass optionale Adressparameter nur übermittelt werden, wenn der korrekte Scope im Button-Widget angegeben ist. Je nach Scope können Rechnungsadressdaten bereits vor Abschluss der Zahlung übermittelt werden. Siehe Beschreibung von Scope unter „Button-Widget einbinden“.

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

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..127ODescription of purchased goods, unit prices etc. This will be displayed in the email from Amazon to customer.Beschreibung der gekauften Waren, Einzelpreise etc. Wird in E-Mail von Amazon an Kunden angezeigt.
BillingAgreementIDans..64MIs created at loading time of address widget (see above)Wird beim Laden vom Adress-Widget erzeugt (siehe oben)
CustomInformationans..256OAdditional information that should be store with the Billing-AgreementZusätzliche Informationen, die an dem Billing-Agreement gespeichert werden sollen
StoreNameans..1024OName 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:

<SBA> = SetBillingAgreementDetails

Abkürzung der auszuführenden Aktion:

<SBA> = SetBillingAgreementDetails

Verschlüsselte Parameter für SetBillingAgreementDetails mit Amazon Pay Recurring


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“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
BillingAgreementIDans..64MIs created at loading time of address widget (see above)Wird beim Laden vom Adress-Widget erzeugt (siehe oben)

AmountLimitPerTimePeriod

n..7MLimit set by Amazon for the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3MCurrency for the determined limit according to ISO 4217Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10MStart of time interval in the format DD.MM.YYYYStart des Zeitintervalls im Format TT.MM.JJJJ

PeriodEnd

an10MEnd of time interval in the format DD.MM.YYYYEnde des Zeitintervalls im Format TT.MM.JJJJ

CurrentRemainingBalanceAmount

n..7MRemaining limit of the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3MCurrency for the remaining limit according to ISO 4217Währung für das verbleibende Limit gemäß ISO 4217
KeyFormatCNDShipping informationVersandinformationen

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

AddrName

a..50

O

First name and surname of addressee

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Phone number of addressee

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Country code of delivery country according to ISO 3166

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

AddrCounty

a..50

O

County of delivery address

Landkreis der Lieferadresse

AddrDistrict

a..50

O

District of delivery address

Bezirk der Lieferadresse

AddrZip

an..20

O

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

Teil der Benutzerprofil-Informationen. Postleitzahl der Standard-Lieferadresse

AddrCity

a..50

O

Town/city in the delivery address

Ortsname der Lieferadresse

AddrStreet

a..180

O

Company name (if given) or street name and street number

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Street name and house number

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Other additions

Sonstige 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

ans..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of delivery country of the invoicing address according to ISO 3166

Ländercode des Lieferlandes der Rechnungsadresse 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

an..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 Rückgabe von SetBillingAgreement mit Amazon Pay Recurring



Amazon Pay Recurring: GetBillingAgreementDetails

Um die Daten zu einem BillingAgreement abzufragen, rufen Sie bitte folgende URL auf:


Hinweis: Bitte beachten Sie, dass optionale Adressparameter nur übermittelt werden, wenn der korrekte Scope im Button-Widget angegeben ist. Je nach Scope können Rechnungsadressdaten bereits vor Abschluss der Zahlung übermittelt werden. Siehe Beschreibung von Scope unter „Button-Widget einbinden“.

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.

Key

Format

CND

Description

Beschreibung
PayIDan32C

ID issued by the Paygate for the payment, e.g. for the referencing of cancellations, captures and credits.

If PayID is already available then this should be transmitted. Otherwise als the BillingAgreementId can be transmitted.

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung von Stornos, Buchungen und Gutschriften.

Falls die PayID bereits vorhanden ist, sollte diese übermittelt werden. Anderenfalls kann auch die BillingAgreementId übermittelt 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

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..126ODescription of purchased goods, unit prices etc. This will be displayed in the email from Amazon to customer.Beschreibung der gekauften Waren, Einzelpreise etc. Wird in E-Mail von Amazon an Kunden angezeigt.
BillingAgreementIDans..64C

Is created at loading time of address widget (see above).

If PayID is not specified and the BillingAgreementID was not already transmitted to Computop then the BillingAgreementID must be specified.

Wird beim Laden vom Adress-Widget erzeugt (siehe oben).

Falls keine PayID angegeben wurde und die BillingAgreementID nicht zuvor bereits an Computop übermittelt wurde, dann muss die BillingAgreementID angeben werden.

CountryCodea2CIf PayID was not specified: Country code of used marketplace. Presently only DE and GB permitted.Falls keine PayID angegeben wurde: Länderkennung des genutzten Marketplace. Derzeit nur DE und GB erlaubt.
URLNotifyans..256C

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 a PayID is specified ot 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 PayID angegeben oder eine URLNotify am Paygate fest definiert ist.

EventToken

enum

M

Abbreviation of the action to be done:

<GBA> = GetBillingAgreementDetails

Abkürzung der auszuführenden Aktion:

<GBA> = GetBillingAgreementDetails

Verschlüsselte Parameter für GetBillingAgreementDetails mit Amazon Pay Recurring


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“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
BillingAgreementIDans..64MIs created at loading time of address widget (see above)Wird beim Laden vom Adress-Widget erzeugt (siehe oben)

AmountLimitPerTimePeriod

n..7MLimit set by Amazon for the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3MCurrency for the determined limit according to ISO 4217Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10MStart of time interval in the format DD.MM.YYYYStart des Zeitintervalls im Format TT.MM.JJJJ

PeriodEnd

an10MEnd of time interval in the format DD.MM.YYYYEnde des Zeitintervalls im Format TT.MM.JJJJ

CurrentRemainingBalanceAmount

n..7MRemaining limit of the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3MCurrency for the remaining limit according to ISO 4217Währung für das verbleibende Limit gemäß ISO 4217
KeyFormatCNDShipping informationVersandinformationen

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

AddrName

a..50

O

First name and surname of addressee

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Phone number of addressee

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Country code of delivery country according to ISO 3166

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

AddrCounty

a..50

O

County of delivery address

Landkreis der Lieferadresse

AddrDistrict

a..50

O

District of delivery address

Bezirk der Lieferadresse

AddrZip

an..20

O

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

Teil der Benutzerprofil-Informationen. Postleitzahl der Standard-Lieferadresse

AddrCity

a..50

O

Town/city in the delivery address

Ortsname der Lieferadresse

AddrStreet

a..180

O

Company name (if given) or street name and street number

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Street name and house number

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Other additions

Sonstige 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

ans..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of delivery country of the invoicing address according to ISO 3166

Ländercode des Lieferlandes der Rechnungsadresse 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

an..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 Rückgabe von GetBillingAgreement mit Amazon Pay Recurring



Amazon Pay Recurring: ConfirmBillingAgreement

Um die Bestätigung des Kunden zum BillingAgreement an Amazon zu übermitteln, rufen Sie bitte folgende URL auf:


Hinweis: Bitte beachten Sie, dass optionale Adressparameter nur übermittelt werden, wenn der korrekte Scope im Button-Widget angegeben ist. Je nach Scope können Rechnungsadressdaten bereits vor Abschluss der Zahlung übermittelt werden. Siehe Beschreibung von Scope unter „Button-Widget einbinden“.

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

EventToken

enum

M

Abbreviation of the action to be done:

<COB> = ConfirmBillingAgreement

Abkürzung der auszuführenden Aktion:

<COB> = ConfirmBillingAgreement

Parameter für Bestätigung des BillingAgreement mit Amazon Pay Recurring


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“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
BillingAgreementIDans..64MIs created at loading time of address widget (see above)Wird beim Laden vom Adress-Widget erzeugt (siehe oben)

AmountLimitPerTimePeriod

n..7MLimit set by Amazon for the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3MCurrency for the determined limit according to ISO 4217Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10MStart of time interval in the format DD.MM.YYYYStart des Zeitintervalls im Format TT.MM.JJJJ

PeriodEnd

an10MEnd of time interval in the format DD.MM.YYYYEnde des Zeitintervalls im Format TT.MM.JJJJ

CurrentRemainingBalanceAmount

n..7MRemaining limit of the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3MCurrency for the remaining limit according to ISO 4217Währung für das verbleibende Limit gemäß ISO 4217
KeyFormatCNDShipping informationVersandinformationen

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

AddrName

a..50

O

First name and surname of addressee

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Phone number of addressee

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Country code of delivery country according to ISO 3166

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

AddrCounty

a..50

O

County of delivery address

Landkreis der Lieferadresse

AddrDistrict

a..50

O

District of delivery address

Bezirk der Lieferadresse

AddrZip

an..20

O

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

Teil der Benutzerprofil-Informationen. Postleitzahl der Standard-Lieferadresse

AddrCity

a..50

O

Town/city in the delivery address

Ortsname der Lieferadresse

AddrStreet

a..180

O

Company name (if given) or street name and street number

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Street name and house number

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Other additions

Sonstige 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

ans..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of delivery country of the invoicing address according to ISO 3166

Ländercode des Lieferlandes der Rechnungsadresse 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

an..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 Bestätigung des BillingAgreement mit Amazon Pay Recurring



Amazon Pay Recurring: ValidateBillingAgreement

Um ein BillingAgreement zu überprüfen, rufen Sie bitte folgende URL auf:


Hinweis: Bitte beachten Sie, dass optionale Adressparameter nur übermittelt werden, wenn der korrekte Scope im Button-Widget angegeben ist. Je nach Scope können Rechnungsadressdaten bereits vor Abschluss der Zahlung übermittelt werden. Siehe Beschreibung von Scope unter „Button-Widget einbinden“.

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

EventToken

enum

M

Abbreviation of the action to be done:

<VBA> = ValidateBillingAgreement

Abkürzung der auszuführenden Aktion:

<VBA> = ValidateBillingAgreement

Parameter für Überprüfung des BillingAgreement mit Amazon Pay Recurring


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“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
BillingAgreementIDans..64MIs created at loading time of address widget (see above)Wird beim Laden vom Adress-Widget erzeugt (siehe oben)

AmountLimitPerTimePeriod

n..7MLimit set by Amazon for the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3MCurrency for the determined limit according to ISO 4217Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10MStart of time interval in the format DD.MM.YYYYStart des Zeitintervalls im Format TT.MM.JJJJ

PeriodEnd

an10MEnd of time interval in the format DD.MM.YYYYEnde des Zeitintervalls im Format TT.MM.JJJJ

CurrentRemainingBalanceAmount

n..7MRemaining limit of the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3MCurrency for the remaining limit according to ISO 4217Währung für das verbleibende Limit gemäß ISO 4217
KeyFormatCNDShipping informationVersandinformationen

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

AddrName

a..50

O

First name and surname of addressee

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Phone number of addressee

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Country code of delivery country according to ISO 3166

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

AddrCounty

a..50

O

County of delivery address

Landkreis der Lieferadresse

AddrDistrict

a..50

O

District of delivery address

Bezirk der Lieferadresse

AddrZip

an..20

O

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

Teil der Benutzerprofil-Informationen. Postleitzahl der Standard-Lieferadresse

AddrCity

a..50

O

Town/city in the delivery address

Ortsname der Lieferadresse

AddrStreet

a..180

O

Company name (if given) or street name and street number

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Street name and house number

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Other additions

Sonstige 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

ans..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of delivery country of the invoicing address according to ISO 3166

Ländercode des Lieferlandes der Rechnungsadresse 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

an..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 Überprüfung eines BillingAgreement mit Amazon Pay Recurring



Amazon Pay Recurring: Autorisierung für ein BillingAgreement

Um eine (weitere) Autorisierung für ein BillingAgreement auszuführen, rufen Sie folgende URL auf:


Hinweis: Nutzen Sie diesen Aufruf, um in regelmäßigen Abständen Geld von Ihrem Endkunden einzuziehen. Der Aufruf kann beliebig oft durchgeführt werden, solange das mit Amazon Pay vereinbarte Limit der Autorisierungen nicht überschritten wurde (siehe Parameter AmountLimitPerTimePeriod und CurrentRemainingBalanceAmount). Bitte beachten Sie, dass das Limit mit Amazon Pay abgestimmt werden muss.

Hinweis: Bitte beachten Sie, dass optionale Adressparameter nur übermittelt werden, wenn der korrekte Scope im Button-Widget angegeben ist. Je nach Scope können Rechnungsadressdaten bereits vor Abschluss der Zahlung übermittelt werden. Siehe Beschreibung von Scope unter „Button-Widget einbinden“.

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

CountryCode

a2

M

Country code of used marketplace. Presently only DE and GB permitted.Länderkennung des genutzten Marketplace. Derzeit nur DE und GB erlaubt.

OrderDesc

ans..126

O

Description of purchased goods, unit prices etc. This will be displayed in the email from Amazon to customer.

Beschreibung der gekauften Waren, Einzelpreise etc. Wird in E-Mail von Amazon an Kunden angezeigt.

EventToken

enum

M

Abbreviation of the action to be done:

<ABA> = AuthorizeBillingAgreement

Abkürzung der auszuführenden Aktion:

<ABA> = AuthorizeBillingAgreement

BillingAgreementID

ans..64

M

Is created at loading time of address widget (see above)

Wird beim Laden vom Adress-Widget erzeugt (siehe oben)

CustomInformation

ans..256

O

Additional information that should be store with the Billing-Agreement

Zusätzliche Informationen, die an dem Billing-Agreement gespeichert werden sollen

StoreName

ans..1024

O

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

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

ShoppingBasketAmount

enum

O

Categorizes the shopping basket:

„DIGITAL“ for shopping baskets with solely digital goods

„DIGITAL“ for shopping baskets with solely physical goods

„MIXED“ for shopping baskets with digital and physical goods

For shopping baskets Digital and Mixed the Amazon address data are not included in this risk assessment.

Kategorisiert den Warenkorb:

„DIGITAL“ für Warenkörbe mit ausschließlich digitalen Gütern

„PHYSICAL“ für Warenkörbe mit ausschließlich physischen Gütern

„MIXED“ für Warenkörbe mit sowohl digitalen als auch physischen Gütern

Bei Digitalen und Mixed Warenkörben werden die Adressdaten bei Amazon nicht in die Risikoprüfung einbezogen.

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

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.

Key

Format

CND

Description

Beschreibung
ChDescans..12C

Text printed on the customer’s credit card bill (only for Capture=AUTO)

If Capture=AUTO is selected than ChDesc must be transmitted.

Text der auf der Abrechnung des Kreditinstituts des Kun-den erscheint (nur bei Capture=AUTO)

Wenn Capture=AUTO angegeben ist, dann muss ChDesc übergeben werden.

URLNotifyans..256C

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.

Verschlüsselte Parameter für eine Autorisuerng für ein BillingAgreement mit Amazon Pay Recurring


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“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
BillingAgreementIDans..64MIs created at loading time of address widget (see above)Wird beim Laden vom Adress-Widget erzeugt (siehe oben)
AmazonRefID

ans..27

MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion
OrderID

ans..19

COnly for Capture=AUTO: Unique ID for the order issued by Amazon. Corresponds to the Order-ReferenceID.Nur bei Capture=AUTO: Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der Order-ReferenceID.

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

AmountLimitPerTimePeriod

n..7MLimit set by Amazon for the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3MCurrency for the determined limit according to ISO 4217Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10MStart of time interval in the format DD.MM.YYYYStart des Zeitintervalls im Format TT.MM.JJJJ

PeriodEnd

an10MEnd of time interval in the format DD.MM.YYYYEnde des Zeitintervalls im Format TT.MM.JJJJ

CurrentRemainingBalanceAmount

n..7MRemaining limit of the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3MCurrency for the remaining limit according to ISO 4217Währung für das verbleibende Limit gemäß ISO 4217
NotificationTypea..25CIs transmitted only in case of Notify: Describes the type of notification. Fixed value: <AuthorizeNotification>Wird nur beim Notify übermittelt: Beschreibt die Art der Benachrichtigung. Fester Wert: <AuthorizeNotification>
KeyFormatCNDShipping informationVersandinformationen

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

AddrName

a..50

O

First name and surname of addressee

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Phone number of addressee

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Country code of delivery country according to ISO 3166

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

AddrCounty

a..50

O

County of delivery address

Landkreis der Lieferadresse

AddrDistrict

a..50

O

District of delivery address

Bezirk der Lieferadresse

AddrZip

an..20

O

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

Teil der Benutzerprofil-Informationen. Postleitzahl der Standard-Lieferadresse

AddrCity

a..50

O

Town/city in the delivery address

Ortsname der Lieferadresse

AddrStreet

a..180

O

Company name (if given) or street name and street number

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Street name and house number

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Other additions

Sonstige 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

ans..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of delivery country of the invoicing address according to ISO 3166

Ländercode des Lieferlandes der Rechnungsadresse 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

an..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 Autorisierung für ein BillingAgreement mit Amazon Pay Recurring sowie Parameter an URLNotify



Amazon Pay Recurring: SetBillingAgreementDetails und Confirm

Um SetBillingAgreementDetails und die Bestätigung in einem Schritt auszuführen, rufen Sie folgende URL auf:


Hinweis: Bitte beachten Sie, dass der Aufruf SCB nur einmal erfolgen sollte, da das Confirm nur einmalig erfolgreich durchgeführt werden kann. Nutzen Sie daher unbedingt die ReqID, um doppelte Requests zu vermeiden.

Hinweis: Bitte beachten Sie, dass optionale Adressparameter nur übermittelt werden, wenn der korrekte Scope im Button-Widget angegeben ist. Je nach Scope können Rechnungsadressdaten bereits vor Abschluss der Zahlung übermittelt werden. Siehe Beschreibung von Scope unter „Button-Widget einbinden“.

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

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

O

Description of purchased goods, unit prices etc. This will be displayed in the email from Amazon to customer.

Beschreibung der gekauften Waren, Einzelpreise etc. Wird in E-Mail von Amazon an Kunden angezeigt.

EventToken

enum

M

Abbreviation of the action to be done:

<SCB> = SetBillingAgreement & Confirm

Abkürzung der auszuführenden Aktion:

<SCB> = SetBillingAgreement & Confirm

BillingAgreementID

ans..64

M

Is created at loading time of address widget (see above)

Wird beim Laden vom Adress-Widget erzeugt (siehe oben)

CustomInformation

ans..256

O

Additional information that should be store with the Billing-Agreement

Zusätzliche Informationen, die an dem Billing-Agreement gespeichert werden sollen

StoreName

ans..1024

O

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

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

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 für SetBillingAgreementDetails und Bestätigung für ein BillingAgreement mit Amazon Pay Recurring


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“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
BillingAgreementIDans..64MIs created at loading time of address widget (see above)Wird beim Laden vom Adress-Widget erzeugt (siehe oben)

AmountLimitPerTimePeriod

n..7MLimit set by Amazon for the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3MCurrency for the determined limit according to ISO 4217Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10MStart of time interval in the format DD.MM.YYYYStart des Zeitintervalls im Format TT.MM.JJJJ

PeriodEnd

an10MEnd of time interval in the format DD.MM.YYYYEnde des Zeitintervalls im Format TT.MM.JJJJ

CurrentRemainingBalanceAmount

n..7MRemaining limit of the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3MCurrency for the remaining limit according to ISO 4217Währung für das verbleibende Limit gemäß ISO 4217
KeyFormatCNDShipping informationVersandinformationen

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

AddrName

a..50

O

First name and surname of addressee

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Phone number of addressee

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Country code of delivery country according to ISO 3166

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

AddrCounty

a..50

O

County of delivery address

Landkreis der Lieferadresse

AddrDistrict

a..50

O

District of delivery address

Bezirk der Lieferadresse

AddrZip

an..20

O

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

Teil der Benutzerprofil-Informationen. Postleitzahl der Standard-Lieferadresse

AddrCity

a..50

O

Town/city in the delivery address

Ortsname der Lieferadresse

AddrStreet

a..180

O

Company name (if given) or street name and street number

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Street name and house number

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Other additions

Sonstige 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

ans..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of delivery country of the invoicing address according to ISO 3166

Ländercode des Lieferlandes der Rechnungsadresse 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

an..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 SetBillingAgreementDetails und Confirm mit Amazon Pay Recurring



Amazon Pay Recurring: SetBillingAgreement, Bestätigung und Autorisierung

Um das SetBillingAgreementDetails, Bestätigung und Autorisierung auf ein BillingAgreement in einem Schritt auszuführen, rufen Sie folgende URL auf:


Hinweis: Bitte beachten Sie, dass der Aufruf SCB nur einmal erfolgen sollte, da das Confirm nur einmalig erfolgreich durchgeführt werden kann. Nutzen Sie daher unbedingt die ReqID, um doppelte Requests zu vermeiden.

Hinweis: Bitte beachten Sie, dass optionale Adressparameter nur übermittelt werden, wenn der korrekte Scope im Button-Widget angegeben ist. Je nach Scope können Rechnungsadressdaten bereits vor Abschluss der Zahlung übermittelt werden. Siehe Beschreibung von Scope unter „Button-Widget einbinden“.

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:

Key

Format

CND

Description

Beschreibung

OrderDesc

ans..126

O

Description of purchased goods, unit prices etc. This will be displayed in the email from Amazon to customer.

Beschreibung der gekauften Waren, Einzelpreise etc. Wird in E-Mail von Amazon an Kunden angezeigt.

EventToken

enum

M

Abbreviation of the action to be done:

<SCA> = SetBillingAgreement & Confirm & Authorize BillingAgreement

Abkürzung der auszuführenden Aktion:

<SCA> = SetBillingAgreement & Confirm & Authorize BillingAgreement

BillingAgreementID

ans..64

M

Is created at loading time of address widget (see above)

Wird beim Laden vom Adress-Widget erzeugt (siehe oben)

CustomInformation

ans..256

O

Additional information that should be store with the Billing-Agreement

Zusätzliche Informationen, die an dem Billing-Agreement gespeichert werden sollen

StoreName

ans..1024

O

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

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

ShoppingBasketAmount

enum

O

Categorizes the shopping basket:

„DIGITAL“ for shopping baskets with solely digital goods

„DIGITAL“ for shopping baskets with solely physical goods

„MIXED“ for shopping baskets with digital and physical goods

For shopping baskets Digital and Mixed the Amazon address data are not included in this risk assessment.

Kategorisiert den Warenkorb:

„DIGITAL“ für Warenkörbe mit ausschließlich digitalen Gütern

„PHYSICAL“ für Warenkörbe mit ausschließlich physischen Gütern

„MIXED“ für Warenkörbe mit sowohl digitalen als auch physischen Gütern

Bei Digitalen und Mixed Warenkörben werden die Adressdaten bei Amazon nicht in die Risikoprüfung einbezogen.

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

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.

Key

Format

CND

Description

Beschreibung
ChDescans..12C

Text printed on the customer’s credit card bill (only for Capture=AUTO)

If Capture=AUTO is selected than ChDesc must be transmitted.

Text der auf der Abrechnung des Kreditinstituts des Kun-den erscheint (nur bei Capture=AUTO)

Wenn Capture=AUTO angegeben ist, dann muss ChDesc übergeben werden.

URLNotifyans..256C

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.

Parameter für SetBillingAgreementDetails, Bestätigung und Autorisierung für ein BillingAgreement mit Amazon Pay Recurring


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“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
BillingAgreementIDans..64MIs created at loading time of address widget (see above)Wird beim Laden vom Adress-Widget erzeugt (siehe oben)
AmazonRefID

ans..27

MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion
OrderID

ans..19

C

Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.

Is returned only if Capture=AUTO.

Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

Wird nur bei Capture=AUTO zurückgegeben.

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

AmountLimitPerTimePeriod

n..7MLimit set by Amazon for the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3MCurrency for the determined limit according to ISO 4217Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10MStart of time interval in the format DD.MM.YYYYStart des Zeitintervalls im Format TT.MM.JJJJ

PeriodEnd

an10MEnd of time interval in the format DD.MM.YYYYEnde des Zeitintervalls im Format TT.MM.JJJJ

CurrentRemainingBalanceAmount

n..7MRemaining limit of the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3MCurrency for the remaining limit according to ISO 4217Währung für das verbleibende Limit gemäß ISO 4217
NotificationTypea..25CIs transmitted only in case of Notify: Describes the type of notification. Fixed value: <AuthorizeNotification>Wird nur beim Notify übermittelt: Beschreibt die Art der Benachrichtigung. Fester Wert: <AuthorizeNotification>
KeyFormatCNDShipping informationVersandinformationen

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

AddrName

a..50

O

First name and surname of addressee

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Phone number of addressee

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Country code of delivery country according to ISO 3166

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

AddrCounty

a..50

O

County of delivery address

Landkreis der Lieferadresse

AddrDistrict

a..50

O

District of delivery address

Bezirk der Lieferadresse

AddrZip

an..20

O

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

Teil der Benutzerprofil-Informationen. Postleitzahl der Standard-Lieferadresse

AddrCity

a..50

O

Town/city in the delivery address

Ortsname der Lieferadresse

AddrStreet

a..180

O

Company name (if given) or street name and street number

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Street name and house number

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Other additions

Sonstige 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

ans..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of delivery country of the invoicing address according to ISO 3166

Ländercode des Lieferlandes der Rechnungsadresse 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

an..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 SetBillingAgreementDetails, Bestätigung und Autorisierung mit Amazon Pay Recurring sowie Parameter an URLNotify



Amazon Pay Recurring: Zahlung buchen

Um eine autorisierte Zahlung mit Amazon Pay Recurring zu buchen, rufen Sie 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
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key

Format

CND

Description

Beschreibung

XID

an32

M

ID for the transaction given by Paygate. Transfer here the XID of the authorization that should be captured.

Vom Paygate vergebene ID zur Transaktion. Übergeben Sie hier die XID zur Autorisierung, die gebucht werden soll.

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

OrderDesc

ans..127

M

Use this parameter for the simulation mode. During live mode this parameter has no effects.

Nutzen Sie diesen Parameter für den Simulationsmodus. Im Livebetrieb hat dieser Parameter keine Auswirkungen.

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 Zahlung mit Amazon Pay Recurring


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: „Pending“, „Declined“, „Completed“, „Closed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed, „Closed“. Details siehe Amazon API Reference Guide.
AmazonRefID

ans..27

MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion
OrderID

ans..19

MUnique 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 Zahlung mit Amazon Pay Recurring


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: „Pending“, „Declined“, „Completed“, „Closed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed, „Closed“. Details siehe Amazon API Reference Guide.
AmazonRefID

ans..27

MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion
OrderID

ans..19

MUnique 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
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 Zahlung mit Amazon Pay Recurring



Amazon Pay Recurring: Zahlung gutschreiben

Um eine gebuchte Zahlung mit Amazon Pay Recurring wieder gutzuschreiben, 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
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key

Format

CND

Description

Beschreibung

XID

an32

M

ID for the transaction given by Paygate. Transfer here the XID of the capture that should be credited.

Vom Paygate vergebene ID zur Transaktion. Übergeben Sie hier die XID zur Buchung, die gutgeschrieben werden soll.

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

OrderDesc

ans..127

M

Description of purchased goods, unit prices etc. for authorization

Beschreibung 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 Zahlung mit Amazon Pay Recurring


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..50MREQUEST (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: „Pending“, „Declined“, „Completed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed. Details siehe Amazon API Reference Guide.
AmazonRefID

ans..27

MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion
OrderID

ans..19

MUnique 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 Zahlung mit Amazon Pay Recurring


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: „Pending“, „Declined“, „Completed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed. Details siehe Amazon API Reference Guide.
AmazonRefID

ans..27

MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion
OrderID

ans..19

MUnique 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
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 Zahlung mit Amazon Pay Recurring



Amazon Pay Recurring: Billing Agreement schließen

Um ein Billing Agreement mit Amazon Pay Recurring mit der Funktion „CloseBillingAgreement“ zu schließen, rufen Sie bitte folgende URL auf:


Hinweis: Bitte beachten Sie, dass optionale Adressparameter nur übermittelt werden, wenn der korrekte Scope im Button-Widget angegeben ist. Je nach Scope können Rechnungsadressdaten bereits vor Abschluss der Zahlung übermittelt werden. Siehe Beschreibung von Scope unter „Button-Widget einbinden“.

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.

Key

Format

CND

Description

Beschreibung
BillingAgreementIDans..64MIs created at loading time of address widget (see above)Wird beim Laden vom Adress-Widget erzeugt (siehe oben)

EventToken

enum

M

Abbreviation of the action to be done:

<CLB> = Close Billing Agreement

Abkürzung der auszuführenden Aktion:

<CLB> = Close Billing Agreement

OrderDescans..127ODescription of purchased goods, unit prices etc. for authorizationBeschreibung der gekauften Waren, Einzelpreise etc. zur Autorisierung

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:

Verschlüsselte Parameter zum Schließen einer wiederkehrenden Zahlung mit Amazon Pay Recurring


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: „Pending“, „Declined“, „Completed“. Details see Amazon API Reference Guide.Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed. Details siehe Amazon API Reference Guide.
BillingAgreementIDans..64MIs created at loading time of address widget (see above)Wird beim Laden vom Adress-Widget erzeugt (siehe oben)

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

AmountLimitPerTimePeriod

n..7MLimit set by Amazon for the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3MCurrency for the determined limit according to ISO 4217Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10MStart of time interval in the format DD.MM.YYYYStart des Zeitintervalls im Format TT.MM.JJJJ

PeriodEnd

an10MEnd of time interval in the format DD.MM.YYYYEnde des Zeitintervalls im Format TT.MM.JJJJ

CurrentRemainingBalanceAmount

n..7MRemaining limit of the BillingAgreement within specified interval in the smallest currency unit (e.g. EUR Cent)Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3MCurrency for the remaining limit according to ISO 4217Währung für das verbleibende Limit gemäß ISO 4217
KeyFormatCNDShipping informationVersandinformationen

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

AddrName

a..50

O

First name and surname of addressee

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Phone number of addressee

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Country code of delivery country according to ISO 3166

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

AddrCounty

a..50

O

County of delivery address

Landkreis der Lieferadresse

AddrDistrict

a..50

O

District of delivery address

Bezirk der Lieferadresse

AddrZip

an..20

O

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

Teil der Benutzerprofil-Informationen. Postleitzahl der Standard-Lieferadresse

AddrCity

a..50

O

Town/city in the delivery address

Ortsname der Lieferadresse

AddrStreet

a..180

O

Company name (if given) or street name and street number

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Street name and house number

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Other additions

Sonstige 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

ans..128

O

Phone number of addressee in the billing address

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Country code of delivery country of the invoicing address according to ISO 3166

Ländercode des Lieferlandes der Rechnungsadresse 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

an..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 eines Billing Agreement einer wiederkehrenden Zahlung mit Amazon Pay Recurring



Amazon Pay Recurring: Autorisierungsdetails abfragen

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


H