Abonnements ändern
1 Abonnements ändern
1cs Online Bezahlsystem – Schnittstelle
1.1 Definitionen
1.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) |
1.1.2 Abkürzungen
| Abkürzung | Beschreibung | Kommentare |
| 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.
1.2 Abonnements ändern
Aufruf der Schnittstelle
Das 1cs Online Bezahlsystem der First Cash Solution kann Ihre Abonnements verwalten und regelmäßige Zahlungen für Sie ausführen. Das automatische Anlegen eines Abonnements ist nur zusammen mit Kreditkartenzahlung möglich.
Um ein bestehendes Abonnement über eine Server-zu-Server-Verbindung zu ändern, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/abo.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 |
| MerchantID | ans..30 | M | HändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben |
| AboID | ans..32 | M | Vom 1cs Online Bezahlsystem vergebene ID für das Abo |
| Amount | n..12 | O | 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. |
| MAC | ans64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify) |
| OrderDesc | ans..768 | O | Beschreibung der gekauften Waren, Einzelpreise usw. |
| AboAction | a..10 | M | Aktion. Beim Ändern immer <Update> |
| StartDate | n8 | M | Startdatum des Abos im Format YYYYMMDD |
| EndDate | n8 | M | Enddatum des Abos im Format YYYYMMDD |
| Interval | n..3 | M | Abstand zur nächsten Abo-Zahlung in Tagen: 1= täglich, 7= wöchentlich, 30= monatlich, 90= vierteljährlich, 180= halbjährlich, 360= jährlich |
| Active | a..5 | O | Der Wert <true> aktiviert das Abo. Der Wert <false> deaktiviert das Abo. |
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:
| Key | Format | CND | Beschreibung |
| AboID | ans..32 | M | Vom 1cs Online Bezahlsystem vergebene ID für das Abo |
| 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 |
| MAC | an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentifizierung (Notify) |
