1 Über Mobile SDK Authentisierung
1.1 Allgemeines zu Mobile SDK Authentisierung
1.2 Diagramm zum Prozessablauf
2 1cs Online Bezahlsystem Schnittstelle
Dieses Dokument beschreibt die Mobile SDK Authentisierungsmethode und die entsprechenden Parameter für die Anforderung der Authentisierung sowie die Antwortparameter. Wenn ein Händler eine eigene App entwickelt, ist diese Methode erforderlich, damit eine gesicherte Authentisierung unabhängig von der App über die 1cs Online Bezahlsystem-Schnittstelle erfolgt. Die Authentisierung basiert dabei auf einem Einmal-Token, das zwischen der First Cash Solution und dem Händler ausgetauscht wird.
Weitergehende Informationen zur Integration des SDK finden sich im GitHub-Repository unter https://github.com/Computop.
Prozessablauf Mobile SDK Authentisierung
| Format | Beschreibung |
| a | alphabetisch |
| as | alphabetisch mit Sonderzeichen |
| n | numerisch |
| an | alphanumerisch |
| ans | alphanumerisch mit Sonderzeichen |
| ns | numerisch mit Sonderzeichen |
| bool | Bool’scher Ausdruck (true oder false) |
| 3 | feste Länge mit 3 Stellen/Zeichen |
| ..3 | variable Länge mit maximal 3 Stellen/Zeichen |
| enum | Aufzählung erlaubter Werte |
| dttm | ISODateTime (JJJJ-MM-TTThh:mm:ss) |
| Abkürzung | Beschreibung | Kommentar |
| CND | Bedingung (condition) | |
| M | Pflicht (mandatory) | Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein |
| O | Optional | Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich |
| C | Bedingt (conditional) | Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist |
Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.
Prozessüberblick auf oberer Ebene:
1. Mobile SDK erzeugt Authentisierungsanfrage an URD-Endpunkt des Händlers
2. URL-Endpunkt des Händlers erzeugt AuthToken und AuthLabel
3. URL-Endpunkt des Händlers ruft 1cs Online Bezahlsystem-Schnittstelle mit unten definierten Parametern
4. URL-Endpunkt des Händlers empfängt Antwort des 1cs Online Bezahlsystems
5. URL-Endpunkt des Händlers reagiert auf die Authentisierungsanfrage von Mobile SDK
Für die Authentisierungsanfrage sollte der Endpunkt des Händlers eine POST-Anfrage mit dem Content-Typ: application/json sowie einem JSON-Body wie folgt akzeptzieren:
{
"merchantID" : <Computop_MerchantID>
}
Mobile SDK erwartet ein JSON-Objekt als Antwort vom Endpunkt des Händlers, so dass der Endpunkt
des Händlers ein JSON-Objekt mit Attributen aus der Antwort sowie generiert aus AuthToken
und AuthLabel etwa folgendermaßen erzeugen muss:
{
"AuthToken“: <generated_token>,
"AuthLabel": <generated_label>,
“ExpiryDate”: <expiry_date_of_token>
"Description": <description_from_computop_response>,
"Status": <status_from_computop_response>,
"Code": <code_from_computop_response>
}
Um ein Einmal-Token zur Verschlüsselung im 1cs Online Bezahlsystem zu registrieren, muss der Händler die nachfolgenden Parameter über eine Server-zu-Server-Verbindung an die First Cash Solution übertragen. Rufen Sie dazu folgende URL auf:
https://www.computop-paygate.com/authtoken.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. |
| AuthToken | an16..56 | M | Eindeutiges von Händler generiertes Token, dass zur Entschlüsselung der Zahlungsanfrage verwendet wird |
| AuthLabel | an32..64 | M | Bezeichner für das verwendete AuthToken zur Entschlüsselung der Zahlungsanfrage |
| ExpiryDate | dttm | O | Endzeitpunkt der Gültigkeit des Tokens. Die maximale Gültigkeitsdauer beträgt 24 Stunden. Wenn der Wert nicht angegeben ist, läuft das Token standardmäßig nach 15 Minuten ab. |
Parameter für Anfrage zur Authentisierung
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurück gibt:
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 |
| Status | a..30 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Description | ans..1024 | M | Nähere Beschreibung der Werte von Status und Code. 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 |
| ExpiryDate | dttm | M | Endzeitpunkt der Gültigkeit des Tokens. Die maximale Gültigkeitsdauer beträgt 24 Stunden. Wenn der Wert nicht angegeben ist, läuft das Token standardmäßig nach 15 Minuten ab. |
Antwort-Parameter für Anfrage zur Authentisierung
“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