Page tree

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 Support für die Einrichtung.


Schritte im Ablauf

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

Schritt

Beschreibung

Button-Widget anzeigen

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

Zahlung via Computop Paygate (Server to Server) initialisieren

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

Adress-, 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:

EventToken

Aktion

Beschreibung

LGN

Login

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

SBA

SetBillingAgreement

Übergabe der BillingAgreementID und Rückgabe der Lieferadresse (je nach Scope im Button Widget).

SCA

SetBillingAgreement and Confirm and Authorize

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

SCB

SetBillingAgreement and Confirm

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

COB

Confirm Billing Agreement

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

GBA

GetBillingAgreement

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.

ABA

Authorize

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

CLB

Close Billing Agreement

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

VBA

Validate Billing Agreement

Überprüfen eines Billing Agreement.

ATD

AuthorizeDetails

Statusabfrage einer Autorisierung

CAD

CaptureDetails

Statusabfrage einer Buchung (Capture)

CRD

CreditDetails

Statusabfrage einer Gutschrift (Credit)

Diagramme zum Prozessablauf

Prozessablauf für Amazon Pay Recurring im Paygate


Bitte beachten Sie, dass der Aufruf mit Eventtoken SCB in Schritt 56 durch den Aufruf mit Eventtoken SCA ersetzt werden kann. Dadurch wird mit der Bestätigung zugleich eine Autorisierung des angefragten Betrags durchgeführt und es erübrigt sich die Validierungs-Anfrage in Schritt 61.

Prozessablauf für Amazon Pay Recurring EventToken=SCA im Paygate


Die Autorisierung der wiederkehrenden Zahlungen ist dann mit einem Aufruf erledigt.

Prozessablauf für Amazon Pay Recurring EventToken=APA im 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ürzungBeschreibung

CND

Bedingung (condition)

M

Pflicht (mandatory)

O

optional

C

bedingt (conditional)


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:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..30

O

eindeutige Referenznummer

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

CountryCode

an2

M

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

URLNotify

ans..256

C

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“, 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“, der beim Redirect von Amazon nach Login durch den Kunden übermittelt wird.

Expiry

n..4

M

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

Scope

a..128

M

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

Abkürzung der auszuführenden Aktion

<LGN> = Login

OrderDesc

ans..127

O

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


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

Versandinformationen

UserID

ans..64

O

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

BuyerName

as..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrZip

as..128

O

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: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

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

TransID

ans..64

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..30

O

eindeutige Referenznummer

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

OrderDesc

ans..126

O

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

BillingAgreementID

ans..64

M

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

CustomInformation

ans..256

O

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

StoreName

ans..1024

O

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

EventToken

enum

M

Abkürzung der auszuführenden Aktion

<SBA> = SetBillingAgreementDetails

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


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.

BillingAgreementID

ans..64

M

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

AmountLimitPerTimePeriod

n..7

M

Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3

M

Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10

M

Start des Zeitintervalls im Format DD.MM.YYYY

PeriodEnd

an10

M

Ende des Zeitintervalls im Format DD.MM.YYYY

CurrentRemainingBalanceAmount

n..7

M

Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3

M

Währung für das verbleibende Limit gemäß ISO 4217

Versandinformationen

BuyerName

a..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrName

a..50

O

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Bundesland der Lieferadresse

AddrCounty

a..50

O

Landkreis der Lieferadresse

AddrDistrict

a..50

O

Bezirk der Lieferadresse

AddrZip

an..20

O

Postleitzahl der Lieferadresse

AddrCity

a..50

O

Ortsname der Lieferadresse

AddrStreet

a..180

O

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Sonstige Zusätze

Rechnungsadresse

bdAddrName

a..50

O

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

ans..128

O

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Ländercode des Lieferlandes der Rechnungsadresse gemäß ISO 3166

bdAddrState

a..50

O

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

Bezirk der Rechnungsadresse

bdAddrZip

an..20

O

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

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

bdAddrStreet2

a..60

O

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

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: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

C

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.

TransID

ans..64

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..30

O

eindeutige Referenznummer

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

OrderDesc

ans..126

O

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

BillingAgreementID

ans..64

C

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.

CountryCode

a2

C

Falls keine PayID angegeben wurde: Länderkennung des genutzten Marketplace. Derzeit nur DE und GB erlaubt.

URLNotify

ans..256

C

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

Abkürzung der auszuführenden Aktion

<GBA> = GetBillingAgreementDetails

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


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.

BillingAgreementID

ans..64

M

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

AmountLimitPerTimePeriod

n..7

M

Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3

M

Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10

M

Start des Zeitintervalls im Format DD.MM.YYYY

PeriodEnd

an10

M

Ende des Zeitintervalls im Format DD.MM.YYYY

CurrentRemainingBalanceAmount

n..7

M

Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3

M

Währung für das verbleibende Limit gemäß ISO 4217

Versandinformationen

BuyerName

a..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrName

a..50

O

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Bundesland der Lieferadresse

AddrCounty

a..50

O

Landkreis der Lieferadresse

AddrDistrict

a..50

O

Bezirk der Lieferadresse

AddrZip

an..20

O

Postleitzahl der Lieferadresse

AddrCity

a..50

O

Ortsname der Lieferadresse

AddrStreet

a..180

O

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Sonstige Zusätze

Rechnungsadresse

bdAddrName

a..50

O

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

ans..128

O

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Ländercode des Lieferlandes der Rechnungsadresse gemäß ISO 3166

bdAddrState

a..50

O

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

Bezirk der Rechnungsadresse

bdAddrZip

an..20

O

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

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

bdAddrStreet2

a..60

O

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

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: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

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

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

EventToken

enum

M

Abkürzung der auszuführenden Aktion

<COB> = ConfirmBillingAgreement

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


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code zur Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.

BillingAgreementID

ans..64

M

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

AmountLimitPerTimePeriod

n..7

M

Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3

M

Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10

M

Start des Zeitintervalls im Format DD.MM.YYYY

PeriodEnd

an10

M

Ende des Zeitintervalls im Format DD.MM.YYYY

CurrentRemainingBalanceAmount

n..7

M

Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3

M

Währung für das verbleibende Limit gemäß ISO 4217

Versandinformationen

BuyerName

a..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrName

a..50

O

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Bundesland der Lieferadresse

AddrCounty

a..50

O

Landkreis der Lieferadresse

AddrDistrict

a..50

O

Bezirk der Lieferadresse

AddrZip

an..20

O

Postleitzahl der Lieferadresse

AddrCity

a..50

O

Ortsname der Lieferadresse

AddrStreet

a..180

O

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Sonstige Zusätze

Rechnungsadresse

bdAddrName

a..50

O

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

ans..128

O

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Ländercode des Lieferlandes der Rechnungsadresse gemäß ISO 3166

bdAddrState

a..50

O

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

Bezirk der Rechnungsadresse

bdAddrZip

an..20

O

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

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

bdAddrStreet2

a..60

O

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

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: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

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

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

EventToken

enum

M

Abkürzung der auszuführenden Aktion

<VBA> = ValidateBillingAgreement

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


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code zur Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.

BillingAgreementID

ans..64

M

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

AmountLimitPerTimePeriod

n..7

M

Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3

M

Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10

M

Start des Zeitintervalls im Format DD.MM.YYYY

PeriodEnd

an10

M

Ende des Zeitintervalls im Format DD.MM.YYYY

CurrentRemainingBalanceAmount

n..7

M

Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3

M

Währung für das verbleibende Limit gemäß ISO 4217

Versandinformationen

BuyerName

a..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrName

a..50

O

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Bundesland der Lieferadresse

AddrCounty

a..50

O

Landkreis der Lieferadresse

AddrDistrict

a..50

O

Bezirk der Lieferadresse

AddrZip

an..20

O

Postleitzahl der Lieferadresse

AddrCity

a..50

O

Ortsname der Lieferadresse

AddrStreet

a..180

O

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Sonstige Zusätze

Rechnungsadresse

bdAddrName

a..50

O

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

ans..128

O

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Ländercode des Lieferlandes der Rechnungsadresse gemäß ISO 3166

bdAddrState

a..50

O

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

Bezirk der Rechnungsadresse

bdAddrZip

an..20

O

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

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

bdAddrStreet2

a..60

O

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

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: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

CountryCode

a2

M

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

RefNr

ans..30

O

eindeutige Referenznummer

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

OrderDesc

ans..126

O

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

EventToken

enum

M

Abkürzung der auszuführenden Aktion

<ABA> = AuthorizeBillingAgreement

BillingAgreementID

ans..64

M

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

CustomInformation

ans..256

O

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

StoreName

ans..1024

O

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

ShoppingBasketCategory

enum

O

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.

Capture

a..6

M

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture). AUTO: Buchung sofort nach Autorisierung (Standardwert). MANUAL: Buchung erfolgt durch den Händler. <Zahl>: Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

ChDesc

ans..12

C

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 .

URLNotify

ans..256

C

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.

ReqID

ans..32

O

Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das 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 eine Autorisuerng für ein BillingAgreement mit Amazon Pay Recurring


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.

BillingAgreementID

ans..64

M

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

AmazonRefID

ans..27

M

Von Amazon vergebene eindeutige ID für die Transaktion

OrderID

ans..19

C

Nur bei Capture=AUTO: Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der Order-ReferenceID.

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde.

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

AmountLimitPerTimePeriod

n..7

M

Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3

M

Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10

M

Start des Zeitintervalls im Format DD.MM.YYYY

PeriodEnd

an10

M

Ende des Zeitintervalls im Format DD.MM.YYYY

CurrentRemainingBalanceAmount

n..7

M

Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3

M

Währung für das verbleibende Limit gemäß ISO 4217

NotificationType

a..25

C

Wird nur beim Notify übermittelt: Beschreibt die Art der Benachrichtigung. Fester Wert: <AuthorizeNotification>

Versandinformationen

BuyerName

a..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrName

a..50

O

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Bundesland der Lieferadresse

AddrCounty

a..50

O

Landkreis der Lieferadresse

AddrDistrict

a..50

O

Bezirk der Lieferadresse

AddrZip

an..20

O

Postleitzahl der Lieferadresse

AddrCity

a..50

O

Ortsname der Lieferadresse

AddrStreet

a..180

O

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Sonstige Zusätze

Rechnungsadresse

bdAddrName

a..50

O

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

ans..128

O

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Ländercode des Lieferlandes der Rechnungsadresse gemäß ISO 3166

bdAddrState

a..50

O

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

Bezirk der Rechnungsadresse

bdAddrZip

an..20

O

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

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

bdAddrStreet2

a..60

O

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

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: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

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

TransID

ans..64

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..30

O

eindeutige Referenznummer

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

OrderDesc

ans..126

O

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

EventToken

enum

M

Abkürzung der auszuführenden Aktion

<SCB> = SetBillingAgreement & Confirm

BillingAgreementID

ans..64

M

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

CustomInformation

ans..256

O

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

StoreName

ans..1024

O

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

ReqID

ans..32

O

Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das 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


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.

BillingAgreementID

ans..64

M

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

AmountLimitPerTimePeriod

n..7

M

Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3

M

Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10

M

Start des Zeitintervalls im Format DD.MM.YYYY

PeriodEnd

an10

M

Ende des Zeitintervalls im Format DD.MM.YYYY

CurrentRemainingBalanceAmount

n..7

M

Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3

M

Währung für das verbleibende Limit gemäß ISO 4217

Versandinformationen

BuyerName

a..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrName

a..50

O

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Bundesland der Lieferadresse

AddrCounty

a..50

O

Landkreis der Lieferadresse

AddrDistrict

a..50

O

Bezirk der Lieferadresse

AddrZip

an..20

O

Postleitzahl der Lieferadresse

AddrCity

a..50

O

Ortsname der Lieferadresse

AddrStreet

a..180

O

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Sonstige Zusätze

Rechnungsadresse

bdAddrName

a..50

O

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

ans..128

O

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Ländercode des Lieferlandes der Rechnungsadresse gemäß ISO 3166

bdAddrState

a..50

O

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

Bezirk der Rechnungsadresse

bdAddrZip

an..20

O

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

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

bdAddrStreet2

a..60

O

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

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: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

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

TransID

ans..64

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..30

O

eindeutige Referenznummer

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

OrderDesc

ans..126

O

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

EventToken

enum

M

Abkürzung der auszuführenden Aktion

<SCA> = SetBillingAgreement & Confirm & Authorize BillingAgreement

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

BillingAgreementID

ans..64

M

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

CustomInformation

ans..256

O

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

StoreName

ans..1024

O

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

ShoppingBasketCategory

enum

O

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.

Capture

a..6

M

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture). AUTO: Buchung sofort nach Autorisierung (Standardwert). MANUAL: Buchung erfolgt durch den Händler. <Zahl>: Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

ChDesc

ans..12

C

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 .

URLNotify

ans..256

C

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.

ReqID

ans..32

O

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

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


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.

BillingAgreementID

ans..64

M

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

OrderID

ans..19

C

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

Wird nur bei Capture=AUTO zurückgegeben.

AmazonRefID

ans..27

M

Von Amazon vergebene eindeutige ID für die Transaktion

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

AmountLimitPerTimePeriod

n..7

M

Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3

M

Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10

M

Start des Zeitintervalls im Format DD.MM.YYYY

PeriodEnd

an10

M

Ende des Zeitintervalls im Format DD.MM.YYYY

CurrentRemainingBalanceAmount

n..7

M

Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3

M

Währung für das verbleibende Limit

NotificationType

a..25

C

Wird nur beim Notify übermittelt: Beschreibt die Art der Benachrichtigung. Fester Wert: <AuthorizeNotification>

Versandinformationen

BuyerName

a..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrName

a..50

O

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Bundesland der Lieferadresse

AddrCounty

a..50

O

Landkreis der Lieferadresse

AddrDistrict

a..50

O

Bezirk der Lieferadresse

AddrZip

an..20

O

Postleitzahl der Lieferadresse

AddrCity

a..50

O

Ortsname der Lieferadresse

AddrStreet

a..180

O

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Sonstige Zusätze

Rechnungsadresse

bdAddrName

a..50

O

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

ans..128

O

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Ländercode des Lieferlandes der Rechnungsadresse gemäß ISO 3166

bdAddrState

a..50

O

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

Bezirk der Rechnungsadresse

bdAddrZip

an..20

O

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

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

bdAddrStreet2

a..60

O

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

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:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

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

XID

an32

M

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

TransID

ans..64

M

Transaktionsnummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

RefNr

ans..30

O

Referenznummer des Händlers

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

ChDesc

ans..16

O

Text der auf der Abrechnung des Kreditinstituts des Kunden erscheint

OrderDesc

ans..127

M

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

ReqID

ans..32

O

Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das 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


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers zur Buchung

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed, „Closed“. Details siehe Amazon API Reference Guide.

OrderID

ans..19

M

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

AmazonRefID

ans..27

M

Von Amazon vergebene eindeutige ID für die Transaktion

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, 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:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers zur Buchung

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed, „Closed“. Details siehe Amazon API Reference Guide.

OrderID

ans..19

M

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

AmazonRefID

ans..27

M

Von Amazon vergebene eindeutige ID für die Transaktion

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

NotificationType

a..25

M

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:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung

XID

an32

M

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

TransID

ans..64

M

Transaktionsnummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

RefNr

ans..30

O

Referenznummer des Händlers

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

ChDesc

ans..16

O

Text der auf der Abrechnung des Kreditinstituts des Kunden erscheint

OrderDesc

ans..127

M

Beschreibung der gekauften Waren, Einzelpreise etc. zur Buchung

ReqID

ans..32

O

Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das 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


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers zur Gutschrift

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

REQUEST (Da Gutschriften nicht in Echtzeit ausgeführt werden, ist der Status zunächst stets wartend.)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed. Details siehe Amazon API Reference Guide.

OrderID

ans..19

M

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

AmazonRefID

ans..27

M

Von Amazon vergebene eindeutige ID für die Transaktion

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, 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:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers zur Buchung

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed. Details siehe Amazon API Reference Guide.

OrderID

ans..19

M

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

AmazonRefID

ans..27

M

Von Amazon vergebene eindeutige ID für die Transaktion

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

NotificationType

a..25

M

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: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

BillingAgreementID

ans..64

M

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

EventToken

enum

M

Abkürzung der auszuführenden Aktion:

<CLB> = Close Billing Agreement

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

OrderDesc

ans..127

M

Beschreibung der gekauften Waren, Einzelpreise etc. zur Buchung

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


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers zur Gutschrift

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

REQUEST (Da Gutschriften nicht in Echtzeit ausgeführt werden, ist der Status zunächst stets wartend.)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed. Details siehe Amazon API Reference Guide.

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

BillingAgreementID

ans..64

M

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

AmountLimitPerTimePeriod

n..7

M

Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3

M

Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10

M

Start des Zeitintervalls im Format DD.MM.YYYY

PeriodEnd

an10

M

Ende des Zeitintervalls im Format DD.MM.YYYY

CurrentRemainingBalanceAmount

n..7

M

Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3

M

Währung für das verbleibende Limit gemäß ISO 4217

Versandinformationen

BuyerName

a..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrName

a..50

O

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Bundesland der Lieferadresse

AddrCounty

a..50

O

Landkreis der Lieferadresse

AddrDistrict

a..50

O

Bezirk der Lieferadresse

AddrZip

an..20

O

Postleitzahl der Lieferadresse

AddrCity

a..50

O

Ortsname der Lieferadresse

AddrStreet

a..180

O

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Sonstige Zusätze

Rechnungsadresse

bdAddrName

a..50

O

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

ans..128

O

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Ländercode des Lieferlandes der Rechnungsadresse gemäß ISO 3166

bdAddrState

a..50

O

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

Bezirk der Rechnungsadresse

bdAddrZip

an..20

O

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

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

bdAddrStreet2

a..60

O

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

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:


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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

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

XID

an32

M

Vom Paygate vergebene ID der Autorisierung, für welche Details angefragt werden sollen

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

OrderDesc

ans..127

O

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

EventToken

enum

M

Abkürzung der auszuführenden Aktion:

<ATD> = AuthorizeDetails

Verschlüsselte Parameter zur Abfrage der Details einer Autorisierung mit Amazon Pay Recurring


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

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

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Open“, „Declined“, „Closed“. Details siehe Amazon API Reference Guide.

OrderID

ans..19

M

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

AmazonRefID

ans..27

M

Von Amazon vergebene eindeutige ID für die Transaktion

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Versandinformationen

BuyerName

a..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrName

a..50

O

Vorname und Nachname des Adressaten

PhoneNumber

a..128

O

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Bundesland der Lieferadresse

AddrCounty

a..50

O

Landkreis der Lieferadresse

AddrDistrict

a..50

O

Bezirk der Lieferadresse

AddrZip

a..20

O

Postleitzahl der Lieferadresse

AddrCity

a..50

O

Ortsname der Lieferadresse

AddrStreet

a..180

O

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Sonstige Zusätze

Rechnungsadresse

bdAddrName

a..50

O

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

a..128

O

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Ländercode des Rechnungslandes gemäß ISO 3166

bdAddrState

a..50

O

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

Bezirk der Rechnungsadresse

bdAddrZip

a..20

O

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

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

bdAddrStreet2

a..60

O

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

Sonstige Zusätze der Rechnungsadresse

Antwort-Parameter bei Abfrage der Details einer Autorisierung mit Amazon Pay Recurring



Amazon Pay Recurring: Buchungsdetails abfragen

Um die Details einer Buchung mit Amazon Pay Recurring abzufragen, 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:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

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

XID

an32

M

Vom Paygate vergebene ID der Buchung, für welche Details angefragt werden sollen

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

EventToken

enum

M

Abkürzung der auszuführenden Aktion:

<CAD> = CaptureDetails

Verschlüsselte Parameter zur Abfrage der Details einer Buchung mit Amazon Pay Recurring


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

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

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed“, „Closed“. Details siehe Amazon API Reference Guide.

OrderID

ans..19

M

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

AmazonRefID

ans..27

M

Von Amazon vergebene eindeutige ID für die Transaktion

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Antwort-Parameter bei Abfrage der Details einer Buchung mit Amazon Pay Recurring



Amazon Pay Recurring: Gutschriftdetails abfragen

Um die Details einer Gutschrift mit Amazon Pay Recurring abzufragen, 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:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

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

XID

an32

M

Vom Paygate vergebene ID der Gutschrift, für welche Details angefragt werden sollen

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

EventToken

enum

M

Abkürzung der auszuführenden Aktion:

<CRD> = CreditDetails

Verschlüsselte Parameter zur Abfrage der Details einer Gutschrift mit Amazon Pay Recurring


Folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

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

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Pending“, „Declined“, „Completed“, „Closed“. Details siehe Amazon API Reference Guide.

OrderID

ans..19

M

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

AmazonRefID

ans..27

M

Von Amazon vergebene eindeutige ID für die Transaktion

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Antwort-Parameter bei Abfrage der Details einer Gutschrift mit Amazon Pay Recurring



Amazon Pay Recurring: Kundenänderungen am Billing Agreement

Der Endkunde kann über das Kunden-Backend von Amazon Pay seine Zahlungsart und damit die Rechnungsadresse sowie die Lieferadresse ändern. Sie werden darüber per Notify an Ihre bei der Initialisierung des Billing Agreement angegebenen Notify URL informiert. Einen Request-Aufruf gibt es dafür nicht.

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

Folgende Tabelle beschreibt die Rückgabewerte, die das Paygate an Ihre URLNotify zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ans..30

O

Referenznummer des Händlers

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

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

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde

AmazonStatus

a..20

M

Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

AmountAuth

n..10

M

Gesamtbetrag, der bei Amazon reserviert wurde

AmountCap

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde

AmountCred

n..10

M

Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

BillingAgreementID

ans..64

M

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

AmountLimitPerTimePeriod

n..7

M

Von Amazon für das BillingAgreement festgesetztes Limit im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrencyLimitPerTimePeriod

a3

M

Währung für das festgesetzte Limit gemäß ISO 4217

PeriodStart

an10

M

Start des Zeitintervalls im Format DD.MM.YYYY

PeriodEnd

an10

M

Ende des Zeitintervalls im Format DD.MM.YYYY

CurrentRemainingBalanceAmount

n..7

M

Verbleibendes Limit für das BillingAgreement im angegebenen Intervall in der kleinsten Währungseinheit (z.B. EUR Cent)

CurrentRemainingBalanceCurrency

a3

M

Währung für das verbleibende Limit gemäß ISO 4217

NotificationType

a..25

M

Beschreibt die Art der Benachrichtigung. Fester Wert::<BillingNotification>

Versandinformationen

BuyerName

a..50

O

Teil der Benutzerprofil-Informationen. Benutzername

BuyerMail

as..128

O

Teil der Benutzerprofil-Informationen. E-Mail-Adresse

AddrName

a..50

O

Vorname und Nachname des Adressaten

PhoneNumber

ans..128

O

Telefonnummer des Adressaten

AddrCountryCode

a2

O

Ländercode des Lieferlandes gemäß ISO 3166

AddrState

a..50

O

Bundesland der Lieferadresse

AddrCounty

a..50

O

Landkreis der Lieferadresse

AddrDistrict

a..50

O

Bezirk der Lieferadresse

AddrZip

an..20

O

Postleitzahl der Lieferadresse

AddrCity

a..50

O

Ortsname der Lieferadresse

AddrStreet

a..180

O

Firmenname, wenn angegeben sonst Straßenname mit Hausnummer

AddrStreet2

a..60

O

Straßenname mit Hausnummer

AddrStreet3

a..60

O

Sonstige Zusätze

Rechnungsadresse

bdAddrName

a..50

O

Vorname und Nachname des Adressaten der Rechnungsadresse

bdPhoneNumber

ans..128

O

Telefonnummer des Adressaten der Rechnungsadresse

bdAddrCountryCode

a2

O

Ländercode des Lieferlandes der Rechnungsadresse gemäß ISO 3166

bdAddrState

a..50

O

Bundesland der Rechnungsadresse

bdAddrCounty

a..50

O

Landkreis der Rechnungsadresse

bdAddrDistrict

a..50

O

Bezirk der Rechnungsadresse

bdAddrZip

an..20

O

Postleitzahl der Rechnungsadresse

bdAddrCity

a..50

O

Ortsname der Rechnungsadresse

bdAddrStreet

a..180

O

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

bdAddrStreet2

a..60

O

Straßenname mit Hausnummer der Rechnungsadresse

bdAddrStreet3

a..60

O

Sonstige Zusätze der Rechnungsadresse

Rückgabe-Parameter an URLNotify nach Änderungen des Kunden am Billing Agreement