Wir nutzen Cookies zu unterschiedlichen Zwecken, unter anderem zur Analyse und für personalisierte Marketing-Mitteilungen. In unseren Cookie-Richtlinien erfahren Sie, wie wir Cookies verwenden.Datenschutzhinweise Impressum
Notwendig
Statistik
Notwendig Technisch notwendige Funktionen, wie das speichern Ihrer Cookie-Einstellungen für diese Website.
Statistik Statistik- und Marketing-Tools betreiben zu können um zu verstehen, wie Seitenbesucher die Website benutzen und um Optimierungen für Sie umsetzen zu können.
Details zu den Cookies
Notwendig
Name
Anbieter
Zweck
Ablauf
cookie_status
www.firstcashsolution.de
Speichert Ihren Zustimmungsstatus für Cookies auf der aktuellen Domäne.
1 Jahr
pll_language
www.firstcashsolution.de
Speichert Ihre Spracheinstellungen.
1 Jahr
PHPSESSID
www.firstcashsolution.de
In diesem Cookie wird die Session-ID, also eine zufällig generierte Identifikationsnummer für Ihre Sitzung, gespeichert. Dieser Cookie wird – abhängig von Ihrer Browser-Einstellung – beim Schließen eines Tabs oder Fensters, das diesen Cookie gesetzt hat, gelöscht. Dadurch ist es zum Beispiel möglich, zuvor bereits ausgefüllte Felder eines Formulars vom Browser automatisch eintragen zu lassen.
Session
wordpress_test_cookie
www.firstcashsolution.de
Prüft ob Cookies gesetzt werden können
1 Jahr
pum-*
www.firstcashsolution.de
Speichert die Information welches PopUp geschlossen wurde
1 Monat
Statistik
Name
Anbieter
Zweck
Ablauf
{individuelle_nummer}
etracker.com
Speichert eine anonymisierte ID um nachzuverfolgen, welche Seiten angesehen wurden.
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.
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 -->
// 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
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.
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
Schaltflächenparameter
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)
Datenformate 1cs OBS Schnittstelle
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
Abkürzungen in der 1cs OBS Schnittstelle
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:
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
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.
Verschlüsselte Parameter zur Initialisierung einer Amazon-Pay-Zahlung
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
Zwischen-Antwortparameter nach dem Initialisieren einer Zahlung mit Amazon Pay
Schritt 7: Überprüfungsseite darstellen
Sobald Sie die Checkout-Sitzung mit Amazon Pay mit der erweiterten Nutzlast initialisiert haben, wird der Kunde zu Amazon weitergeleitet, um sich anzumelden und Zahlungsmethode und Versanddaten auszuwählen. Sobald der Kunde den Schritt abgeschlossen hat, sendet 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
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:
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.
Parameter zum Ändern des Betrags einer Amazon-Pay-Zahlung
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
Gesamtbetrag, der bereits erfolgreich bei Amazon gebucht wurde
AmountCred
n..10
M
Gesamtbetrag, der bereits erfolgreich bei Amazon gutgeschrieben wurde
Antwort-Parameter zum Ändern des Betrags einer Amazon-Pay-Zahlung
Hinweis: Stellen Sie sicher, dass Sie die letzte Schaltfläche „Bezahlen“ erst darstellen oder aktivieren, wenn Sie eine erfolgreiche Antwort für das Ereignis „UpdateAuthorizeAmount“ erhalten haben.
Schritt 10: Kaufabwicklung abschließen
Aktivieren Sie die letzte Schaltfläche „Bezahlen“, damit der Kunde die Kaufabwicklung bei Amazon abschließen kann. Nach erfolgreichem Abschluss gibt Ihnen das 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
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
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.
Verschlüsselte Parameter zur Buchung einer autorisierten Amazon-Pay-Zahlung
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
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
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.
Verschlüsselte Parameter zur Gutschrift einer Amazon-Pay-Zahlung
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
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
Antwort-Parameter nach Gutschrift einer autorisierten Amazon-Pay-Zahlung
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
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>
Antwort-Parameter für URLNotify nach Gutschrift einer Amazon-Pay-Zahlung
Bestellung stornieren
Um eine komplette Bestellung mit Amazon Pay mit der Funktion „CancelOrderReference“ zu stornieren, verwenden Sie bitte folgende URL:
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.
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
Verschlüsselte Parameter zum Stornieren einer Amazon-Pay-Zahlung
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
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
Antwort-Parameter nach Stornierung einer Amazon-Pay-Zahlung
Einrichtung wiederkehrender Zahlungen
Um eine wiederkehrende Zahlung mit Amazon Pay einzurichten, übermitteln Sie zusätzlich zu der in Schritt 6 oben beschriebenen Standardanfrage die folgenden Daten.
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
Parameter Anfangszahlung
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
Parameter wiederkehrende Zahlung
Am 24. + 25. Juni sind wir bei der K5 Future Retail Conference in Berlin.
Wir sind auf der K5 Future Retail Conference 2025 am 24. und 25. Juni im Estrel Berlin vertreten – dem Top-Event für digitalen Handel mit über 5.000 Teilnehmenden, 250 Ausstellern und 150 Speakern.
Gemeinsam mit unserer Schwesterfirma lynck präsentieren wir uns an einem 12,5 m² großen Stand und zeigen, wie moderne Payment-Lösungen den Handel von morgen gestalten.
Wir freuen uns auf Deinen Besuch in der Expo Halle 2 am Stand 120!
Ob Networking, Insights oder Inspiration – wir sind dabei, wo die Zukunft des Handels gemacht wird.
“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.“
