Ü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

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjE2MDMzNDgxMyIsImRpYWdyYW1OYW1lIjoiUHJvY2Vzc0Zsb3dfWmluaWFfQ1QiLCJhc3BlY3QiOiIiLCJsaW5rcyI6ImF1dG8iLCJjZW9OYW1lIjoiWmluaWEiLCJ0YnN0eWxlIjoidG9wIiwiY2FuQ29tbWVudCI6ZmFsc2UsImRpYWdyYW1VcmwiOiIiLCJjc3ZGaWxlVXJsIjoiIiwiYm9yZGVyIjp0cnVlLCJtYXhTY2FsZSI6IjEiLCJvd25pbmdQYWdlSWQiOjEwOTk3MDM5MCwiZWRpdGFibGUiOmZhbHNlLCJjZW9JZCI6MTA5OTcwMzkwLCJwYWdlSWQiOiIiLCJsYm94Ijp0cnVlLCJzZXJ2ZXJDb25maWciOnsiZW1haWxwcmV2aWV3IjoiMSJ9LCJvZHJpdmVJZCI6IiIsInJldmlzaW9uIjowLCJtYWNyb0lkIjoiYWJlNDZjOTQtZmQxNS00YTU0LTgxMjItYTQyYmJjNDFjZmMyIiwicHJldmlld05hbWUiOiJQcm9jZXNzRmxvd19aaW5pYV9DVC5wbmciLCJsaWNlbnNlU3RhdHVzIjoiT0siLCJzZXJ2aWNlIjoiIiwiaXNUZW1wbGF0ZSI6IiIsIndpZHRoIjoiMTEwOCIsInNpbXBsZVZpZXdlciI6ZmFsc2UsImxhc3RNb2RpZmllZCI6IkphbiAxMCwgMjAyNSwgNzozOToyNyBBTSIsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9

Zinia Prozessablauf

Paygate-Schnittstelle

Definitionen

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)

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.

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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ans..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	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	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
PayType	enum	M	Enum: BNPL, INSTALMENTS	Enum: BNPL, INSTALMENTS
pmtChannel	enum	M	Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER and CLICKANDCOLLECT	Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER und CLICKANDCOLLECT
OrderDesc	ans..768	O	Description of the goods purchased	Beschreibung der gekauften Waren
E-mail	ans..255	M	eMail address of the card holder	E-Mail-Adresse des Karteninhabers
CustomerID	an..30	O	Unique customer ID in merchant system or the customer’s email address	Eindeutige ID des Kunden im Händlersystem oder die E-Mail-Adresse des Kunden
Title	ans..45	O	Title	Titel
Salutation	ans..45	O	Salutation	Anrede
Gender	a1	M	Gender: Sex (M=male / F=female / U=unknown)	Geschlecht: M=männlich, F=weiblich, U=unbekannt
DateOfBirth	dttm8	C	Date of birth in the format YYYYMMDD	Geburtsdatum im Format JJJJMMTT
PhoneAreaCode	ans..30	C	Telephone code. Mandatory if MobileAreaCode is not transmitted.	Telefonvorwahl. Pflicht, wenn kein MobileAreaCode übergeben ist.
Phone	ans..30	C	Phone number. Mandatory if Mobile is not transmitted.	Rufnummer. Pflicht, wenn kein Mobile übergeben ist.
FaxAreaCode	ans..30	O	Fax area code	Fax-Vorwahl
Fax	ans..30	O	Fax number	Faxnummer
MobileAreaCode	ans..30	C	Mobile area code. Mandatory if PhoneAreaCode is not transmitted.	Mobil-Vorwahl. Pflicht, wenn kein PhoneAreaCode übergeben ist.
Mobile	ans..30	C	Mobile telephone number. Mandatory if Phone is not transmitted.	Mobiltelefonnummer. Pflicht, wenn kein Phone übergeben ist.
ShopSystem	ans..127	O	Name of the shop system	Name des Shop-Systems
ShopSystemVersion	ans..127	O	Version name of the shop system	Versionsname des Shop-Systems
			Customer data	Kundendaten
CompanyName	ans..100	C	Company name	Firmenname
CompanyID	ans..100	C	Registration ID of the Organization (in the event that the customer type is a company) (Only for B2B customers). Example: 123423-CO	Registrierungs-ID der Organisation (für den Fall, dass der Kundentyp ein Unternehmen ist) (Nur für B2B-Kunden). Beispiel: 123423-CO
CustomerType	string	O	PERSON or COMPANY	PERSON oder COMPANY
docNumber	string	O	Legal document number	Nummer des Rechtsdokuments
docType	enum	O	Legal document type ENUM: NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER and PASSPORT	Rechtsdokumenttyp ENUM: NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER und PASSPORT
			Delivery data	Lieferdaten
sdSalutation	ans..45	O	Salutation	Anrede
sdCompany	ans..100	O	Company name	Firmenname
sdFirstName	ans..100	M	First name of the customer	Vorname des Kunden
sdLastName	ans..100	M	Last name of the customer	Nachname des Kunden
sdStreet	ans..100	O	Street name and house number	Straßenname und Hausnummer
sdStreetHouseNumber	ans..10	O	Street number	Hausnummer
sdStreetAddition	ans..50	O	Addition in the delivery address	Zusatz in der Lieferadresse
sdZIPCode	ans..10	O	Postcode	Postleitzahl
sdCity	ans..255	O	City	Ort
sdCountryCode	a2	O	Two characters country code according to ISO 3166	Ländercode zweistellig gemäß ISO 3166
sdPhone	ns..32	O	Customer’s phone number	Telefonnummer des Kunden
			Invoice data	Rechnungsdaten
bdSalutation	ans..45	O	Salutation	Anrede
bdCompany	ans..100	O	Company name	Firmenname
bdFirstName	ans..100	M	First name of the custumer	Vorname des Kunden
bdLastName	ans..100	M	Last name of the customer	Nachname des Kunden
bdCompanyName	ans..100	O	Name of company	Firmenname
bdStreet	ans..50	M	Street name in the invoicing address	Straßenname der Rechnungsadresse
bdStreetNr	ans..10	M	Street number of the invoicing address	Hausnummer der Rechnungsadresse
bdStreetAddition	ans..50	O	Address addition in the billing address	Adresszusatz der Rechnungsadresse
bdZIP	ans..10	M	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdCity	ans..255	M	Town/city of the invoicing address	Ort der Rechnungsadresse
bdCountryCode	a2	M	Country code for the invoicing address, 2 characters according to ISO 3166	Ländercode der Rechnungsadresse zweistellig gemäß ISO 3166
bdPhone	ns..32	M	Customer’s phone number	Telefonnummer des Kunden
			Registration address (B2B)	Registrierungsadresse (B2B)
FirstName	ans..100	M	First name	Vorname
LastName	ans..100	M	Last name	Nachname

Key	Format	CND	Description	Beschreibung
URLSuccess	ans..256	M	Complete URL which calls up Paygate if payment has been successful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData. Common notes: We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.	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. Allgemeine Hinweise: Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von Paygate zu erhalten Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key	Format	CND	Description	Beschreibung
URLFailure	ans..256	M	Complete URL which calls up Paygate if payment has been unsuccessful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData. Common notes: We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.	Vollständige URL, die das Paygateaufruft, 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. Allgemeine Hinweise: Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von Paygate zu erhalten Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key	Format	CND	Description	Beschreibung
URLNotify	ans..256	M	Complete URL which Paygate calls up in order to notify the shop about the payment result. The URL may be called up only via port 443. It may not contain parameters: Use the UserData parameter instead. Common notes: Fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.	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. Allgemeine Hinweise: Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

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.

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
ArticleList.name	ans..64	M	Article Name	Artikelname
ArticleList.description	ans..64	M	Article description	Artikelbeschreibung
ArticleList.id	ans..128	M	Article ID	Artikel-ID
ArticleList.imageUrl	n..8	O	Image URL of the Article	Bild-URL des Artikels
ArticleList.amount	ans..16	M	Gross price per article. Please note, that values has to be specified with “.” as decimal separator.	Bruttopreis pro Artikel. Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen.
ArticleList.quantity	ans..16	M	Net price per article. Please note, that values has to be specified with “.” as decimal separator.	Nettopreis pro Artikel. Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen.
ArticleList.totalAmount	n..2	M	VAT in percent	Mehrwertsteuer in Prozent
ArticleList.vatPercent	ans..16	O	VAT as amount per item Please note, that values has to be specified with “.” as decimal separator.	Mehrwertsteuer. als Betrag pro Artikel. Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen.
ArticleList.vatAmount	ans..256	O	URL for order image. This image can be viewed on the invoice or next to the installment payment in the Riverty portal. Limited to 100-1280px.	URL für Bestellbild. Dieses Bild ist auf der Rechnung oder neben der Ratenzahlung im Riverty-Portal zu sehen. Begrenzt auf 100-1280px.
ArticleList.discount	ans..16	O	Discount amount (only for statistical purposes). Please note, that values has to be specified with “.” as decimal separator.	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

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
Status	a..50	M	INIT or FAILED	INIT oder FAILED

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	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	Description	Beschreibung
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
refnr	ans..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with Computop Helpdesk	Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Zinia, if agreed with Computop Helpdesk	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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment to be captured	Vom Paygate vergebene ID für die zu buchende Zahlung

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	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	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
ReqId	ans..32	O	To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.	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	Description	Beschreibung
InvoiceID	ans..50	O	Invoice number	Rechnungsnummer
InvoiceUrl	ans..256	O	Invoice URL	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

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	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	Description	Beschreibung
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with Computop Helpdesk	Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Zinia, if agreed with Computop Helpdesk	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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment to be credited	Vom Paygate vergebene ID für die gutzuschreibende Zahlung

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	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	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
ReqId	ans..32	O	To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.	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

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	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	Description	Beschreibung
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with Computop Helpdesk	Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Zinia, if agreed with Computop Helpdesk	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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).	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	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
ReqId	ans..32	O	To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action. Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly. Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.	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

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate	Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure)	OK (URLSuccess) oder FAILED (URLFailure)

Key	Format	CND	Description	Beschreibung
Description	ans..1024	M	Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!	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	Description	Beschreibung
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)	Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with Computop Helpdesk	Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen
ExternalCode	ans..64	O	Error code from Zinia, if agreed with Computop Helpdesk	Fehlercode von Zinia, wenn mit Computop Helpdesk abgesprochen

Antwort-Parameter für Storno von Zinia-Zahlungen

Space shortcuts

Page tree

Über Zinia

Allgemeine Informationen über Zinia

Diagramm zum Prozessablauf

Paygate-Schnittstelle

Definitionen

Datenformate

Abkürzungen

Zinia

Initialisierung von Zinia-Zahlungen

ArticleList

Beispiel von ArticleList als JSON-String

Buchung einer Zinia-Zahlungstransaktion (Voll- / Teilbuchung)

Gutschrift von Zinia-Zahlungen

Storno / Rückgabe von Zinia-Zahlungen

Paygate

Computop

Help

Intranet Tools