Über Zinia
Allgemeine Informationen über Zinia
Zinia ist eine „Buy Now Pay Later“-Lösung der Santander Bank. Mit Zinia können Kunden in ihrem eigenen Tempo bezahlen. Genießen Sie beim Einkaufen mit Zinia völlige Freiheit. Außerdem keine Zinsen oder versteckten Kosten! Klingt gut, oder? Nur 2 einfache Schritte für die Zahlung an der Kasse
1. Der Kunde wählt Zinia als Zahlungsoption.
- In 30 Tagen bezahlen: Der Kunde hat bis zu 30 Tage nach dem Versand Zeit, per Banküberweisung zu bezahlen.
- In bis zu 36 Raten bezahlen: Wählen Sie an der Kasse die Finanzierungslaufzeit aus, die für den Kunden am besten geeignet ist. Die Raten werden alle 30 Tage nach dem Versand fällig.
2. Geben Sie die Handynummer und das Geburtsdatum des Kunden ein.
Die Zahlung mit Zinia im Online-Shop motiviert Kunden, hochwertige Warenkörbe zu bestellen. Dies erhöht auch den Umsatz.
| Logo |
|
|---|---|
| Info | Zinia bietet die Option „Jetzt kaufen, später bezahlen“ für Einkäufe an |
| Typ | Zahlungen per Rechnungs- und Ratenkauf |
Weitere Informationen finden Sie auf der Webseite von Zinia (https://www.zinia.com).
Diagramm zum Prozessablauf
Zinia Prozessablauf
Paygate-Schnittstelle
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) CND Bedingung (condition) M Pflicht (mandatory) O optional C bedingt (conditional) Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.Definitionen
Datenformate
Format Beschreibung Abkürzungen
Abkürzung Beschreibung Kommentar Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist
Zinia
Eine Zahlung mit Zinia besteht aus zwei Transaktionsschritten. Zu Beginn ist eine Initialisierung notwendig, die die Weiterleitungs-URL zurückgibt, zu der der Kunde weitergeleitet werden muss. Nach der Weiterleitung kann der Kunde die von Zinia angebotene Zahlungsmethode auswählen, um den Checkout abzuschließen.
Computop Zinia kennt 2 unterschiedliche Anfragen, die je nach Situation und Fortschritt im Zahlungsprozess ausgeführt werden müssen. Computop andelt diese Anfragen in die entsprechenden Zinia-Anfragen um. Dabei gilt folgendes Mapping:
Computop-Anfrage | Zinia-Anfrage | Beschreibung |
|---|---|---|
| Authorize | Merchant_login Create_order | Computop Führt die Anfragen automatisch aus, sofern die Händler-API-Anmeldeinformationen im MAT konfiguriert sind. Mit dem Händler-Login erhalten Sie ein Zugriffstoken für den Bezahlvorgang und mit der Bestellung wird die Zahlung eingeleitet. |
| Capture | Capture | Aktiviert und/oder führt die Zahlung durch. Diese Aufforderung muss beim Versand der Ware erfolgen. |
Initialisierung von Zinia-Zahlungen
Um eine Zinia-Zahlung über eine Server-zu-Server-Kommunikationzu initialisieren, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/Zinia.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Amount | n..10 | M | Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayType | enum | M | Enum: BNPL, INSTALMENTS |
| pmtChannel | enum | M | Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER und CLICKANDCOLLECT |
| OrderDesc | ans..768 | O | Beschreibung der gekauften Waren |
| ans..255 | M | E-Mail-Adresse des Karteninhabers | |
| CustomerID | an..30 | O | Eindeutige ID des Kunden im Händlersystem oder die E-Mail-Adresse des Kunden |
| Title | ans..45 | O | Titel |
| Salutation | ans..45 | O | Anrede |
| Gender | a1 | M | Geschlecht: M=männlich, F=weiblich, U=unbekannt |
| DateOfBirth | dttm8 | C | Geburtsdatum im Format JJJJMMTT |
| PhoneAreaCode | ans..30 | C | Telefonvorwahl. Pflicht, wenn kein MobileAreaCode übergeben ist. |
| Phone | ans..30 | C | Rufnummer. Pflicht, wenn kein Mobile übergeben ist. |
| FaxAreaCode | ans..30 | O | Fax-Vorwahl |
| Fax | ans..30 | O | Faxnummer |
| MobileAreaCode | ans..30 | C | Mobil-Vorwahl. Pflicht, wenn kein PhoneAreaCode übergeben ist. |
| Mobile | ans..30 | C | Mobiltelefonnummer. Pflicht, wenn kein Phone übergeben ist. |
| ShopSystem | ans..127 | O | Name des Shop-Systems |
| ShopSystemVersion | ans..127 | O | Versionsname des Shop-Systems |
| Kundendaten | |||
| CompanyName | ans..100 | C | Firmenname |
| CompanyID | ans..100 | C | Registrierungs-ID der Organisation (für den Fall, dass der Kundentyp ein Unternehmen ist) (Nur für B2B-Kunden). Beispiel: 123423-CO |
| CustomerType | enum | M | PERSON oder COMPANY |
| docNumber | ans..100 | M | Nummer des Rechtsdokuments |
| docType | enum | M | Rechtsdokumenttyp ENUM: NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER und PASSPORT |
| Lieferdaten | |||
| sdSalutation | ans..45 | O | Anrede |
| sdCompany | ans..100 | O | Firmenname |
| sdFirstName | ans..100 | M | Vorname des Kunden |
| sdLastName | ans..100 | M | Nachname des Kunden |
| sdStreet | ans..100 | M | Straßenname |
| sdStreetNr | an..10 | M | Hausnummer |
| sdStreetAddition | ans..50 | O | Zusatz in der Lieferadresse |
| sdZIP | ans..10 | M | Postleitzahl |
| sdCity | ans..255 | M | Ort |
| sdCountryCode | a2 | M | Ländercode zweistellig gemäß ISO 3166 |
| sdPhone | ns..32 | O | Telefonnummer des Kunden |
| Rechnungsdaten | |||
| bdSalutation | ans..45 | O | Anrede |
| bdCompany | ans..100 | O | Firmenname |
| bdFirstName | ans..100 | M | Vorname des Kunden |
| bdLastName | ans..100 | M | Nachname des Kunden |
| bdCompanyName | ans..100 | O | Firmenname |
| bdStreet | ans..50 | M | Straßenname der Rechnungsadresse |
| bdStreetNr | an..10 | M | Hausnummer der Rechnungsadresse |
| bdStreetAddition | ans..50 | O | Adresszusatz der Rechnungsadresse |
| bdZIP | ans..10 | M | Postleitzahl der Rechnungsadresse |
| bdCity | ans..255 | M | Ort der Rechnungsadresse |
| bdCountryCode | a2 | M | Ländercode der Rechnungsadresse zweistellig gemäß ISO 3166 |
| bdPhone | ns..32 | M | Telefonnummer des Kunden |
| Registrierungsadresse (B2B) | |||
| FirstName | ans..100 | M | Vorname |
| LastName | ans..100 | M | Nachname |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| URLSuccess | ans..256 | M | Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData.
|
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| URLFailure | ans..256 | M | Vollständige URL, die das Paygate aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData.
|
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| URLNotify | ans..256 | M | Vollständige URL, die das Paygate 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.
|
Parameter für die Initialisierung von Zinia-Zahlungen
ArticleList
Hier werden die Artikelinformationen definiert. Bitte beachten Sie, dass die ArticleList Base64-kodiert sein sollte, wie im folgenden Beispiel beschrieben.
Key | Format | CND | Beschreibung |
|---|---|---|---|
| ArticleList.name | ans..64 | M | Artikelname |
ArticleList.description | ans..64 | M | Artikelbeschreibung |
| ArticleList.id | n..8 | M | Artikel-ID |
| ArticleList.imageUrl | ans..64 | O | Bild-URL des Artikels |
ArticleList.amount | ans..16 | M | Nettopreis pro Artikel. Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen. Dieser Wert muss mit dem Wert im Parameter „Amount“ übereinstimmen. |
ArticleList.currency | ans..16 | M | Währung, in der der Artikel verkauft wird |
ArticleList.quantity | ans..16 | M | Anzahl der Artikel |
ArticleList.totalAmount | ans..16 | M | Bruttopreis pro Artikel. Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen. |
ArticleList.vatPercent | ans..16 | M | Mehrwehrtsteuer in Prozent |
ArticleList.vatAmount | ans..256 | M | Mehrwertsteuer als Betrag pro Artikel. Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen. |
ArticleList.discount | ans..16 | M | Rabattbetrag (nur für statistische Zwecke). Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen. |
Beispiel von ArticleList als JSON-String
{
"items":
[{
"id": "1234",
"description": "iPhone 13 128GB Pink",
"name": "iPhone 13 Pink",
"quantity": 1,
"amount": 729,
"currency": "EUR",
"vatAmount": 0,
"vatPercent": 0,
"discount": "0"
}]
}
ArticleList=eyJpdGVtcyI6IFt7ImlkIjogIjEyMzQiLCJkZXNjcmlwdGlvbiI6ICJpUGhvbmUgMTMgMTI4R0IgUGluayIsIm5hbWUiOiAiaVBob25lIDEzIFBpbmsiLCJxdWFudGl0eSI6IDEsImFtb3VudCI6IDcyOSwiY3VycmVuY3kiOiAiRVVSIiwidmF0QW1vdW50IjogMCwidmF0UGVyY2VudCI6IDAsImRpc2NvdW50IjogIjAifV19
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:
es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
Key | Format | CND | Beschreibung |
|---|---|---|---|
Status | a..50 | M | INIT oder FAILED |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| refnr | ans..30 | O | Eindeutige Referenznummer des Händlers |
Key | Format | CND | Beschreibung |
|---|---|---|---|
InfoText | ans..1024 | O | Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung) |
| ExternalMessage | ans..256 | O | Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen |
| ExternalCode | ans..64 | O | Fehlercode von Zinia, wenn mit Computop Helpdesk abgesprochen |
Antwort-Parameter für die Initialisierung von Zinia-Zahlungen
Buchung einer Zinia-Zahlungstransaktion (Voll- / Teilbuchung)
Um eine Zahlungstransaktion mit Zinia zu buchen, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/capture.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die zu buchende Zahlung |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Amount | n..10 | M | Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| ReqId | ans..32 | O | 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 Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate 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 Paygate 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 Paygate gelöscht. |
Key | Format | CND | Beschreibung |
|---|---|---|---|
| InvoiceID | ans..50 | O | Rechnungsnummer |
| InvoiceUrl | ans..256 | O | RechnungsURL |
Parameter für Buchungen von Zinia-Zahlungen
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung |
|---|---|---|---|
InfoText | ans..1024 | O | Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung) |
| ExternalMessage | ans..256 | O | Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen |
| ExternalCode | ans..64 | O | Fehlercode von Zinia, wenn mit Computop Helpdesk abgesprochen |
Antwort-Parameter für Buchungen von Zinia-Zahlungen
Gutschrift von Zinia-Zahlungen
Um eine Zahlungstransaktion mit Zinia gutzuschreiben, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/credit.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die gutzuschreibende Zahlung |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Amount | n..10 | M | Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| ReqId | ans..32 | O | 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 Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate 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 Paygate 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 Paygate gelöscht. |
Parameter für Gutschriften von Zinia-Zahlungen
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung |
|---|---|---|---|
InfoText | ans..1024 | O | Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung) |
| ExternalMessage | ans..256 | O | Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen |
| ExternalCode | ans..64 | O | Fehlercode von Zinia, wenn mit Computop Helpdesk abgesprochen |
Antwort-Parameter für Gutschriften von Zinia-Zahlungen
Storno / Rückgabe von Zinia-Zahlungen
Um eine Zinia-Zahlung teilweise oder vollständig zu stornierenoder Änderungen an einer Zahlung vorzunehmen, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/reverse.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate 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 |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Amount | n..10 | M | Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Currency | a3 | M | Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
an64 | M | Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| ReqId | ans..32 | O | 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 Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück. Bitte beachten Sie, dass das Computop Paygate 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 Paygate 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 Paygate gelöscht. |
Parameter für Storno von Zinia-Zahlungen
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
| Key | Format | CND | Beschreibung |
|---|---|---|---|
ans..30 | M | HändlerID, die von Computop vergeben wird |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| PayID | an32 | M | Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request. |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| XID | an32 | M | Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| TransID | ans..64 | M | Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Status | a..50 | M | OK (URLSuccess) oder FAILED (URLFailure) |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| 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! |
| Key | Format | CND | Beschreibung |
|---|---|---|---|
| Code | an8 | M | Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes) |
Key | Format | CND | Beschreibung |
|---|---|---|---|
InfoText | ans..1024 | O | Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung) |
| ExternalMessage | ans..256 | O | Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen |
| ExternalCode | ans..64 | O | Fehlercode von Zinia, wenn mit Computop Helpdesk abgesprochen |
Antwort-Parameter für Storno von Zinia-Zahlungen
Einschränkungen für die Zinia Sandbox
Bei Verwendung der Zinia Sandbox gelten die folgenden Einschränkungen:
- Der Amount kann nicht kleiner als 50€ sein
- Der Nachname muss "ZINIA_AP" sein
- Das OTP (Einmalpasswort) ist stets “9999”