Amazon Pay Checkout v2

Amazon Cv.2

Anmerkung

Ländercode*

Code des verwendeten Amazon-Marktes (DE=EU, UK, JP und US)

MerchantID

aus der Amazon Verkäuferzentrale

MWS Autorisierungs-Token

Beispiel: amzn.mws.a4a8d852-3d9e-f441-0674-d042baa3cf6452

merchant Store Name

Name des Geschäfts

StoreID

Beispiel: amzn1.application-oa2-client.7150fff45acf49f8acd519fa485142a2

Step

Beschreibung

1

Schaltfläche Amazon Pay anzeigen

Die Schaltfläche Amazon Pay muss auf der Seite des Webshops ordnungsgemäß implementiert sein und bei jedem Zahlungsvorgang aufgerufen werden. Nachfolgend finden Sie das Code-Snippet als Beispiel.

2

Zahlung über amazonAPA.aspx initialisieren (Server-zu-Server)

Sie rufen den Paygate-Endpunkt https://www.computop-paygate.com//amazonapa.aspx gemäß nachstehender Beschreibung auf.

Das Paygate antwortet mit Parametern, mit denen Sie die Schaltfläche Amazon Pay aktualisieren müssen.

3

Weiterleitung zu Amazon

Nach dem Aktualisieren der Schaltfläche Amazon Pay wird der Kunde zu Amazon weitergeleitet.

4

Redirect zurück zu Ihrem Webshop

Nach Bestätigung des bevorzugten Zahlungsmittels des Kunden und optional der Lieferadresse auf der von Amazon Pay gehosteten Seite wird der Kunde zur Bestellübersichtsseite in Ihrem Webshop zurückgeleitet.

5

Abschluss des Kaufes

Nachdem der Kunde die Bestellung bestätigt hat, leiten Sie ihn an die Amazon-URL weiter, die Sie als Antwort vom Paygate erhalten haben.

6

Redirect zurück zu Ihrem Webshop

Nachdem der Kunde die Zahlung auf der Amazon-Seite abgeschlossen hat, wird er basierend auf dem Ergebnis der Zahlung (URLSuccess / URLFailure) zu Ihrer definierten URL zurückgeleitet.

7

Benachrichtigung von Computop wird per S2S gesendet

Stellen Sie bitte sicher, dass Sie die NotifyURL einrichten und verwenden, um eine endgültige Bestätigung über den Erfolg/Fehler der Anfrage zu erhalten.

Parameter

Beschreibung

Wert

merchantId

Von Amazon vergebene SellerId

ledgerCurrency

Ihre Hauptbuchwährung. Für EU/UK-Konten kann eine andere Darstellungswährung für die Authentifizierung/Buchung verwendet werden.

Zulässige Werte:

• US-Händler ‒ 'USD'

• EU-Händler ‒ 'EUR'

• UK-Händler ‒ 'GBP'

• JP-Händler ‒ 'JPY'

placement

Platzierung der Schaltfläche

Zulässige Werte: Cart

buttonColor

Der Parameter buttonColor definiert die Farbe der Schaltfläche

Zulässige Werte: Gold, LightGray, DarkGray

productType

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

Zulässige Werte:

• PayAndShip ‒ physische Waren

• PayOnly ‒ digitale Güter

checkoutLanguage

Der Parameter checkoutLanguage ist optional, um die Sprache im Checkout-Prozess festzulegen. Das ist insbesondere in einer mehrsprachigen Shopumgebung hilfreich.

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

Zulässige Werte:

• US-Händler ‒ 'en_US'

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

• JP-Händler ‒ 'ja_JP'

estimatedOrderAmount

Dies ist der geschätzte Bestellbetrag an der Kasse. Er muss nicht mit dem endgültigen Bestellbetrag übereinstimmen, wenn der Käufer seine Bestellung nach dem Start der Kasse aktualisiert. Amazon Pay verwendet diesen Wert, um das Transaktionsrisiko einzuschätzen und zu verhindern, dass Käufer Zahlungsmethoden auswählen, die nicht zur Bearbeitung der Bestellung verwendet werden können.

Verwenden Sie updateButtonInfo(), um den estimatedOrderAmount zu aktualisieren, wenn sich der geschätzte Bestellwert ändert, z. B. wenn der Käufer etwas aus seinem Warenkorb entfernt oder ihm etwas hinzufügt. Diese Funktion kann die Benutzeroberfläche der Schaltfläche aktualisieren und der neue estimatedOrderAmount wird verwendet, um festzustellen, ob die Bestellung den Mindestbestellwert des Ratenzahlungsanbieters trifft.

Funktion Beispiel:

<script type="text/javascript" charset="utf-8">         

amazonPayButton.updateButtonInfo({"amount":"120.99","currencyCode":"USD"});

</script>

Beispiel:

{ "amount": "50.99", "currencyCode":"USD"},

Format

Beschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

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

Abkürzung

Beschreibung

Kommentar

CND

Bedingung (condition)

M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

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

C

bedingt (conditional)

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

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

CountryCode

an2

M

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

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.

Currency

a3

M

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

URLSuccess

ans..256

M

Der Käufer wird zu dieser URL weitergeleitet, wenn die Aktion erfolgreich war

URLFailure

ans..256

M

Der Käufer wird zu dieser URL weitergeleitet, wenn die Aktion nicht erfolgreich war

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. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

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.

URLCancel

ans..256

M

Der 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

TxType

an..20

C

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

• 'AuthorizeWithCapture' – Sofortiges Autorisieren und Einziehen von Geldern ist die Standardeinstellung

• 'Authorize' – Gelder sofort autorisieren und zu einem späteren Zeitpunkt buchen

LocalCurrency

a3

C

Die Währung, die dem Käufer in Rechnung gestellt wird, im ISO-4217-Format. Nur möglich für Amazon EU- und UK-Märkte.

Scope

a..128

O

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

• "name"

• "email"

• "phoneNumber"

• "billingAddress"

Wenn nicht enthalten, werden alle Käuferinformationen angefordert.

ChDesc

ans..16

C

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

Recurring (wiederholte Zahlungen)

RTF

ans1

O

Bei wiederholten Zahlungen (Abonnements): I = Erstzahlung einer Reihe von Zahlungen. Standard ist OTP, einmalige Zahlung.

cycle

an..7

C

Zyklus. Unterstützte Werte: 'Jahr', 'Monat', 'Woche', 'Tag', 'Variabel'

Value

n..4

C

Anzahl der Frequenzeinheiten pro Abrechnungszeitraum. Um beispielsweise einen wöchentlichen Zyklus anzugeben, setzen Sie die Einheit auf Woche und den Wert auf 1. Sie müssen den Wert auf 0 setzen, wenn Sie eine variable Einheit verwenden..

• Jahr: 1-3

• Monat: 1-36

• Woche: 1-57

• Tag: 1-1095

InstallmentAmount

n..10

C

Transaktionsbetrag – wählen Sie Null, wenn es sich nicht um einen festen Betrag handelt

currency

a3

C

Währungscode der Transaktion im Format ISO 4217. Beispiel: EUR

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

buttonsignature

ans..256

M

Signatur für die Amazon-Schaltfläche

buttonpayload

ans..256

M

Payload für die Amazon-Schaltfläche

buttonpublickeyid

ans..256

M

Public-Key-ID für die Amazon-Schaltfläche

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

an8

M

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

RTF

ans1

O

Einmalig oder wiederkehrend. Bei wiederholten Zahlungen (Abonnements): I = Erstzahlung einer Reihe von Zahlungen.

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 in Batch-Dateien sowie im Capture- oder Credit-Request.

TransID

ans..64

M

Ihre eigene 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 Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

ChDesc

ans..16

O

Text der auf der Abrechnung des Kreditinstituts des Kunden erscheint

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.

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

an8

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

chargeid

ans..256

M

Amazon Pay Charge ID

AmazonStatus

a..20

M

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

chargepermissionid

ans..256

M

Amazon Pay Permission ID

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.

Currency

a3

M

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

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

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

an8

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

chargeid

ans..256

M

Amazon Pay Charge ID

AmazonStatus

a..20

M

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

chargepermissionid

ans..256

M

Amazon Pay Permission ID

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 Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

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

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>

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 in Batch-Dateien sowie im Capture- oder Credit-Request.

TransID

ans..64

M

Ihre eigene 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 Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

OrderDesc

ans..127

M

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

chargeid

ans..256

M

Amazon Pay Charge ID

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.

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

an8

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

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

chargeid

ans..256

M

Amazon Pay Charge ID

refundid

ans..256

M

Amazon Pay Refund ID

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.

Currency

a3

M

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

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

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

an8

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

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

chargeid

ans..256

M

Amazon Pay Charge ID

refundid

ans..256

M

Amazon Pay Refund ID

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.

Currency

a3

M

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

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>

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 in Batch-Dateien sowie im Capture- oder Credit-Request.

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

Reason

a..1024

O

Grund der Stornierung

chargeid

ans..256

M

Amazon Pay Charge ID

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.

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

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

an8

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

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

chargeid

ans..256

M

Amazon Pay Charge ID

chargepermissionid

ans..256

M

Amazon Pay Permission ID

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.

Currency

a3

M

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

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