Ü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

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjE2MDMzNDgxMyIsImRpYWdyYW1OYW1lIjoiUHJvY2Vzc0Zsb3dfWmluaWFfQ1QiLCJhc3BlY3QiOiIiLCJsaW5rcyI6ImF1dG8iLCJjZW9OYW1lIjoiWmluaWEiLCJ0YnN0eWxlIjoidG9wIiwiY2FuQ29tbWVudCI6ZmFsc2UsImRpYWdyYW1VcmwiOiIiLCJjc3ZGaWxlVXJsIjoiIiwiYm9yZGVyIjp0cnVlLCJtYXhTY2FsZSI6IjEiLCJvd25pbmdQYWdlSWQiOjEwOTk3MDM5MCwiZWRpdGFibGUiOmZhbHNlLCJjZW9JZCI6MTA5OTcwMzkwLCJwYWdlSWQiOiIiLCJsYm94Ijp0cnVlLCJzZXJ2ZXJDb25maWciOnsiZW1haWxwcmV2aWV3IjoiMSJ9LCJvZHJpdmVJZCI6IiIsInJldmlzaW9uIjowLCJtYWNyb0lkIjoiZjdmYjAyOTYtNzkxNi00MTFiLTlhYmEtYWMxODFjZTc5ZWFhIiwicHJldmlld05hbWUiOiJQcm9jZXNzRmxvd19aaW5pYV9DVC5wbmciLCJsaWNlbnNlU3RhdHVzIjoiT0siLCJzZXJ2aWNlIjoiIiwiaXNUZW1wbGF0ZSI6IiIsIndpZHRoIjoiMTEwOCIsInNpbXBsZVZpZXdlciI6ZmFsc2UsImxhc3RNb2RpZmllZCI6IkphbiAxMCwgMjAyNSwgNzozOToyNyBBTSIsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9

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
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

Key	Format	CND	Description
refnr	ans..30	O	Merchant’s unique reference number

Key	Format	CND	Description
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).

Key	Format	CND	Description
Currency	a3	M	Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Key	Format	CND	Description
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)

Key	Format	CND	Description
PayType	enum	M	Enum: BNPL, INSTALMENTS
pmtChannel	enum	M	Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER and CLICKANDCOLLECT
OrderDesc	ans..768	O	Description of the goods purchased
E-mail	ans..255	M	eMail address of the card holder
CustomerID	an..30	O	Unique customer ID in merchant system or the customer’s email address
Title	ans..45	O	Title
Salutation	ans..45	O	Salutation
Gender	a1	M	Gender: Sex (M=male / F=female / U=unknown)
DateOfBirth	dttm8	C	Date of birth in the format YYYYMMDD
PhoneAreaCode	ans..30	C	Telephone code. Mandatory if MobileAreaCode is not transmitted.
Phone	ans..30	C	Phone number. Mandatory if Mobile is not transmitted.
FaxAreaCode	ans..30	O	Fax area code
Fax	ans..30	O	Fax number
MobileAreaCode	ans..30	C	Mobile area code. Mandatory if PhoneAreaCode is not transmitted.
Mobile	ans..30	C	Mobile telephone number. Mandatory if Phone is not transmitted.
ShopSystem	ans..127	O	Name of the shop system
ShopSystemVersion	ans..127	O	Version name of the shop system
			Customer data
CompanyName	ans..100	C	Company name
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
CustomerType	enum	M	PERSON or COMPANY
docNumber	ans..100	M	Legal document number
docType	enum	M	Legal document type ENUM: NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER and PASSPORT
			Delivery data
sdSalutation	ans..45	O	Salutation
sdCompany	ans..100	O	Company name
sdFirstName	ans..100	M	First name of the customer
sdLastName	ans..100	M	Last name of the customer
sdStreet	ans..100	M	Street name
sdStreetNr	an..10	M	Street number
sdStreetAddition	ans..50	O	Addition in the delivery address
sdZIP	ans..10	M	Postcode
sdCity	ans..255	M	City
sdCountryCode	a2	M	Two characters country code according to ISO 3166
sdPhone	ns..32	O	Customer’s phone number
			Invoice data
bdSalutation	ans..45	O	Salutation
bdCompany	ans..100	O	Company name
bdFirstName	ans..100	M	First name of the custumer
bdLastName	ans..100	M	Last name of the customer
bdCompanyName	ans..100	O	Name of company
bdStreet	ans..50	M	Street name in the invoicing address
bdStreetNr	an..10	M	Street number of the invoicing address
bdStreetAddition	ans..50	O	Address addition in the billing address
bdZIP	ans..10	M	Postcode in the invoicing address
bdCity	ans..255	M	Town/city of the invoicing address
bdCountryCode	a2	M	Country code for the invoicing address, 2 characters according to ISO 3166
bdPhone	ns..32	M	Customer’s phone number
			Registration address (B2B)
FirstName	ans..100	M	First name
LastName	ans..100	M	Last name

Key	Format	CND	Description
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.

Key	Format	CND	Description
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.

Key	Format	CND	Description
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: Before follow-up actions (capture / credit / reversal) are carried out on an existing transaction, the first Notify must have been answered by the shop. 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.

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
ArticleList.name	ans..64	M	Article Name
ArticleList.description	ans..64	M	Article description
ArticleList.id	n..8	M	Article ID
ArticleList.imageUrl	ans..64	O	Image URL of the Article
ArticleList.amount	ans..16	M	Net price per article. Please note, that values has to be specified with “.” as decimal separator. This value has to be the same as the value in the parameter „Amount“.
ArticleList.currency	ans..16	M	Currency the article is sold in
ArticleList.quantity	ans..16	M	Number of articles
ArticleList.totalAmount	ans..16	M	Gross price per article. Please note, that values has to be specified with “.” as decimal separator.
ArticleList.vatPercent	ans..16	M	VAT in percent
ArticleList.vatAmount	ans..256	M	VAT as amount per item. Please note, that values has to be specified with “.” as decimal separator.
ArticleList.discount	ans..16	M	Discount amount (only for statistical purposes). Please note, that values has to be specified with “.” as decimal separator.

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
mid	ans..30	M	MerchantID, assigned by Computop

Key	Format	CND	Description
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.

Key	Format	CND	Description
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

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

Key	Format	CND	Description
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!

Key	Format	CND	Description
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)

Key	Format	CND	Description
refnr	ans..30	O	Merchant’s unique reference number

Key	Format	CND	Description
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with Computop Helpdesk
ExternalCode	ans..64	O	Error code from Zinia, if agreed with Computop Helpdesk

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
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

Key	Format	CND	Description
PayID	an32	M	ID assigned by Paygate for the payment to be captured

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

Key	Format	CND	Description
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).

Key	Format	CND	Description
Currency	a3	M	Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Key	Format	CND	Description
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)

Key	Format	CND	Description
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.

Key	Format	CND	Description
InvoiceID	ans..50	O	Invoice number
InvoiceUrl	ans..256	O	Invoice URL

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
mid	ans..30	M	MerchantID, assigned by Computop

Key	Format	CND	Description
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.

Key	Format	CND	Description
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

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

Key	Format	CND	Description
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!

Key	Format	CND	Description
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)

Key	Format	CND	Description
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with Computop Helpdesk
ExternalCode	ans..64	O	Error code from Zinia, if agreed with Computop Helpdesk

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
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

Key	Format	CND	Description
PayID	an32	M	ID assigned by Paygate for the payment to be credited

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

Key	Format	CND	Description
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).

Key	Format	CND	Description
Currency	a3	M	Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Key	Format	CND	Description
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)

Key	Format	CND	Description
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.

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
mid	ans..30	M	MerchantID, assigned by Computop

Key	Format	CND	Description
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.

Key	Format	CND	Description
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

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

Key	Format	CND	Description
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!

Key	Format	CND	Description
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)

Key	Format	CND	Description
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with Computop Helpdesk
ExternalCode	ans..64	O	Error code from Zinia, if agreed with Computop Helpdesk

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
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

Key	Format	CND	Description
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.

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

Key	Format	CND	Description
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).

Key	Format	CND	Description
Currency	a3	M	Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Key	Format	CND	Description
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)

Key	Format	CND	Description
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.

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
mid	ans..30	M	MerchantID, assigned by Computop

Key	Format	CND	Description
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.

Key	Format	CND	Description
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

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

Key	Format	CND	Description
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!

Key	Format	CND	Description
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)

Key	Format	CND	Description
InfoText	ans..1024	O	Contains an infotext which can be forwarded to the customer (e.g. at refusal)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with Computop Helpdesk
ExternalCode	ans..64	O	Error code from Zinia, if agreed with Computop Helpdesk

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”

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

Einschränkungen für die Zinia Sandbox

Paygate

Computop

Help

Intranet Tools