Statusabfragen
1. 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 | 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.
2. Statusabfragen über Socket-Verbindungen
2.1 Statusabfragen per PayID
Statusabfragen im 1cs Online Bezahlsystem liefern genaue Informationen, welche Beträge tatsächlich autorisiert, gebucht oder gutgeschrieben worden sind. Vor allem vor der Ausführung von Stornos über die Schnittstelle reverse.aspx empfiehlt es sich, den Transaktionsstatus mit der inquire.aspx prüfen, denn die Reverse.aspx macht nicht nur Autorisierungen, sondern IMMER DEN LETZTEN TRANSAKTIONSSCHRITT rückgängig.
Abfragen des Transaktionsstatus basierend auf der PayID sind über eine Server-zu-Server-Kommunikation möglich. Um den Status einer Transaktion über eine Server-zu-Server-Verbindung abzufragen (englisch: inquire), verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/inquire.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. |
| 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 | TransaktionsID, die für jede Zahlung eindeutig sein muss |
Parameter für Statusabfragen über Socket-Verbindungen
Die folgende Tabelle beschreibt die Ergebnis-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. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
| MID | ans..30 | M | HändlerID, die von der 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 oder FAILED als Status der Abfrage, nicht der angefragten Transaktion |
| 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 |
| AmountAuth | n..10 | O | Genehmigter Betrag |
| AmountCap | n..10 | O | Gebuchter Betrag |
| AmountCred | n..10 | O | Gutgeschriebener Betrag |
| Currency | a3 | O | Währungskürzel, drei Zeichen DIN / ISO 4217. Für Zahlungsarten ohne Parameter „Currency“ wird nichts zurückgegeben. |
| LastStatus | a..50 | O | Status der letzten Transaktion (Autorisierung, Buchung oder Gutschrift) |
2.2 Statusabfragen per TransID
Abfragen des Transaktionsstatus basierend auf der TransID sind über eine Server-zu-Server-Kommunikation möglich. Um den Status einer Transaktion über eine Server-zu-Server-Verbindung abzufragen (englisch: inquire), verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/inquire24.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. |
| TransID | ans..64 | M | TransaktionsID, die für jede Zahlung eindeutig sein muss |
Die folgende Tabelle beschreibt die Ergebnis-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. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
| MID | ans..30 | M | HändlerID, die von der 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 oder FAILED als Status der Abfrage, nicht der angefragten Transaktion |
| 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äß Paygate Antwort-Codes (A4 Fehlercodes). Bezieht sich auf die Abfrage und nicht auf die angefragte Transaktion. |
| AmountAuth | n..10 | O | Genehmigter Betrag |
| AmountCap | n..10 | O | Gebuchter Betrag |
| AmountCred | n..10 | O | Gutgeschriebener Betrag |
| Currency | a3 | O | Währungskürzel, drei Zeichen DIN / ISO 4217. Für Zahlungsarten ohne Parameter „Currency“ wird nichts zurückgegeben. |
| LastStatus | a..50 | O | Status der letzten Transaktion (Autorisierung, Buchung oder Gutschrift) |
| LastXCode | n8 | O | Fehlercode der letzten Transaktion gemäß Excel-Datei 1cs Online Bezahlsystem Antwort Codes |
| LastXAmount | n..10 | O | Betrag in der kleinsten Währungseinheit (z.B. EUR Cent) |
| CCBrand | a..22 | O | Kreditkartenmarke (z.B. Visa, MasterCard, Maestro usw.) Rückgabe nur nach Konfiguration durch Merchant Services (Computop Helpdesk). |
Hinweis: Der Parameter LastStatus reicht nicht aus, um den Status zu ermitteln, weil er nur den Status der letzten Transaktion liefert. Beispielsweise liefert LastStatus den Status Failed, wenn eine Gutschrift gescheitert ist, obwohl vorher Autorisierung und Buchung erfolgreich waren. Den genauen Status erfahren Sie über die Felder AmountAuth, AmountCap und AmountCred.
