Über Amazon Pay

Allgemeines zu Amazon Pay

Amazon Pay ist eine schnelle, sichere und vertrauenswürdige Zahlungslösung, mit der Käufer ihre Amazon-Anmeldedaten verwenden können, um auf Ihrer Webseite Einkäufe zu tätigen. Durch die Integration von Amazon Pay können Sie ein nahtloses Checkout-Erlebnis bieten und die Konversionsraten erhöhen.

Kundenreise

  1. Produktauswahl und Kaufabwicklung: Der Käufer legt Produkte in seinen Einkaufswagen und geht zur Kaufabwicklung, indem er die Schaltfläche „Amazon Pay“ auswählt.
  2. Amazon-Anmeldung und Auswahl der Anmeldedaten: Der Käufer wird zur Anmeldeseite von Amazon weitergeleitet, um sich bei seinem Amazon-Konto anzumelden. Nach der Anmeldung wählt der Käufer seine bevorzugte Zahlungsmethode und Lieferadresse aus.
  3. Bestellung überprüfen: Der Käufer wird auf Ihre Website zurückgeleitet, um die Details seiner Bestellung zu überprüfen und sie bei Bedarf zu ändern.
  4. Bestellung aufgeben: Der Käufer bestätigt den Kauf, indem er auf „Bestellung aufgeben“ klickt. Der Käufer wird für eine eventuell erforderliche zusätzliche Authentifizierung zu Amazon weitergeleitet. Nach erfolgreicher Authentifizierung ist die Transaktion autorisiert.
  5. Auftragsbestätigung: Der Käufer wird zu Ihrer Auftragsbestätigungsseite zurückgeleitet.

 

Auf dieser Seite

Diagramm zum Prozessablauf



Amazon Pay akzeptieren

Führen Sie folgende Schritte, um Amazon Pay zu akzeptieren.

Wenn Sie mit Computop bereits Amazon Pay V1 integriert haben, können Sie Schritt 1 überspringen und direkt mit Schritt 2 fortfahren.

 

Schritt 1: Für Amazon Pay registrieren

  • Registrieren Sie sich unter https://pay.amazon.com/signup.
  • Sie können das Land auf der Anmeldeseite entsprechend Ihrem Geschäftsstandort ändern
  • Nach einer erfolgreichen Anmeldung können Sie sowohl Sandbox- als auch Produktionsumgebungen auf Ihrem Amazon Pay-Konto einrichten, indem Sie zwischen den beiden wechseln.


Schritt 2: MWS-Autorisierungs-Token erhalten

Das MWS-Autorisierungs-Token ist ein geheimes Token, mit dem sich Computop im Namen Ihres Shops mit Amazon verbinden kann. Es ist wichtig, dieses Token zu generieren und es in Ihrem Onboarding-Prozess anComputop Helpdesk zu geben.

Sschritte,um das MWS-Autorisierungs-Token zu generieren

  1. Gehen Sie zu den Einstellungen und wählen Benutzerberechtigungen.
  2. Auf der Seite Benutzerberechtigungen gehen Sie zum Abschnitt „Drittanbieterentwickler und Apps“ und klicken auf "Ihre Apps verwalten besuchen".
  3. Auf der Seite Ihre Apps verwalten  klicken Sie auf die Aktion "Neuen Entwickler autorisieren".
  4. Geben Sie den Entwicklernamen und die Entwickler-ID an. Nachstehende Anmeldeinformationen sind für die Einrichtung der Sandbox- und Produktionsumgebung identisch.
    1. Entwicklername: CT_Sandbox_EU
    2. Entwickler-ID: 0143-6461-8727
  5. Geben Sie auf der nächsten Seite Ihre Zustimmung. Nach Abschluss wird das MWS-Autorisierungs-Token generiert. Sie können es auch später auf der Seite „Ihre Apps verwalten“ anzeigen.



Schritt 3: Notify URL einrichten

Die Notify URL wird von Amazon für asynchrone Antworten an das Paygate für Vorgänge wie Buchungen und Gutschriften verwendet. Sie müssen die Paygate Notify URL für Ihren Shop im Konto Amazon Seller Central einrichten, um diese Benachrichtungen zu empfangen.

  1. Navigieren Sie zum Hamburger-Menü auf der linken Seite und wählen Integration → Integration Central
  2. Die Option IPN-Einstellungen finden Sie unten auf der Seite.
  3. Klicken Sie auf den Link „IPN-Einstellungen für Händler und Integratoren“. Aktualisieren Sie auf der Seite das Feld "Integrator URL" auf https://www.computop-paygate.com/amazonAPAV2Notify.aspx?mid=yourmerchantId&region=EU.
    Hinweis: Ersetzen Sie yourmerchantId mit der im Computop Paygate eingerichteten merchantId.



Schritt 4: Onboarding bei Computop für Amazon Pay

Um sich bei Computop für Amazon Pay anzumelden, geben Sie die folgenden Informationen an. Beachten Sie, dass die folgenden Informationen für jeden Markt erforderlich sind, in dem Sie präsent sind.

  1. Ländercode – Ländercode des Marktes.
  2. Händler-ID – Händler-ID aus Ihrem Amazon Seller Central-Konto.
  3. MWS-Autorisierungstoken – in Schritt 2 generiert.
  4. Store-Name – Name des Geschäfts.


Schritt 5: Schaltfläche Amazon Pay darstellen

Stellen Sie die Schaltfläche Amazon Pay auf Ihre Checkout-Seite dar. Verwenden Sie den folgenden Codeausschnitt als Referenz.

<body>
    <!-- This is the container where the Amazon Pay button will be rendered -->
    <div id="AmazonPayButton"></div>

    <!-- This script loads the Amazon Pay JavaScript SDK from Amazon's servers -->
    <script src="https://static-eu.payments-amazon.com/checkout.js"></script>

    <script type="text/javascript" charset="utf-8">
        // Render the Amazon Pay button within the 'AmazonPayButton' div.
        const amazonPayButton = amazon.Pay.renderButton('#AmazonPayButton', {
            merchantId: 'merchant_id',
            publicKeyId: 'SANDBOX-xxxxxxxxxx',
            ledgerCurrency: 'EUR',             
            checkoutLanguage: 'en_GB',
            productType: 'PayAndShip',
            placement: 'Cart',
            buttonColor: 'Gold',
            estimatedOrderAmount: { "amount": "109.99", "currencyCode": "EUR" }
        });

        // Event listener for when the Amazon Pay button is clicked
        amazonPayButton.onClick(function(){
            // Replace <<call_to_your_backend_function>> with your actual function
            // that makes a server-side call to your backend, which in turn communicates
            // with Paygate to get the 'payload', 'signature', and 'publicKeyId'
            const [payload, signature, publicKeyId] = <<call_to_your_backend_function>>();

            // Initialize the Amazon Pay checkout session with the fetched data above
            amazonPayButton.initCheckout({
                createCheckoutSessionConfig: {
                    payloadJSON: payload,
                    signature: signature,
                    publicKeyId: publicKeyId
                }
            });
        });
    </script>
</body>


Verwenden Sie die folgende Tabelle als Referenz für Schaltflächenparameter, die übergeben werden können, um die Schaltfläche nach Ihrem Bedarf darzustellen.

Parameter der Schaltfläche

CND

Beschreibung

Zulässige Werte

merchantId

M

Von Amazon ausgestellte Verkäufer-ID


ledgerCurrency

M

Ihre Hauptbuchwährung. Für EU-Konten kann bei der Authentifizierung/Buchungeine andere Darstellungswährung verwendet werden.


Zulässige Werte:

  • EU-Händler – 'EUR'

publicKeyId

M

Von Amazon bereitgestellter Key


placementMPlatzierung der Schaltfläche

Zulässige Werte:

Cart

buttonColor

O

Der Parameter buttonColor definiert die Farbe der Schaltfläche


Zulässige Werte:

Gold, LightGray, DarkGray

Standardwert 'Gold'

productTypeO

Der Parameter productType definiert, ob die Transaktion für physische oder digitale Güter erfolgt. PayAndShip ist Standard.


Zulässige Werte:

  • PayAndShip – physische Waren
  • PayOnly – digitale Güter

checkoutLanguage

O

Der Parameter checkoutLanguage dient optional zur Definition der Sprache des Checkout-Prozesses. Dies ist insbesondere in einer mehrsprachigen Shop-Umgebung hilfreich.

Ohne Angabe des Parameters Language verwendet Amazon automatisch die am besten geeignete Sprache für den Checkout.

Zulässige Werte:

  • EU/UK-Händler – 'en_GB', de_DE', 'fr_FR', 'it_IT', 'es_ES'




Paygate-Schnittstelle

Definitionen

Datenformate

FormatBeschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

ISODateTime (JJJJ-MM-TTThh:mm:ss)


Abkürzungen

AbkürzungBeschreibungKommentar

CND

Bedingung (condition)


M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich

C

bedingt (conditional)

Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist


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


Schritt 6: Integration mit der Paygate-Schnittstelle

Integrieren Sie Ihr Backend mit der Paygate-Schnittstelle, um die Nutzlast abzurufen und die Checkout-Sitzung mit Amazon initialisieren zu können. Um eine Zahlung mit Amazon Pay zu initialisieren, verwenden Sie bitte folgende URL:

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


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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Beschreibung
CountryCodean2MLändercode des verwendeten Marktplatzes. Optionen EU, US und JP.

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDBeschreibung
Currency

a3

M

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

Key

Format

CND

Beschreibung
URLSuccessans..256MDer Käufer wird zu dieser URL weitergeleitet, wenn die Aktion erfolgreich war
URLFailureans..256MDer Käufer wird zu dieser URL weitergeleitet, wenn die Aktion nicht erfolgreich war

KeyFormatCNDBeschreibung
URLNotify

ans..256

M

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData.

(info) Allgemeine Hinweise:

  • Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.
  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key

Format

CND

Beschreibung
URLCancelans..256MDer Käufer wird zu dieser URL weitergeleitet, wenn der Vorgang abgebrochen wird

ShopUrl

ans..256

M

Bestellüberprüfungsseite, auf die der Kunde weitergeleitet wird, nachdem er das bevorzugte Zahlungsmittel und optional die Lieferadresse auf der von Amazon Pay gehosteten Seite bestätigt hat
TxTypean..20C

Zahlungsablauf für die Belastung des Käufers. Unterstützte Werte:

  • 'AuthorizeWithCapture' – Sofortiges Autorisieren und Einziehen von Geldern ist die Standardeinstellung
  • 'Authorize' – Gelder sofort autorisieren und zu einem späteren Zeitpunkt buchen
LocalCurrencya3CDie Währung, die dem Käufer in Rechnung gestellt wird, im ISO-4217-Format. Nur möglich für Amazon EU- und UK-Märkte.
Scopea..128O

Die Käuferdetails, auf die Sie Zugriff anfordern. Mögliche Werte:

  • "name"
  • "email"
  • "phoneNumber"
  • "billingAddress"

Wenn nicht enthalten, werden alle Käuferinformationen angefordert.

ChDescans..16CNur für Sale-Transaktionen: AuthorizeWithCapture.
Standardwert: "AMZ*<SELLER_NAME> pay.amazon.com"

OrderDesc

ans..127

O

Verwenden Sie diesen Parameter für den Simulationsmodus. Im Live-Modus hat dieser Parameter keine Auswirkungen.

AmazonpaySimulationCode

ans..

O

Ein Parameter, der verwendet wird, um während des Tests bestimmte Zahlungsszenarien oder -verhalten zu simulieren. Eine vollständige Liste der zulässigen Simulationscodes finden Sie in der Amazonpay Dokumentation.

Verschlüsselte Parameter zum Initialisieren einer Zahlung mit Amazon Pay


Adressbeschränkung

Händler können Beschränkungen festlegen, ob Adressen, die der Beschränkungskonfiguration entsprechen, beschränkt werden sollen oder nicht.

Um eine Adressbeschränkung zu senden, verwenden Sie den Parameter addressRestriction – json base64-codiert. Nachfolgend finden Sie die Übersicht der Datenelemente und das Schema:

Key

Format

CND

Beschreibung

type

string

C

Gibt an, ob Adressen, die der Einschränkungskonfiguration entsprechen, eingeschränkt werden sollen oder nicht.

Unterstützte Werte: 

  • „Allowed“ – Adressen, die der Einschränkungskonfiguration nicht entsprechen, als eingeschränkt markieren
  • „NotAllowed“ – Adressen, die der Einschränkungskonfiguration entsprechen, als eingeschränkt markieren

restriction

<countryCode:restriction>

C

Einschränkungen auf Länderebene, die bestimmen, welche Adressen basierend auf dem Typparameter eingeschränkt werden sollen oder nicht.

CountryCode ist eine Zeichenfolge, die den Ländercode der Adresse im ISO 3166-Format darstellt.

statesOrRegions: Liste der länderspezifischen Bundesstaaten, die basierend auf dem Typparameter eingeschränkt werden sollen oder nicht

zipCodes: Liste der länderspezifischen Postleitzahlen, die basierend auf dem Typparameter eingeschränkt werden sollen oder nicht



Schema

{ "type": "Allowed", 
  "restrictions": { "US":{ "statesOrRegions": ["WA"], "zipCodes": ["95050", "93405"] }, 
                    "GB":{ "zipCodes": ["72046", "72047"] },
                    "IN":{ "statesOrRegions": ["AP"] },
                    "JP": {} 
                  } 
}
The above data should be base64 encoded and passed in the parameter
addressRestriction=
eyAidHlwZSI6ICJBbGxvd2VkIiwgInJlc3RyaWN0aW9ucyI6IHsgIlVTIjoKCnsgInN0YXRlc09yUmVnaW9ucyI6IFsiV0EiXSwgInppcENvZGVzIjogWyI5NTA1MCIsICI5MzQwNSJdIH0KCiwgIkdCIjoKCnsgInppcENvZGVzIjogWyI3MjA0NiIsICI3MjA0NyJdIH0KCiwgIklOIjoKCnsgInN0YXRlc09yUmVnaW9ucyI6IFsiQVAiXSB9CgosICJKUCI6IHt9IH0gfQ==



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

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

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

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Key

Format

CND

Beschreibung

buttonsignature

ans..256MSignatur für die Amazon-Schaltfläche

buttonpayload

ans..256MPayload für die Amazon-Schaltfläche

buttonpublickeyid

ans..256MPublic-Key-ID für die Amazon-Schaltfläche

Zwischen-Antwortparameter nach dem Initialisieren einer Zahlung mit Amazon Pay


Schritt 7: Überprüfungsseite darstellen

Sobald Sie die Checkout-Sitzung mit Amazon Pay mit der erweiterten Nutzlast initialisiert haben, wird der Kunde zu Amazon weitergeleitet, um sich anzumelden und Zahlungsmethode und Versanddaten auszuwählen. Sobald der Kunde den Schritt abgeschlossen hat, sendet Computop die Zahlungsmethode und die Versanddetails an die ShopUrl, die Sie in der ursprünglichen Anfrage übergeben haben. Verwenden Sie diese Daten, um die Überprüfungsseite in Ihrem Shop darzustellen.


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

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

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

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key

Format

CND

Beschreibung

Status

a..50

M

PENDING

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

AmountAuth

n..10MGesamtbetrag, der bei Amazon reserviert ist

AmountCap

n..10MGesamtbetrag, der bereits erfolgreich bei Amazon gebucht wurde

AmountCred

n..10MGesamtbetrag, der bereits erfolgreich bei Amazon gutgeschrieben wurde

bdAddrName

ans..30CRechnungsadresse – Kundenname

bdAddrStreet

a..32CRechnungsadresse – Straße und Hausnummer

bdAddrZip

n..5CRechnungsadresse – Postleitzahl

bdAddrCity

a..32CRechnungsadresse – Ort

bdAddrState

a..32CRechnungsadresse – Bundesstaat

bdAddrCountrycode

a2CRechnungsadresse – alphabetischer Ländercode

bdPhoneNumber

ans..20CRechnungsadresse – Telefonnummer

AddrName

ans..30CLieferadresse – Kundenname

AddrStreet

a..32CLieferadresse – Straße und Hausnummer

AddrStreet2

a..32CLieferadresse – Zeile 2

AddrStreet3

a..32CLieferadresse – Zeile 3

AddrZip

n..5CLieferadresse – Postleitzahl

AddrCity

a..32CLieferadresse – Ort

AddrState

a..32CLieferadresse – Bundesstaat

AddrCountrycode

a2CLieferadresse – alphabetischer Ländercode

PhoneNumber

ans..20CLieferadresse – Telefonnummer
buyerId

ans..42

MEindeutige Käuferkennung bei Amazon Pay
buyerName

ans..50

MKäufername
buyerEmail

ans..64

ME-Mail-Adresse des Käufers
buyerPhonenumber

ans..20

MTelefonnummer des Käufers
AmazonMerchantid

ans..

MAmazon Händler-ID
RTF

ans..

M

einmalig – einzelne Bestellung

wiederkehrend – wiederkehrende Bestellung

AmazonStatus

a..50

MOPEN
AmazonpayRedirectUrl

ans..256

MVon Amazon Pay bereitgestellte URL
AmazoncheckoutSessionid

ans..32

MCheckout-Sitzungs-ID von Amazon
AmazonPaymentDescriptor

ans..64

MZahlungsdeskriptor, z.B.: „Visa ****1111 (Amazon Pay)“

 


Schritt 8: Zahlungs- und Versandaktualisierung aktivieren

Auf der Überprüfungsseite sollte der Kunde bei Bedarf seine Zahlungsmethode und Versanddetails aktualisieren können.

Verwenden Sie amazon.Pay.bindChangeAction(), um Klickereignisse an HTML-Elemente auf Ihrer Seite zu binden. Mit dem Parameter changeAction können Sie angeben, ob der Käufer die Versandadresseoder die Zahlungsmethode bearbeitet. Nachfolgend finden Sie die JavaScript-Beispiele zu Ihrer Information. Ausführliche Informationen finden Sie in der Amazon-Dokumentation.

Adresse ändern

<script type="text/javascript" charset="utf-8">
  amazon.Pay.bindChangeAction('#changeButton1', {
    amazonCheckoutSessionId: 'xxxx',
    changeAction: 'changeAddress'
  });
</script>

Zahlungsmitel ändern

<script type="text/javascript" charset="utf-8">
  amazon.Pay.bindChangeAction('#changeButton2', {
    amazonCheckoutSessionId: 'xxxx',
    changeAction: 'changePayment'
  });
</script>


Schritt 9: Betragsänderungen unterstützen

Wenn es während der Überprüfung zu Betragsänderungen kommt, z. B. zu einer Betragsänderung aufgrund zusätzlicher Versandkosten, oder wenn Sie Warenkorb-Updates auf der Überprüfungsseite unterstützen, müssen die Informationen sowohl im Paygate als auch im Amazon-System aktualisiert werden.

Um den Betrag bei Amazon Pay zu ändern, verwenden Sie bitte folgende URL:

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


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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung
PayID

an32

M

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

Key

Format

CND

Beschreibung
EventTokenenumMFester Wert: UpdateAuthorizeAmount

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDBeschreibung
Currency

a3

M

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

Key

Format

CND

Beschreibung
CountryCodean2MLändercode des verwendeten Marktplatzes. Optionen EU, US und JP.

Parameter zum Ändern des Betrags einer Amazon-Pay-Zahlung


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

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

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

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

Key

Format

CND

Beschreibung

Status

a..50

M

AUTHORIZE_REQUEST

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

AmountAuth

n..10MGesamtbetrag, der bei Amazon reserviert ist

AmountCap

n..10MGesamtbetrag, der bereits erfolgreich bei Amazon gebucht wurde

AmountCred

n..10MGesamtbetrag, der bereits erfolgreich bei Amazon gutgeschrieben wurde

Antwort-Parameter zum Ändern des Betrags einer Amazon-Pay-Zahlung

Hinweis: Stellen Sie sicher, dass Sie die letzte Schaltfläche „Bezahlen“ erst darstellen oder aktivieren, wenn Sie eine erfolgreiche Antwort für das Ereignis „UpdateAuthorizeAmount“ erhalten haben.


Schritt 10: Kaufabwicklung abschließen

Aktivieren Sie die letzte Schaltfläche „Bezahlen“, damit der Kunde die Kaufabwicklung bei Amazon abschließen kann. Nach erfolgreichem Abschluss gibt Ihnen das Paygate eine Antwort an URLSuccess/URLFailure und URLNotify. Nachfolgend finden Sie die Parameter dieser Antwort.

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key

Format

CND

Beschreibung

Status

a..50

M

OK

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

AmountAuth

n..10MGesamtbetrag, der bei Amazon reserviert ist

AmountCap

n..10MGesamtbetrag, der bereits erfolgreich bei Amazon gebucht wurde

AmountCred

n..10MGesamtbetrag, der bereits erfolgreich bei Amazon gutgeschrieben wurde. Der Betrag für die Zahlung beträgt Null.

bdAddrName

ans..30CRechnungsadresse – Kundenname

bdAddrStreet

a..32CRechnungsadresse – Straße und Hausnummer

bdAddrZip

n..5CRechnungsadresse – Postleitzahl

bdAddrCity

a..32CRechnungsadresse – Ort

bdAddrState

a..32CRechnungsadresse – Bundesstaat

bdAddrCountrycode

a2CRechnungsadresse – alphabetischer Ländercode

bdPhoneNumber

ans..20CRechnungsadresse – Telefonnummer

AddrName

ans..30CLieferadresse – Kundenname

AddrStreet

a..32CLieferadresse – Straße und Hausnummer

AddrZip

n..5CLieferadresse – Postleitzahl

AddrCity

a..32CLieferadresse – Ort

AddrState

a..32CLieferadresse – Bundesstaat

AddrCountrycode

a2CLieferadresse – alphabetischer Ländercode

PhoneNumber

ans..20CLieferadresse – Telefonnummer
buyerId

ans..42

MEindeutige Käuferkennung bei Amazon Pay
buyerName

ans..50

MKäufername
buyerEmail

ans..64

ME-Mail-Adresse des Käufers
buyerPhonenumber

ans..20

MTelefonnummer des Käufers
AmazonMerchantid

ans..

MAmazon Händler-ID
RTF

ans..

M

einmalig – einzelne Bestellung

wiederkehrend – wiederkehrende Bestellung

chargeid

ans..

M

Von Amazon zugewiesene Charge-ID

chargepermissionid

ans..

M

Von Amazon zugewiesene Charge-Permission-ID

AmazonStatus

a..50

MCompleted
AmazonpayRedirectUrl

ans..256

MVon Amazon Pay bereitgestellte URL
AmazoncheckoutSessionid

ans..32

MCheckout-Sitzungs-ID von Amazon

Finale Antwortparameter für eine Amazon-Pay-Zahlung


Zahlung buchen


Mehrfache Teilbuchungen werden derzeit nicht unterstützt.

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

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


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

 

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:


KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDBeschreibung
Currency

a3

M

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDBeschreibung
ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key

Format

CND

Beschreibung
ChDescans..16OText der auf der Abrechnung des Kreditinstituts des Kunden erscheint
OrderDescans..127ONutzen Sie diesen Parameter für den Simulationsmodus. Im Livebetrieb hat dieser Parameter keine Auswirkungen.

AmazonpaySimulationCode

ans..

O

Ein Parameter, der verwendet wird, um während des Tests bestimmte Zahlungsszenarien oder -verhalten zu simulieren. Eine vollständige Liste der zulässigen Simulationscodes finden Sie in der Amazonpay Dokumentation.

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


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

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

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

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung
CodeExtans..10OFehlercode von Amazon, wenn übergeben
ErrorTextas..1024OFehlerbeschreibung von Amazon, wenn diese übergeben wurde

chargeid

ans..256MAmazon Pay Charge ID
AmazonStatusa..20MBestellstatus bei Amazon. Folgende Werte sind möglich: „Opened“, „Completed, „Canceled“. Details siehe  Amazon API Reference Guide.

chargepermissionid

ans..256MAmazon Pay Permission ID

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDBeschreibung
Currency

a3

M

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

Key

Format

CND

Beschreibung
AmountAuthn..10MGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

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


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

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung
CodeExtans..10OFehlercode von Amazon, wenn übergeben
ErrorTextas..1024OFehlerbeschreibung von Amazon, wenn diese übergeben wurde

chargeid

ans..256MAmazon Pay Charge ID
AmazonStatusa..20MBestellstatus bei Amazon. Folgende Werte sind möglich: „Opened“, „Completed, „Canceled“. Details siehe  Amazon API Reference Guide.

chargepermissionid

ans..256MAmazon Pay Permission ID
OrderIDans..19MVon Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefIDans..27MVon Amazon vergebene eindeutige ID für die Transaktion

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDBeschreibung
Currency

a3

M

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

Key

Format

CND

Beschreibung
AmountAuthn..10MGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
NotificationTypea..25MBeschreibt die Art der Benachrichtigung. Fester Wert: <CaptureNotification>

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


Zahlung gutschreiben


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

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

 

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDBeschreibung
Currency

a3

M

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDBeschreibung
ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key

Format

CND

Beschreibung
OrderDescans..127OBeschreibung der gekauften Waren, Einzelpreise etc. für die Gutschrift

AmazonpaySimulationCode

ans..

O

Ein Parameter, der verwendet wird, um während des Tests bestimmte Zahlungsszenarien oder -verhalten zu simulieren. Eine vollständige Liste der zulässigen Simulationscodes finden Sie in der Amazonpay Dokumentation.

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


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

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

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

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung
CodeExtans..10OFehlercode von Amazon, wenn übergeben
ErrorTextas..1024OFehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatusa..20MBestellstatus bei Amazon. Folgende Werte sind möglich: „Opened“, „Completed, „Canceled“. Details siehe  Amazon API Reference Guide.
chargeidans..256MAmazon Pay Charge ID
refundidans..256MAmazon Pay Refund ID

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDBeschreibung
Currency

a3

M

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

Key

Format

CND

Beschreibung
AmountAuthn..10MGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

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


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

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung
CodeExtans..10OFehlercode von Amazon, wenn übergeben
ErrorTextas..1024OFehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatusa..20MBestellstatus bei Amazon. Folgende Werte sind möglich: „Opened“, „Completed, „Canceled“. Details siehe  Amazon API Reference Guide.
chargeidans..256MAmazon Pay Charge ID
refundidans..256MAmazon Pay Refund ID

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDBeschreibung
Currency

a3

M

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

Key

Format

CND

Beschreibung
AmountAuthn..10MGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
NotificationTypea..25MBeschreibt die Art der Benachrichtigung. Fester Wert: <CreditNotification>

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


Bestellung stornieren


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

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

 

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Beschreibung
Reasona..1024OGrund der Stornierung

KeyFormatCNDBeschreibung
ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

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


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

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

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

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

CodeExt

ans..10

O

Fehlercode von Amazon, wenn übergeben

ErrorText

as..1024

O

Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatusa..20MBestellstatus bei Amazon. Folgende Werte sind möglich: „Opened“, „Completed, „Canceled“. Details siehe  Amazon API Reference Guide.
chargeidans..256MAmazon Pay Charge ID
chargepermissionidans..256MAmazon Pay Permission ID

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDBeschreibung
Currency

a3

M

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

Key

Format

CND

Beschreibung
AmountAuthn..10MGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Antwort-Parameter nach Stornierung einer Amazon-Pay-Zahlung


Einrichtung wiederkehrender Zahlungen

Um eine wiederkehrende Zahlung mit Amazon Pay einzurichten, übermitteln Sie zusätzlich zu der in Schritt 6 oben beschriebenen Standardanfrage die folgenden Daten.

Anfangszahlung

Key

Format

CND

Beschreibung

RTFans1MI = Anfangszahlung einer Serie
cyclean..7MZyklus. Unterstützte Werte: 'Year', 'Month', 'Week', 'Day', 'Variable'
Valuen..4M

Anzahl der Frequenzeinheiten pro Abrechnungszyklus. Um beispielsweise einen wöchentlichen Zyklus anzugeben, legen Sie die Einheit auf Week und den Wert auf 1 fest. Wenn Sie eine variable Einheit verwenden, müssen Sie den Wert auf 0 setzen.

  • Year: 1-3
  • Month: 1-36
  • Week: 1-57
  • Day: 1-1095
InstallmentAmountn..10CTransaktionsbetrag – wählen Sie Null, wenn es sich nicht um einen festen Betrag handelt
Currencya3CTransaktionswährungscode im Format ISO 4217, zum Beispiel: EUR


Wiederkehrende Zahlung

Key

Format

CND

Beschreibung

RTFans1MR = Recurring (wiederkehrend)
Amount

n..10

M

Aktualisierter Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDBeschreibung
Currency

a3

M

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

Key

Format

CND

Beschreibung

CountryCodean2MLändercode des verwendeten Marktplatzes. Optionen: EU, US und JP.
ChargePermissionIdans..256MCharge Permission ID, die Sie in der Antwort auf die Anfangszahlung in der Serie erhalten haben