1.2 Konfiguration für Amazon Pay
1.4 Schaltfläche Amazon Pay integrieren
1.6 Diagramm zum Prozessablauf”
2.2 Amazon Pay Schnittstelle initialisieren
2.4 Amazon Pay Zahlung gutschreiben
2.5 Amazon Pay Bestellung stornieren
3 Amazon Pay Cv2 Additional Payment Button
3.2 Diagramm zum Prozessablauf
3.3 Schaltfläche Amazone Pay integrieren
Amazon Pay bietet Käufern eine sichere, vertrauenswürdige und bequeme Möglichkeit, sich anzumelden und ihre Einkäufe auf Ihrer Website zu bezahlen, indem sie ihre Amazon-Anmeldeinformationen verwenden. Siehe Browser-Support für Information über die von Amazon Pay unterstützten Betriebssysteme, Browser und Browserversionen.
Diese Anleitung bietet einen Überblick über das Käufererlebnis und zeigt Ihnen, wie Sie die neueste Checkout-Technologie von Amazon Pay integrieren können.
Das Checkout-Erlebnis von Amazon Pay
1. Der Käufer klickt auf die Amazon-Pay-Schaltfläche, um den Checkout zu starten.
2. Der Käufer meldet sich an, bestätigt sein bevorzugtes Zahlungsinstrument und wählt optional eine Lieferadresse auf der Amazon Pay gehosteten Seite aus.
3. Der Käufer wird zur Bestätigung auf Ihre Bestellübersichtsseite zurückgeleitet.
4. Der Käufer schließt den Checkout auf der von Amazon Pay gehosteten Seite ab, indem er auf die Aufforderung zur Multi-Faktor-Authentifizierung (Identitätsprüfung) antwortet, falls er dazu aufgefordert wird, oder indem er eine andere Zahlungsmethode auswählt, wenn die Zahlung abgelehnt wurde.
5. Amazon Pay leitet den Läufer auf Ihre Bestätigungsseite zurück.
Logo
Info | Typ |
| “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. | Zahlungen per eWallet |
Weitere Informationen finden Sie auch auf der:
Es gibt zwei nutzbare Optionen, je nachdem, ob Sie ein neuer oder ein bestehender Kunde sind.
Bereits bestehende Kunden müssen sich bei ihren Konten anmelden und einen neuen Satz von API-Schlüsseln erzeugen, die mit Amazon Pay Checkout Version.2 verwendet werden.
Wir haben bereits die erforderlichen Daten für Ihre Konten für den ursprüngliche Checkout v.1 erzeugt.
Bitte beachten Sie unten die “Anleitung zum Erstellen von API-Schlüsseln”.
Vor der Nutzung von Amazon Pay müssen Sie sich unter https://pay.amazon.de/signup registrieren.
Eine Alternative ist die Anmeldung bei Amazon basierend auf dem Land mit folgenden Schritten;
Wenn Sie an der Amazon Verkäuferzentrale angemeldet sind, sollten Sie 2 Konten haben, zwischen denen Sie umschalten können:
Die erforderlichen Daten für das Onboarding sind die folgenden:
| 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 |
Bitte befolgen Sie nachstehende Anleitung, um die nötigen API-Schlüssel zu erzeugen.
Wichtig: Wenn Sie die Option zum Erzeugen von API-Schlüsseln nicht sehen, müssen Sie zuerst einen Shop anlegen und dann die API-Schlüssel erzeugen.
Unter der “Integrationszentrale” ganz unten können Sie dies über den dortigen Link tun:
Ein wichtiger Teil der nötigen Daten ist das MWS Autorisierungs-Token von Amazon, das 1cs OBS die Erlaubnis gibt, Transaktionen für Ihren Shop durchzuführen.
Der zweite Schritt ist das Generieren eines MWS Auth Token. Das sind die benötigten Daten:
Deutsch/EU:
United Kingdom/Großbritannien:
Wenn Sie in der Verkäuferzentrale von Amazon angemeldet sind, gehen Sie oben rechts auf die Seite, klicken auf Einstellungen und wählen “Benutzerberechtigungen”:
Dies führt Sie zur Seite “Benutzerberechtigungen”, die Ihnen die aktuellen Benutzer anzeigt. Hier können Sie Ihrem Konto einen externen Entwickler hinzufügen und klicken dafür bitte auf “Ihre Apps verwalten öffnen”:
Dies führt zu einer neuen Seite, auf der Sie Entwickler sehen können, die Zugriff haben. Hier können Sie Berechtigungen hinzufügen, löschen und erneuern. Bitte klicken Sie auf “Neuen Entwickler autorisieren”:
Auf der neuen Seite müssen Sie den oben angegebenen Entwicklernamen und die ID hinzufügen. Füllen Sie die Informationen aus und klicken auf “Weiter”:
Auf der letzten Seite müssen Sie den Geschäftsbedingungen zustimmen, um einem Entwickler Zugriff auf das Konto zu gewähren.
Wenn Sie auf „Weiter“ klicken, wird eine Erfolgsseite mit Informationen angezeigt:
Mit dem letzten Klick auf „Weiter“ gelangen Sie zurück zur ursprünglichen „Benutzerberechtigung“, wo nun der Entwickler angezeigt wird:
Hier können Sie nun auf „Anzeigen“ klicken und auf den „MWS Authorization Token“ zugreifen und diesen auch kopieren.
Dann senden Sie das erhaltene MWS Autorisierungs-Token auf einem sicheren Weg an den Helpdesk zur Konfiguration.
Um neue API-Schlüssel zu erzeugen, wählen Sie oben auf der Seite eines Ihrer Konten aus, entweder Produktion oder Sandbox. Der Vorgang muss für beide Konten durchgeführt werden. Die Amazon-Beschreibung finden Sie hier.
Klicken Sie bitte links auf das Symbol mit den 3 horizontalen Strichen.
Im erscheinenden Menü gehen Sie bitte zu “Integration” und wählen “Integrationszentrale”.
In der Integrationszentrale gehen Sie zum Abschnitt “API-Schlüssel erzeugen” und klicken dort auf die Schaltfläche.
Es erscheint ein Popup-Fenster, in dem Sie “API-Zugangsdaten erzeugen” wählen müssen. Hier müssen Sie den Schlüsseln auch einen eindeutigen Namen geben:
Die neu erstellten Schlüssel sind sofort in der “Integrationszentrale” sichtbar. Dort wählen Sie die Option “Details anzeigen”:
Bei den Details können Sie die Daten ansehen oder im JSON-Format herunterladen:
JSON-Beispiel:
“merchant_id”: ” “,
“public_key_id”: ” “,
“store_id”: ” “,
Wichtig:
Kunden müssen auch die folgende 1cs OBS Benachrichtungs-URL speichern/konfigurieren.
Gehen Sie zum Menü oben links:
Im erscheinenden Menü gehen Sie bitte zu “Integration” und wählen “MWD Access Key”:
Unten auf der Seite sehen Sie die Option für IPN (Instant Payment Notification):
Nach einem Klick auf den blauen Link öffnen sich weitere Seiten mit Integrationseinstellungen:
Klicken Sie hier bitte auf die Schaltfläche “Bearbeiten”:
1. Fügen Sie hier bitte die folgende URL zur Integrator-URL hinzu und klicken auf die Schaltfläche “Aktualisieren”.
2. Der Händler kann auf Wunsch auch eine eigene Benachrichtigungs-URL hinterlegen. 1cs OBS fragt bei der Anfrage auch nach der NotifyURL.
Wichtig: Bitte achten Sie darauf, die per Server-zu-Server gesendeten Benachrichtigungen zu verwenden und sich nicht nur auf die SuccessURLs/FailureURLs zu verlassen.
Der grundsätzliche Ablauf einer Bezahlung mit Amazon setzt sich aus mehreren Schritten zusammen:
| Schritt | Beschreibung |
| 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. |
| Zahlung über amazonCv2.aspx initialisieren (Server-zu-Server) | Sie rufen den 1cs OBS-Endpunkt gemäß nachstehender Beschreibung auf. Das 1cs Online Bezahlsystem antwortet mit Parametern, mit denen Sie die Schaltfläche Amazon Pay aktualisieren müssen. |
| Weiterleitung zu Amazon | Nach dem Aktualisieren der Schaltfläche Amazon Pay wird der Kunde zu Amazon weitergeleitet. |
| 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. |
| Abschluss des Kaufes | Nachdem der Kunde die Bestellung bestätigt hat, leiten Sie ihn an die Amazon-URL weiter, die Sie als Antwort vom 1cs Online Bezahlsystem erhalten haben. |
| 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. |
| Benachrichtigung von 1cs OBS 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. |
Bitte stellen Sie sicher, dass Sie die 2 Hauptaufgaben für Händler einplanen:
1. Hinzufügen der neuen Schaltfläche Amazon Cv.2 (Schritt 1)
2. Bei der Rückleitung zum Shop (Schritt 2), wo Änderungen stattfinden können, muss der Händler sicherstellen, dass Adresse (falls zutreffend) und Zahlungsmethode geändert werden können. Auch die Möglichkeit einer Betragsänderung sollte mit einem Anruf an das 1cs Online Bezahlsystem weitergegeben werden.
Der folgende Beispiel-Code zeigt, wie Sie die Schaltfläche Amazon Pay Button in Ihren Webshop integrieren.
Wenn der Kunde auf diese Schaltfläche klickt, rufen Sie das 1cs Online Bezahlsystem auf, um zusätzliche Daten zu erhalten, die für die Aktualisierung der Schaltfläche Amazon Pay nötig sind.
var amazonPayButton = amazon.Pay.renderButton(‘#AmazonPayButton’, {
merchantId: ‘xxxxx’,
publicKeyId: ‘SANDBOX-xxxxxxxxxx’,
ledgerCurrency: ‘EUR’,
checkoutLanguage: ‘en_GB’,
productType: ‘PayAndShip’,
placement: ‘Cart’,
buttonColor: ‘Gold’
});
amazonPayButton.onClick(function(){
const [payload, signature, publicKeyId] = your_call_to_paygate();
amazonPayButton.initCheckout({
createCheckoutSessionConfig: {
payloadJSON: payload,
signature: signature,
publicKeyId: publicKeyId
}
});
});
In diesem Fall müssen folgende Parameter in der Schaltfläche vorhanden sein:
| 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 Option, um die Sprache im Checkout-Prozcess 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”}, |
Weitere Informationen finden Sie in der Dokumentation von Amazon Pay.
Bei Verwendung der vollständigen Kaufabwicklung von Amazon Pay v2 ist die Bewertungsseite auf der Seite des Händlers zu verwenden, um eine:
Eine Änderung von einem oder beiden ist möglich.
Review Page Beispiel
Dies sind die 1cs OBS-Daten, die dem Händler für die Review-Page geliefert werden
Dies ist ein Beispiel für das JSON, das Händler verwenden können, um gegebenenfalls Änderungen vorzunehmen
let session = document.getElementById(‘sessionId’).value;
let link = document.getElementById(‘redirectUrl’).value;
let buyNow = document.getElementById(‘buy-now’);
buyNow.addEventListener(‘click’, () => {
window.location = link;
})
amazon.Pay.bindChangeAction(‘#change-paymethod’, {
amazonCheckoutSessionId: session,
changeAction: ‘changePayment’
});
amazon.Pay.bindChangeAction(‘#change-shipping’, {
amazonCheckoutSessionId: session,
changeAction: ‘changeAddress’
});
Die Amazon-Beschreibung finden Sie hier.
Wenn der Betrag sich während des Review-Prozesses ändert, muss der folgende Request ans Paygate gesendet werden:
Request URL:
Request Parameter:
Amount=999&
Currency=EUR&
CountryCode=EU&
eventToken=UpdateAuthorizeAmount&
PayId=be30427125a94801a4c3757f4ea2111
Response Parameter:
mid=ct_teamtest
PayID=be30427125a94801a4c3757f4ea21111
TransID=n/a
Status=AUTHORIZE_REQUEST
Code=0
XID=d1708fcca09945e6b3e195156848b2f8
AmountAuth=0
AmountCap=0
AmountCred=0
Nachfolgende wiederkehrende Zahlungen
Gutschrift einer Zahlung
Storno einer Bestellung
| 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 |
| 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.
Um eine Zahlung mit Amazon Pay zu initialisieren, rufen Sie bitte folgende URL auf:
Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem 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 der First Cash Solution 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 | ns..30 | O | Eindeutige Referenznummer Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| 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änderkennung des genutzten Marketplace. 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 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: 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 M | Vollständige URL, die das 1cs Online Bezahlsystemaufruft, 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. Allgemeine Hinweise: Wir empfehlen, den Parameter “response=encrypt” zu verwenden, um eine verschlüsselte Antwort von 1cs OBS zu erhalten 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 |
Verschlüsselte Parameter zur Initialisierung einer Amazon-Pay-Zahlung
Zwischenantwort mit zusätzlichen Parametern der Schaltfläche
Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:
es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Parameter | Format | CND | Beschreibung |
| MID | ans..30 | M | HändlerID, die von der First Cash Solution vergeben wird |
| PayID | an32 | M | Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie Capture- oder Credit-Request. |
| XID | an32 | M | Vom 1cs Online Bezahlsystem 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 | ns..30 | O | Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| ButtonSignature | ans..256 | M | Signature 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 |
Antwortparameter nach dem Initialisieren einer Zahlung mit Amazon Pay
Der folgende Beispielcode zeigt die aktualisierte und vollständige Amazon-Pay-Schaltfläche, die den Kunden zu Amazon weiterleitet.
<div id=”AmazonPayButton”></div>
<script src=”https://static-na.payments-amazon.com/checkout.js“></script>
<script type=”text/javascript” charset=”utf-8″>
var amazonPayButton = amazon.Pay.renderButton(‘#AmazonPayButton’, {
merchantId: ‘xxxxx’,
ledgerCurrency: ‘EUR’,
checkoutLanguage: ‘en_GB’,
productType: ‘PayAndShip’,
placement: ‘Cart’,
buttonColor: ‘Gold’
});
amazonPayButton.onClick(function(){
// Here you need to call your shop server, which creates the initial Call towards Paygate
// and then returns the required data payloadJSON, signature, publicKeyId from the response
var buttonData = getSignedButtonData()
amazonPayButton.initCheckout({
createCheckoutSessionConfig: {
payloadJSON: buttonData.payloadJSON,
signature: buttonData.signature,
publicKeyId: buttonData.publicKeyId
}
});
</script>
Zwischenantwort mit Kundeninformationen an Ihre ShopUrl
Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:
es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Parameter | Format | CND | Beschreibung |
| Mid | ans..30 | M | MerchantID, assifned by der First Cash Solution |
| PayID | an32 | M | Vom 1cs OBS vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| XID | an32 | M | Vom 1cs OBS 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 | ns..30 | O | Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”,…) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e …). |
| 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 | n8 | M | Fehlercode gemäß 1cs OBS-Antwort-Codes |
| RTF | ans1 | O | Onetime or recurring. For repeated payments (subscriptions): I = Initial payment of series of payments. |
Antwortparameter nach dem Initialisieren einer Zahlung mit Amazon Pay
Um eine autorisierte Zahlung mit Amazon Pay zu buchen, rufen Sie bitte folgende URL auf:
Die folgenden Tabellen beschreiben die Übergabeparameter und Rückgabewerte, die über die Socket-Verbindung ausgetauscht werden. Der Ablauf der Server-zu-Server-Kommunikation ist im Handbuch Programmiergrundlagen beschrieben.
Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem 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 der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| PayID | an32 | M | Vom 1cs Online Bezahlsystem 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 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: Währungstabelle |
| RefNr | ns..30 | O | Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| 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 |
| 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 oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung oder weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs OBS gelöscht. |
Verschlüsselte Parameter zur Buchung einer autorisierten Amazon-Pay-Zahlung
Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:
es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Parameter | Format | CND | Beschreibung |
| MID | ans..30 | M | HändlerID, die von der der First Cash Solution vergeben wird |
| PayID | an32 | M | Vom 1cs Online Bezahlsystemvergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie Capture- oder Credit-Request |
| XID | an32 | M | Vom 1cs Online Bezahlsystemvergebene 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 | ns..30 | O | Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| 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 | n8 | M | Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Antwort Codes |
| 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 | Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID. |
| 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. Hier eine Übersicht: 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 |
Antwort-Parameter nach Buchung einer autorisierten Amazon-Pay-Zahlung
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 der First Cash Solution vergeben wird |
| PayID | an32 | M | Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowei Capture -oder Credit-Request |
| XID | an32 | M | Vom 1cs Online Bezahlsystem 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 | ns..30 | O | Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| 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 | n8 | M | Fehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Antwort Codes |
| 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 Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. |
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217. Hier eine Übersicht: Währungsübersicht |
| 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 Amazon-Pay-Zahlung.
Um eine gebuchte Zahlung mit Amazon Pay wieder gutzuschreiben, rufen Sie bitte folgende URL auf:
Die folgenden Tabellen beschreiben die Übergabeparameter und Rückgabewerte, die über die Socket-Verbindung ausgetauscht werden. Der Ablauf der Server-zu-Server-Kommunikation ist im Handbuch Programmiergrundlagen beschrieben.
Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem 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 der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| PayID | an32 | M | Vom 1cs Online Bezahlsystem 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 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, GBR. Hier eime Übersicht: Währungstabelle |
| RefNr | ns..30 | O | Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| 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. zur Buchung |
| ChargeID | ans..256 | M | Amazon Pay Charge ID |
| ReqID | ans..32 | O | Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung oder weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs OBS gelöscht. |
Verschlüsselte Parameter zur Gutschrift einer Amazon-Pay-Zahlung
Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:
es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Parameter | Format | CND | Beschreibung |
| MID | ans..30 | M | HändlerID, die von der First Cash Solution vergeben wird |
| PayID | an32 | M | Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| XID | an32 | M | Vom 1cs Online Bezahlsystem 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 | ns..30 | O | Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| 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 | n8 | M | Fehlercode gemäß Excel-Datei 1cs Online BezahlsystemAntwort Codes |
| 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“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide. |
| ChargeID | ans..256 | M | Amazon Pay Charge ID |
| RefundID | ans..256 | M | Amazon Pay Redund ID |
| 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 z.B. EUR, USD, GBP. Hier eine Übersicht: 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 |
Antwort-Parameter nach Gutschrift einer autorisierten Amazon-Pay-Zahlung
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 der First Cash Solution vergeben wird |
| PayID | an32 | M | Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| XID | an32 | M | Vom 1cs Online Bezahlsystem 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 | ns..30 | O | Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| 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 | n8 | M | Fehlercode gemäß Excel-Datei 1cs Online BezahlsystemAntwort Codes |
| 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“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide. |
| ChargeID | ans..256 | M | Amazon Pay Charge ID |
| RefundID | ans..256 | M | Amazon Pay Redund ID |
| 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, z.B. EUR, USD, GBP. Hier eine Übersicht: 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> |
Antwort-Parameter für URLNotify nach Gutschrift einer Amazon-Pay-Zahlung
Um eine komplette Bestellung mit Amazon Pay mit der Funktion „CancelOrderReference“ zu stornieren, rufen Sie bitte folgende URL auf:
Die folgenden Tabellen beschreiben die Übergabeparameter und Rückgabewerte, die über die Socket-Verbindung ausgetauscht werden. Der Ablauf der Server-zu-Server-Kommunikation ist im Handbuch Programmiergrundlagen beschrieben.
Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem 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 der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| PayID | an32 | M | Vom 1cs Online Bezahlsystem 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 zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder auch jede Aktion mit derselben ReqID erneut eingereicht wird, führt das 1cs OBS keine Zahlung oder weitere Aktion aus sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das 1cs OBS für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet. Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom 1cs Online Bezahlsystem gelöscht. |
Verschlüsselte Parameter zum Stornieren einer Amazon-Pay-Zahlung
Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:
es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Parameter | Format | CND | Beschreibung |
| MID | ans..30 | M | HändlerID, die von der First Cash Solution vergeben wird |
| PayID | an32 | M | Vom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| XID | an32 | M | Vom 1cs Online Bezahlsystem 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 | ns..30 | O | Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| 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 | n8 | M | Fehlercode gemäß Excel-Datei 1cs Online BezahlsystemAntwort Codes |
| CodeExt | ans..10 | O | Fehlercode von Amazon, wenn übergeben |
| ErrorText | as..1024 | O | Fehlerbeschreibung von Amazon, wenn diese übergeben wurde |
| AmazonStatus | a20 | M | Status der Bestellung 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 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: 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 |
Antwort-Parameter nach Stornierung einer Amazon-Pay-Zahlung
Die zusätzliche Zahlungsschaltfläche (APB) ist eine etwas andere Methode, um den Amazon Pay Checkout Cv2 zu nutzen. Diese Option kann mit einmaligen (OTP) oder wiederkehrenden Transaktionen verwendet werden.
Die Standardeinrichtung des Kontos bei Amazon erfolgt genau wie die reguläre Integration.
Die wesentlichen Unterschiede zur “normalen” Integration sind:
APB-spezifisch
Diese Implementierung unterscheidet sich vom normalen Checkout wie folgt:
Nutzung der Schaltfläche alleine, um eine Transaktion auszulösen.
Nutzung unserer HPP in Verbindung mit dem APB
Payload Beispiel
{
“webCheckoutDetails”: {
“checkoutResultReturnUrl”: “https://a.com/merchant-review-page“,
“checkoutMode”: “ProcessOrder”
},
“storeId”: “amzn1.application-oa2-client.8b5e45312b5248b69eeaStoreId”,
“scopes”: [“name”, “email”, “phoneNumber”, “billingAddress”],
“paymentDetails”: {
“paymentIntent”: “AuthorizeWithCapture”,
“chargeAmount”: {
“amount”: “10”,
“currencyCode”: “USD”
},
“presentmentCurrency”:”USD”
},
“merchantMetadata”: {
“merchantReferenceId”:”Merchant-order-123″,
“merchantStoreName”:”Merchant Store Name”,
“noteToBuyer”:”Thank you for your order”
},
“addressDetails”: {
“name”: “Paul Smith”,
“addressLine1”: “9999 First Avenue”,
“city”: “New York”,
“stateOrRegion”: “NY”,
“postalCode”: “10016”,
“countryCode”: “US”,
“phoneNumber”: “212555555”
}
}
{
“storeId”: “xxx”,
“webCheckoutDetails”: {
“checkoutResultReturnUrl”: “https://merchant1/xxxxxxxx“,
“checkoutMode”: “ProcessOrder”
},
“paymentDetails”: {
“paymentIntent”: “Confirm”,
“chargeAmount”: {
“amount”: “1”,
“currencyCode”: “JPY”
}
},
//recurring case
“chargePermissionType”: “Recurring”,
“recurringMetadata”: {
“frequency”: {
“unit”: “Month”,
“value”: “1”
},
“amount”: {
“amount”: “10”,
“currencyCode”: “JPY”
}
},
“addressDetails”: {
“addressLine1”: “%E7%9B%AE%E9%BB%92%E5%8C%BA%E4%B8%8B%E7%9B%AE%E9%BB%92”,
“addressLine2”: “%EF%BC%91%EF%BC%8D%EF%BC%94%EF%BC%8D%EF%BC%91”,
“addressLine3”: “%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9%E3%83%A9%E3%82%A4%E3%83%B3%EF%BC%93”,
“name”: “%E5%90%8D%E5%89%8D%E3%80%80%E3%83%86%E3%82%B9%E3%83%88%EF%BC%91%EF%BC%92%EF%BC%93”,
“countryCode”: “JP”,
“postalCode”: “1560064”,
“phoneNumber”: “0333333333”
}
}
Der folgende Beispiel-Code zeigt, wie Sie die Schaltfläche Amazon Pay in Ihren Webshop integrieren.
Wenn der Kunde auf diese Schaltfläche klickt, rufen Sie das 1cs Online Bezahlsystem auf, um zusätzliche Daten zu erhalten, die für die Aktualisierung der Schaltfläche Amazon Pay nötig sind.
<div id=”AmazonPayButton”></div>
<script src=”https://static-na.payments-amazon.com/checkout.js“></script>
<script type=”text/javascript” charset=”utf-8″>
var amazonPayButton = amazon.Pay.renderButton(‘#AmazonPayButton’, {
merchantId: ‘xxxxx’,
ledgerCurrency: ‘EUR’,
checkoutLanguage: ‘en_GB’,
productType: ‘PayAndShip’,
placement: ‘Cart’,
buttonColor: ‘Gold’
});
</script>
In diesem Fall müssen folgende Parameter in der Schaltfläche vorhanden sein:
| 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 Option, 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’ |
Weitere Informationen finden Sie in der Dokumentation von Amazon Pay.
Um eine Zahlung mit Amazon Pay zu initialisieren, verwenden Sie bitte folgende URL:
Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem 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 vom 1cs Online Bezahlsystem 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 | ns..30 | O | Eindeutige Referenznummer des Händlers. Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| 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, UK, US und JP. |
| 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, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle |
| URLSuccess | ans..256 | M | Der Käufer wird zu dieser URL weitergeleitet, wenn die Multi-Faktor-Authentisierung erfolgreich war |
| URLFailure | ans..256 | M | Der Käufer wird zu dieser URL weitergeleitet, wenn die Multi-Faktor-Authentisierung erfolgreich war |
| URLNotify | ans..256 | M | Vollständige URL, die das 1cs Online Bezahlsystem 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. Allgemeine Hinweise: Wir empfehlen, den Parameter “response=encrypt” zu verwenden, um eine verschlüsselte Antwort vom 1cs OBS zu erhalten 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. |
| CheckoutMode | an..12 | M | ProcessOrder – kann für APB fest codiert werden! Der Käufer schließt die Kaufabwicklung auf der von Amazon Pay gehosteten Seite sofort ab, nachdem er auf die Amazon-Pay-Schaltfläche geklickt hat. |
| ShopUrl | ans..256 | M | Amazon=checkoutResultReturnUrl |
| 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. Bei Verwendung mehrerer Währungen. 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. |
| ChDesk | ans..16 | C | Nur für Sale-Transaktionen: AuthorizeWithCapture. Standardwert: “AMZ*<SELLER_NAME> pay.amazon.com“ |
| OrderDesk | ans..127 | O | Beschreibung der gekauften Waren, Einzelpreise usw. |
| Lieferadresse – Bedingungen sind marktabhängig, siehe unten | |||
| Recurring Metadaten (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 |
Verschlüsselte Parameter zum Initialisieren einer Zahlung mit Amazon Pay
Zwischenantwort mit zusätzlichen Parametern der Schaltfläche
Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:
es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Parameter | Format | CND | Beschreibung |
| MID | ans..30 | M | HändlerID, die vom 1cs OBS vergeben wird |
| PayID | an32 | M | Vom 1cs OBS vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| XID | an32 | M | Vom 1cs OBS 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 | ns..30 | O | Eindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …). |
| 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 |
Antwortparameter nach dem Initialisieren einer Zahlung mit Amazon Pay
Der folgende Beispielcode zeigt die aktualisierte und vollständige Amazon-Pay-Schaltfläche, die den Kunden zu Amazon weiterleitet
<div id=”AmazonPayButton”></div>
<script src=”https://static-na.payments-amazon.com/checkout.js“></script>
<script type=”text/javascript” charset=”utf-8″>
var amazonPayButton = amazon.Pay.renderButton(‘#AmazonPayButton’, {
merchantId: ‘xxxxx’,
ledgerCurrency: ‘EUR’,
checkoutLanguage: ‘en_GB’,
productType: ‘PayAndShip’,
placement: ‘Cart’,
buttonColor: ‘Gold’
});
amazonPayButton.onClick(function(){
// Here you need to call your shop server, which creates the initial Call towards Paygate
// and then returns the required data payloadJSON, signature, publicKeyId from the response
var buttonData = getSignedButtonData()
amazonPayButton.initCheckout({
createCheckoutSessionConfig: {
payloadJSON: buttonData.payloadJSON,
signature: buttonData.signature,
publicKeyId: buttonData.publicKeyId
}
});
</script>
Da die Adresse vom Händler für APB gesendet werden soll und wir verschiedene Märkte unterstützen, wird das Folgende validiert.
EU (including UK)
| Parameter | Format | CND | Beschreibung |
| Name | as..50 | M | Vorname und Nachname der Adresse |
| SdStreet | a..180 | M | Firmenname (falls angegeben) oder Straßenname und Hausnummer |
| SdStreet2 | a..60 | O | Straßenname und Hausnummer |
| SdAddressAddition | a..60 | O | Weitere Zusätze |
| SdCity | a..50 | M | Ort in der Lieferadresse |
| SdDistrict | a..50 | O | Bezirk/Kreis in der Lieferadresse |
| SdState | a..50 | C | Bundesland der Lieferadresse. Nicht unterstützt, wenn countryCode ist: ‘UK’, ‘GB’, ‘SG’, ‘AE’, ‘MX’ |
| SdZipcode | a..50 | M | Postleitzahl in der Lieferadresse |
| SdCountryCode | an2 | M | Ländercode des Lieferlandes gemäß ISO 3166 |
| SdPhone | a..128 | M | Telefonnummer des Adressaten in der Lieferadresse |
‘UK’ ,’GB’ ,’DE’ ,’FR’ ,’IT’ ,’ES’ ,’AT’ ,’BE’ ,’BG’ ,’HR’ ,’CY’ ,’CZ’ ,’DK’ ,’EE’ ,’FI’ ,’GR’ ,’HU’ ,’IE’ ,’LV’ ,’LT’ ,’LU’ ,’MT’ ,’NL’ ,’PL’ ,’PT’ ,’RO’ ,’SK’ ,’SI’ ,’SE’
JP
| Parameter | Format | CND | Beschreibung |
| Name | as..50 | M | Vorname und Nachname der Adresse |
| SdStreet | a..180 | M | Firmenname (falls angegeben) oder Straßenname und Hausnummer |
| SdStreet2 | a..60 | O | Straßenname und Hausnummer |
| SdAddressAddition | a..60 | O | Weitere Zusätze |
| SdCity | a..50 | M | Ort in der Lieferadresse |
| SdDistrict | a..50 | O | Bezirk/Kreis in der Lieferadresse |
| SdState | a..50 | C | Bundesland oder Region |
| SdZipcode | a..50 | M | Postleitzahl in der Lieferadresse |
| SdCountryCode | an2 | M | Ländercode des Lieferlandes gemäß ISO 3166 |
| SdPhone | a..128 | M | Telefonnummer des Adressaten in der Lieferadresse |
US
| Parameter | Format | CND | Beschreibung |
| Name | as..50 | M | Vorname und Nachname der Adresse |
| SdStreet | a..180 | M | Firmenname (falls angegeben) oder Straßenname und Hausnummer |
| SdStreet2 | a..60 | O | Straßenname und Hausnummer |
| SdAddressAddition | a..60 | O | Weitere Zusätze |
| SdCity | a..50 | M | Ort in der Lieferadresse |
| SdDistrict | a..50 | O | Bezirk/Kreis in der Lieferadresse |
| SdState | a..50 | C | Bundesland oder Region |
| SdZipcode | a..50 | M | Postleitzahl in der Lieferadresse |
| SdCountryCode | an2 | M | Ländercode des Lieferlandes gemäß ISO 3166 |
| SdPhone | a..128 | M | Telefonnummer des Adressaten in der Lieferadresse |
“Als eine der bekanntesten Opernhäuser der Welt steht die Semperoper Dresden für herausragende Kultur und Qualität.
Im Bereich der Zahlungs-abwicklung setzen wir deshalb auf die 1cs – für uns die perfekte Kombination aus persönlicher Betreuung und individuelle Beratung auf höchstem Niveau.”
Doris Schneider,
Leiterin Vertrieb und Service
“Wir setzen bei Fahrrad XXL auf den verlässlichen Service der First Cash Solution und fühlen uns hier bestens aufgehoben!”
Peter Hürter, Fahrrad XXL
“Die First Cash Solution ist stets zuverlässig und bietet einen
super Service durch ständige Bereitschaft uns zu helfen
sowie schnelle und kompetente Antworten auf all unsere Fragen.”
Thomas Quindt,
Projektleiter SOCCERBEAT GmbH
Gebühr der Kartenorganisationen:
Werden von den Kreditkartenorganisationen wie Visa oder Mastercard erhoben, sie werden auch Card Scheme Fees (CSF) genannt.
Bearbeitungsgebühr:
Wird von Deinem Zahlungsanbieter/Acquirer berechnet, in Deinem Fall von uns (1cs). Sie wird auch Acquirer Service Fee (ASF) genannt.
Interchange-Gebühr:
Wird von der kartenherausgebenden Bank bzw. Issuer in Rechnung gestellt. Sie wird auch Interchange Fee (ICF) genannt.
“Hier wird uns bei jedem Anliegen kompetent, unkompliziert und schnell geholfen! Daher können wir die First Cash Solution nur empfehlen.”
Sandra von Bargen, Hachez CHOCOVERSUM GmbH
„Die unkomplizierte schnelle Betreuung passt 100% zu uns und unserem Abrechnungssystem.“
Markus Tanger, Road House Paderborn