Abonnements ändern

1 Abonnements ändern

1cs Online Bezahlsystem – Schnittstelle

1.1 Definitionen

1.1.1 Datenformate

FormatBeschreibung
aalphabetisch
asalphabetisch mit Sonderzeichen
nnumerisch
analphanumerisch
ansalphanumerisch mit Sonderzeichen
nsnumerisch mit Sonderzeichen
boolBool’scher Ausdruck (true oder false)
3feste Länge mit 3 Stellen/Zeichen
..3variable Länge mit maximal 3 Stellen/Zeichen
enum
Aufzählung erlaubter Werte
dttmISODateTime (JJJJ-MM-TTThh:mm:ss)

1.1.2 Abkürzungen

AbkürzungBeschreibungKommentare
CND
Bedingung (condition) 
MPflicht (mandatory)Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein
OOptionalWenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich
CBedingt (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
FormatCNDBeschreibung
MerchantIDans..30MHändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben
AboIDans..32MVom 1cs Online Bezahlsystem vergebene ID für das Abo
Amountn..12OBetrag 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.
MACans64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
OrderDescans..768OBeschreibung der gekauften Waren, Einzelpreise usw.
AboActiona..10MAktion. Beim Ändern immer <Update>
StartDate
n8MStartdatum des Abos im Format YYYYMMDD
EndDaten8MEnddatum des Abos im Format YYYYMMDD
Intervaln..3MAbstand zur nächsten Abo-Zahlung in Tagen: 1= täglich, 7= wöchentlich, 30= monatlich, 90= vierteljährlich, 180= halbjährlich, 360= jährlich
Activea..5ODer Wert <true> aktiviert das Abo. Der Wert <false> deaktiviert das Abo.
Parameter zum Ändern von Abonnements über Socket-Verbindungen

Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

KeyFormatCNDBeschreibung
AboIDans..32MVom 1cs Online Bezahlsystem vergebene ID für das Abo
Statusa..50MOK (URLSuccess) oder FAILED (URLFailure)
Descriptionans..1024MNähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Coden8MFehlercode gemäß Excel-Datei 1cs Online Bezahlsystem Antwort Codes
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:
HMAC-Authentisierung (Anfrage)
HMAC-Authentifizierung (Notify)
Antwort-Parameter beim Ändern von Abonnements über Socket-Verbindungen