Amazon Pay V2
1 Über Amazon Pay
1.1 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
- Produktauswahl und Kaufabwicklung: Der Käufer legt Produkte in seinen Einkaufswagen und geht zur Kaufabwicklung, indem er die Schaltfläche „Amazon Pay“ auswählt.
- 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.
- 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.
- 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.
- Auftragsbestätigung: Der Käufer wird zu Ihrer Auftragsbestätigungsseite zurückgeleitet.
1.2 Diagramm zum Prozessablauf
2. Amazon Pay akzeptieren
Führen Sie folgende Schritte, um Amazon Pay zu akzeptieren.
Hinweis: Wenn Sie mit dem 1cs Online Bezahlsystem 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 das 1cs Online Bezahlsystem im Namen Ihres Shops mit Amazon verbinden kann. Es ist wichtig, dieses Token zu generieren und es in Ihrem Onboarding-Prozess an 1cs Support zu geben.
Schritte, um das MWS-Autorisierungs-Token zu generieren
- 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.
a) Entwicklername: CT_Sandbox_EU
b) 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 1cs Online Bezahlsystem für Vorgänge wie Buchungen und Gutschriften verwendet. Sie müssen die 1cs Online Bezahlsystem Notify URL für Ihren Shop im Konto Amazon Seller Central einrichten, um diese Benachrichtigungen zu empfangen.
- 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®ion=EU.
Hinweis: Ersetzen Sie yourmerchantId mit der im 1cs Online Bezahlsystem eingerichteten merchantId.
Schritt 4: Notify URL einrichten
Um sich bei First Cash Solution 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.
- Store-Name – Name des Geschäfts.
- Ländercode – Ländercode des Marktes.
- Händler-ID – Händler-ID aus Ihrem Amazon Seller Central-Konto.
- MWS-Autorisierungstoken – in Schritt 2 generiert.
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 |
| buttonColor | O | Der Parameter buttonColor definiert die Farbe der Schaltfläche | Zulässige Werte: Gold, LightGray, DarkGray Standardwert ‚Gold‘ |
| 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‘ |
| productType | O | 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 |
| 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‘ |
| placement | M | Platzierung der Schaltfläche | Zulässige Werte Cart |
| merchantId | M | Von Amazon ausgestellte Verkäufer-ID | |
| publicKeyId | M | Von Amazon bereitgestellter Key |
3. 1cs OBS-Schnittstelle
3.1 Definitionen
3.1.1 Datenformate
| 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) |
3.1.2 Abkürzungen
| Format | Beschreibung | Kommentar |
| CND | Bedingung (condition) | |
| M | Pflicht (mandatory) | Wenn ein Parameter Pflicht ist, 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 1cs OBS-Schnittstelle
Integrieren Sie Ihr Backend mit der 1cs Online Bezahlsystem-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 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 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ä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 1cs Support, 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 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: • 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. |
| 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. |
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 1cs Online Bezahlsystem als Antwort zurückgibt:
Hinweis: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
Hinweis: die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
| mid | ans..30 | M | HändlerID, die von First Cash Solution 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 | 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 |
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 First Cash Solution 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 1cs Online Bezahlsystem als Antwort zurückgibt:
Hinweis: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
Hinweis: die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
| mid | ans..30 | M | HändlerID, die von 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 |
| Status | a..50 | M | PENDING |
| Code | an8 | M | Fehlercode gemäß 1cs Online Bezahlsystem Antwort-Codes (A4 Fehlercodes) |
| AmountAuth | n..10 | M | Gesamtbetrag, der bei Amazon reserviert ist |
| AmountCap | n..10 | M | Gesamtbetrag, der bereits erfolgreich bei Amazon gebucht wurde |
| AmountCred | n..10 | M | Gesamtbetrag, der bereits erfolgreich bei Amazon gutgeschrieben wurde |
| bdAddrName | ans..30 | C | Rechnungsadresse – Kundenname |
| bdAddrStreet | a..32 | C | Rechnungsadresse – Straße und Hausnummer |
| bdAddrZip | n..5 | C | Rechnungsadresse – Postleitzahl |
| bdAddrCity | a..32 | C | Rechnungsadresse – Ort |
| bdAddrState | a..32 | C | Rechnungsadresse – Bundesstaat |
| bdAddrCountrycode | a2 | C | Rechnungsadresse – alphabetischer Ländercode |
| bdPhoneNumber | ans..20 | C | Rechnungsadresse – Telefonnummer |
| AddrName | ans..30 | C | Lieferadresse – Kundenname |
| AddrStreet | a..32 | C | Lieferadresse – Straße und Hausnummer |
| AddrStreet2 | a..32 | C | Lieferadresse – Zeile 2 |
| AddrStreet3 | a..32 | C | Lieferadresse – Zeile 3 |
| AddrZip | n..5 | C | Lieferadresse – Postleitzahl |
| AddrCity | a..32 | C | Lieferadresse – Ort |
| AddrState | a..32 | C | Lieferadresse – Bundesstaat |
| AddrCountrycode | a2 | C | Lieferadresse – alphabetischer Ländercode |
| PhoneNumber | ans..20 | C | Lieferadresse – Telefonnummer |
| buyerId | ans..42 | M | Eindeutige Käuferkennung bei Amazon Pay |
| buyerName | ans..50 | M | Käufername |
| buyerEmail | ans..64 | M | E-Mail-Adresse des Käufers |
| buyerPhonenumber | ans..20 | M | Telefonnummer des Käufers |
| AmazonMerchantid | ans.. | M | Amazon Händler-ID |
| RTF | ans.. | M | einmalig – einzelne Bestellung wiederkehrend – wiederkehrende Bestellung |
| AmazonStatus | a..50 | M | OPEN |
| AmazonpayRedirectUrl | ans..256 | M | Von Amazon Pay bereitgestellte URL |
| AmazoncheckoutSessionid | ans..32 | M | Checkout-Sitzungs-ID von Amazon |
| AmazonPaymentDescriptor | ans..64 | M | Zahlungsdeskriptor, 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>
Zahlungsmittel ä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 1cs Online Bezahlsystem 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 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:
| Key | Format | CND | Beschreibung |
| 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. |
| EventToken | enum | M | Fester Wert: UpdateAuthorizeAmount |
| Amount | n..10 | M | Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, 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 |
| CountryCode | an2 | M | ändercode des verwendeten Marktplatzes. Optionen EU, US und JP. |
Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:
Hinweis: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
Hinweis: die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
| mid | ans..30 | M | HändlerID, die von First Ccash 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 |
| Status | a..50 | M | AUTHORIZE_REQUEST |
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
| AmountAuth | n..10 | M | Gesamtbetrag, der bei Amazon reserviert ist |
| AmountCap | n..10 | M | Gesamtbetrag, der bereits erfolgreich bei Amazon gebucht wurde |
| AmountCred | n..10 | M | Gesamtbetrag, der bereits erfolgreich bei Amazon gutgeschrieben wurde |
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 1cs Online Bezahlsystem eine Antwort an URLSuccess/URLFailure und URLNotify. Nachfolgend finden Sie die Parameter dieser Antwort.
| Key | Format | CND | Beschreibung |
| mid | ans..30 | M | HändlerID, die von 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 |
| Status | a..50 | M | OK |
| Code | an8 | M | Fehlercode gemäß 1cs Online Bezahlsystem Antwort-Codes (A4 Fehlercodes) |
| AmountAuth | n..10 | M | Gesamtbetrag, der bei Amazon reserviert ist |
| AmountCap | n..10 | M | Gesamtbetrag, der bereits erfolgreich bei Amazon gebucht wurde |
| AmountCred | n..10 | M | Gesamtbetrag, der bereits erfolgreich bei Amazon gutgeschrieben wurde. Der Betrag für die Zahlung beträgt Null. |
| bdAddrName | ans..30 | C | Rechnungsadresse – Kundenname |
| bdAddrStreet | a..32 | C | Rechnungsadresse – Straße und Hausnummer |
| bdAddrZip | n..5 | C | Rechnungsadresse – Postleitzahl |
| bdAddrCity | a..32 | C | Rechnungsadresse – Ort |
| bdAddrState | a..32 | C | Rechnungsadresse – Bundesstaat |
| bdAddrCountrycode | a2 | C | Rechnungsadresse – alphabetischer Ländercode |
| bdPhoneNumber | ans..20 | C | Rechnungsadresse – Telefonnummer |
| AddrName | ans..30 | C | Lieferadresse – Kundenname |
| AddrStreet | a..32 | C | Lieferadresse – Straße und Hausnummer |
| AddrZip | n..5 | C | Lieferadresse – Postleitzahl |
| AddrCity | a..32 | C | Lieferadresse – Ort |
| AddrState | a..32 | C | Lieferadresse – Bundesstaat |
| AddrCountrycode | a2 | C | Lieferadresse – alphabetischer Ländercode |
| PhoneNumber | ans..20 | C | Lieferadresse – Telefonnummer |
| buyerId | ans..42 | M | Eindeutige Käuferkennung bei Amazon Pay |
| buyerName | ans..50 | M | Käufername |
| buyerEmail | ans..64 | M | E-Mail-Adresse des Käufers |
| buyerPhonenumber | ans..20 | M | Telefonnummer des Käufers |
| AmazonMerchantid | ans.. | M | Amazon 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 | M | Completed |
| AmazonpayRedirectUrl | ans..256 | M | Von Amazon Pay bereitgestellte URL |
| AmazoncheckoutSessionid | ans..32 | M | Checkout-Sitzungs-ID von Amazon |
Zahlung buchen
Hinweis: 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.
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:
| Key | Format | CND | Beschreibung |
| MerchantID | ans..30 | M | MerchantID, assigned by First Cash Solution. Additionally this parameter has to be passed in plain language too. |
| PayID | an32 | M | ID assigned by 1cs Online Bezahlsystem for the payment, e.g. for referencing in batch files as well as for capture or credit request. |
| TransID | ans..64 | M | TransactionID provided by you which should be unique for each payment |
| Amount | n..10 | M | Amount in the smallest currency unit (e.g. EUR Cent). Please contact the 1cs Support, if you want to capture amounts <100 (smallest currency unit). |
| Currency | a3 | M | Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table |
| refnr | ans..30 | O | Merchant’s unique reference number |
| MAC | an64 | M | Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify) |
| ReqId | ans..32 | O | To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, 1cs Online Bezahlsystem will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the 1cs Online Bezahlsystem must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on 1cs Online Bezahlsystem does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the 1cs Online Bezahlsystem. |
| ChDesc | ans..16 | O | Text printed on the customer’s credit card bill alongside the payee |
| OrderDesc | ans..127 | O | Use this parameter for the simulation mode. During live mode this parameter has no effects. |
| AmazonpaySimulationCode | ans.. | O | A parameter used to simulate specific payment scenarios or behaviors during testing. For complete list of allowed simulation code, refer Amazonpay documentation. |
Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:
Hinweis: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
Hinweis: die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
| mid | ans..30 | M | MerchantID, assigned by First Cash Solution |
| PayID | an32 | M | ID assigned by 1cs Online Bezahlsystem for the payment, e.g. for referencing in batch files as well as for capture or credit request. |
| XID | an32 | M | ID for all single transactions (authorisation, capture, credit note) for one payment assigned by 1cs Online Bezahlsystem |
| TransID | ans..64 | M | TransactionID provided by you which should be unique for each payment |
| refnr | ans..30 | O | Merchant’s unique reference number |
| Status | a..50 | M | OK (URLSuccess) or FAILED (URLFailure) |
| Description | ans..1024 | M | Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis! |
| Code | an8 | M | Error code according to 1cs Online Bezahlsystem Response Codes (A4 Error codes) |
| CodeExt | ans..10 | O | Error code from Amazon, if transferred |
| ErrorText | as..1024 | O | Error description from Amazon, if transferred |
| chargeid | ans..256 | M | Amazon Pay Charge ID |
| AmazonStatus | a..20 | M | Order status at Amazon. Following values are possible: „Opened“, „Completed, „Canceled“. Details see Amazon API Reference Guide. |
| chargepermissionid | ans..256 | M | Amazon Pay Permission ID |
| Amount | n..10 | M | Amount in the smallest currency unit (e.g. EUR Cent). Please contact the 1cs Support, if you want to capture amounts <100 (smallest currency unit). |
| Currency | a3 | M | Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table |
| AmountAuth | n..10 | M | Total amount which is reserved at Amazon |
| AmountCap | n..10 | M | Total amount which is already successfully captured at Amazon |
| AmountCred | n..10 | M | Total amount which is already successfully credited at Amazon |
Nach einer Buchung erhalten Sie eine Benachrichtigung an die angegebene URLNotify mit den folgenden Parametern:
| Key | Format | CND | Beschreibung |
| mid | ans..30 | M | MerchantID, assigned by First Cash Solution |
| PayID | an32 | M | ID assigned by 1cs Online Bezahlsystem for the payment, e.g. for referencing in batch files as well as for capture or credit request. |
| XID | an32 | M | ID for all single transactions (authorisation, capture, credit note) for one payment assigned by 1cs Online Bezahlsystem |
| TransID | ans..64 | M | TransactionID provided by you which should be unique for each payment |
| refnr | ans..30 | O | Merchant’s unique reference number |
| Status | a..50 | M | OK (URLSuccess) or FAILED (URLFailure) |
| Description | ans..1024 | M | Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis! |
| Code | an8 | M | Error code according to 1cs Online Bezahlsystem Response Codes (A4 Error codes) |
| CodeExt | ans..10 | O | Error code from Amazon, if transferred |
| ErrorText | as..1024 | O | Error description from Amazon, if transferred |
| chargeid | ans..256 | M | Amazon Pay Charge ID |
| AmazonStatus | a..20 | M | Order status at Amazon. Following values are possible: „Opened“, „Completed, „Canceled“. Details see Amazon API Reference Guide. |
| chargepermissionid | ans..256 | M | Amazon Pay Permission ID |
| OrderID | ans..19 | M | Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID. |
| AmazonRefID | ans..27 | M | Unique ID for the transaction issued by Amazon |
| Amount | n..10 | M | Amount in the smallest currency unit (e.g. EUR Cent). Please contact the 1cs Support, if you want to capture amounts <100 (smallest currency unit). |
| Currency | a3 | M | Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table |
| AmountAuth | n..10 | M | Total amount which is reserved at Amazon |
| AmountCap | n..10 | M | Total amount which is already successfully captured at Amazon |
| AmountCred | n..10 | M | Total amount which is already successfully credited at Amazon |
| NotificationType | a..25 | M | Describes the type of notification. Fixed value: <CaptureNotification> |
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 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:
| Key | Format | CND | Beschreibung |
| MerchantID | ans..30 | M | HändlerID, die von 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 1cs Support, 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) |
| 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 1cs Online Bezahlsystem 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 Online Bezahlsystem 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 1cs Online Bezahlsystem 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 1cs Online Bezahlsystemgelöscht. |
| OrderDesc | ans..127 | O | Beschreibung 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. |
Die folgende Tabelle beschreibt die Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:
Hinweis: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
Hinweis: die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
| mid | ans..30 | M | HändlerID, die von 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 | 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äß 1cs Online Bezahlsystem 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: „Opened“, „Completed, „Canceled“. 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 1cs Support, 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 |
Nach einer Gutschrift erhalten Sie eine Benachrichtigung an die angegebene URLNotify mit den folgenden Parametern:
| Key | Format | CND | Beschreibung |
| mid | ans..30 | M | HändlerID, die von 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 | 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äß 1cs Online Bezahlsystem 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: „Opened“, „Completed, „Canceled“. 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 1cs Support, 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> |
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 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:
| Key | Format | CND | Beschreibung |
| MerchantID | ans..30 | M | HändlerID, die von 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 |
| 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 das1cs Online Bezahlsystem 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 Online Bezahlsystem 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 1cs Online Bezahlsystem 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 1cs Online Bezahlsystem gelöscht |
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:
Hinweis: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
Hinweis: die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
| mid | ans..30 | M | HändlerID, die von 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 | 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äß 1cs Online Bezahlsystem 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: „Opened“, „Completed, „Canceled“. 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 1cs Support, 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 |
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 |
| RTF | ans1 | M | I = Anfangszahlung einer Serie |
| cycle | an..7 | M | Zyklus. Unterstützte Werte: ‚Year‘, ‚Month‘, ‚Week‘, ‚Day‘, ‚Variable‘ |
| Value | n..4 | M | 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 |
| InstallmentAmount | n..10 | C | Transaktionsbetrag – wählen Sie Null, wenn es sich nicht um einen festen Betrag handelt |
| Currency | a3 | C | Transaktionswährungscode im Format ISO 4217, zum Beispiel: EUR |
Wiederkehrende Zahlung
| Key | Format | CND | Beschreibung |
| RTF | ans1 | M | R = Recurring (wiederkehrend) |
| Amount | n..10 | M | Aktualisierter Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den 1cs Support, 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 |
| CountryCode | an2 | M | Ländercode des verwendeten Marktplatzes. Optionen: EU, US und JP. |
| ChargepermissionId | ans..256 | M | Charge Permission ID, die Sie in der Antwort auf die Anfangszahlung in der Serie erhalten haben |
