About Zinia

General information about Zinia

Zinia is a Buy Now Pay Later solution offered by Santander Bank. Customer can pay at their own pace with Zinia. Enjoy total freedom when shopping with Zinia. Plus, no interest or hidden costs! Sounds good, right? Just 2 simple steps for the payment at checkout

1. Customer choose Zinia as the payment option.

Pay in 30 days: customer have up to 30 days after shipment to pay via bank transfer.
Pay in up to 36 instalments: At checkout, select the financing term that works best for customer. The instalments will be due every 30 days after the shipment.

2. Enter customer mobile number and date of birth.

Zinia payment at the online shop motivates customers to order high value baskets. This also increases the turnover.

Logo
Info	Zinia offers Buy Now Pay Later solution on purchases
Type	Payments by Invoice and Installments

Further information can be found on the webpage of Zinia (http://www.Zinia.com).

Process flow chart

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjEwOTk3MDM5NiIsImRpYWdyYW1OYW1lIjoiUmF0ZXBheV9Db21wdXRvcCIsImFzcGVjdCI6IiIsImxpbmtzIjoiYXV0byIsImNlb05hbWUiOiJaaW5pYSIsInRic3R5bGUiOiJ0b3AiLCJjYW5Db21tZW50IjpmYWxzZSwiZGlhZ3JhbVVybCI6IiIsImNzdkZpbGVVcmwiOiIiLCJib3JkZXIiOnRydWUsIm1heFNjYWxlIjoiMSIsIm93bmluZ1BhZ2VJZCI6MTA5OTcwMzkwLCJlZGl0YWJsZSI6ZmFsc2UsImNlb0lkIjoxMDk5NzAzOTAsInBhZ2VJZCI6IiIsImxib3giOnRydWUsInNlcnZlckNvbmZpZyI6eyJlbWFpbHByZXZpZXciOiIxIn0sIm9kcml2ZUlkIjoiIiwicmV2aXNpb24iOjAsIm1hY3JvSWQiOiI2NWNlOTRmOS1kZjg4LTQzYmItYmExZi05ODJhOTFjYzY0NGIiLCJwcmV2aWV3TmFtZSI6IlJhdGVwYXlfQ29tcHV0b3AucG5nIiwibGljZW5zZVN0YXR1cyI6Ik9LIiwic2VydmljZSI6IiIsImlzVGVtcGxhdGUiOiIiLCJ3aWR0aCI6IjExMDkiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOiJPY3QgOSwgMjAyMywgMTA6MzQ6MzAgQU0iLCJleGNlZWRQYWdlV2lkdGgiOmZhbHNlLCJvQ2xpZW50SWQiOiIifQ==

Zinia process flow

Paygate interface

Definitions

Data formats

Format	Description
a	alphabetical
as	alphabetical with special characters
n	numeric
an	alphanumeric
ans	alphanumeric with special characters
ns	numeric with special characters
bool	boolean expression (true or false)
3	fixed length with 3 digits/characters
..3	variable length with maximum 3 digits/characters
enum	enumeration of allowed values
dttm	ISODateTime (YYYY-MM-DDThh:mm:ss)

Abbreviations

Abbreviation	Description	Comment
CND	condition
M	mandatory	If a parameter is mandatory, then it must be present
O	optional	If a parameter is optional, then it can be present, but it is not required
C	conditional	If a parameter is conditional, then there is a conditional rule which specifies whether it is mandatory or optional

Notice: Please note that the names of parameters can be returned in upper or lower case.

Zinia

A payment with Zinia consists of two transaction steps. At the start an initialization is necessary, which returns the redirect url where the customer has to be redirected. The customer after redirected can choose payment method offered by zinia to complete the checkout.

Computop Zinia has 2 different requests which must be carried out in the payment process depending on the situation and progress. Computop converts these requests into the corresponding Zinia requests. In this case the following mapping applies:

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

Computop request	Zinia request	Description	Beschreibung
Authorize	Merchant_login Create_order	Computop executes automatically the requests, Provided the merchant API credentials are configured in the MAT. merchant login is used to get acess token to carry out the checkout and the create order is used to initate the payment.	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	Activates and/or carries out payment. This request must be given when the goods are shipped.	Aktiviert und/oder führt die Zahlung durch. Diese Aufforderung muss beim Versand der Ware erfolgen.

Initializing Zinia payments

In order to initialize a Zinia payment via server-to-server communication, please use the following 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	ns..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	String	M	Enum: BNPL, INSTALMENTS.	Enum: BNPL, INSTALMENTS.
pmtChannel	String	M	Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER and CLICKANDCOLLECT	Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER and 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=male, F=female, U=unknown
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 Kunde Typ ist ein Unternehmen) (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	String	O	Legal document type ENUM: NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER and PASSPORT	Rechtsdokumenttyp ENUM: NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER and 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
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 bei erfolgreicher Zahlung das Paygate aufruft. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Werte zwischen Paygate und Shop auszutauschen, verwenden Sie bitte den Parameter UserData. Allgemeine Hinweise: Wir empfehlen den Parameter „response=encrypt“ zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten Betrüger können jedoch einfach das verschlüsselte DATA-Element kopieren, das an URLFailure gesendet wird, und die DATA an URLSuccess senden. Überprüfen Sie daher unbedingt den „Code“-Wert, der den Erfolg/Misserfolg der Aktion anzeigt. Nur ein Ergebnis von „code=00000000“ sollte als erfolgreich gewertet werden.
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 Paygate aufruft, wenn die Zahlung nicht erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Werte zwischen Paygate und Shop auszutauschen, verwenden Sie bitte den Parameter UserData. Allgemeine Hinweise: Wir empfehlen den Parameter „response=encrypt“ zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten Betrüger können jedoch einfach das verschlüsselte DATA-Element kopieren, das an URLFailure gesendet wird, und die DATEN an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den „Code“-Wert, der den Erfolg/Misserfolg der Aktion anzeigt. Nur ein Ergebnis von „code=00000000“ sollte als erfolgreich gewertet werden.
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: 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 Paygate aufruft, um den Shop über das Zahlungsergebnis zu informieren. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Verwenden Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen den Parameter „response=encrypt“ zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten Betrüger können jedoch einfach das verschlüsselte DATA-Element kopieren, das an URLFailure gesendet wird, und die DATEN an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den „Code“-Wert, der den Erfolg/Misserfolg der Aktion anzeigt. Nur ein Ergebnis von „code=00000000“ sollte als erfolgreich gewertet werden.

ArticleList

The Article information is defined here. Please note that ArticleList should be Base64encoded as described in the example below.

Key	Format	CND	Description
ArticleList.name	ans..64	M	Article Name
ArticleList.description	ans..64	M	Article description
ArticleList.id	ans..128	M	Article ID
ArticleList.imageUrl	n..8	O	Image URL of the Article
ArticleList.amount	ans..16	M	Gross price per article Please note, that values has to be specified with “.” as decimal separator.
ArticleList.quantity	ans..16	M	Net price per article Please note, that values has to be specified with “.” as decimal separator.
ArticleList.totalAmount	n..2	M	VAT in percent
ArticleList.vatPercent	ans..16	O	VAT as amount per item Please note, that values has to be specified with “.” as decimal separator.
ArticleList.vatAmount	ans..256	O	URL for order image. This image can be viewed on the invoice or next to the instal-ment payment in the Riverty portal. Limited to 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.

Example of ArticleList as 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

The following table describes the result parameters with which the Computop Paygate responds to your system

pls. be prepared to receive additional parameters at any time and do not check the order of parameters

the key (e.g. MerchantId, RefNr) should not be checked case-sentive

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	n8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

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

Capture a Zinia payment transaction (full / partial capture)

In order to capture a payment transaction with Zinia, please use the following URL:

https://www.computop-paygate.com/capture.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
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

The following table describes the result parameters with which the Computop Paygate responds to your system

pls. be prepared to receive additional parameters at any time and do not check the order of parameters

the key (e.g. MerchantId, RefNr) should not be checked case-sentive

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	n8	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

Cancellation / return of Zinia payments

In order to cancel a Zinia payment partial or in full or the make changes on a payment, please use the following URL:

https://www.computop-paygate.com/reverse.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
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.

The following table describes the result parameters with which the Computop Paygate responds to your system

pls. be prepared to receive additional parameters at any time and do not check the order of parameters

the key (e.g. MerchantId, RefNr) should not be checked case-sentive

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	n8	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

Crediting Zinia payments

In order to credit a payment transaction with Zinia, please use the following URL:

https://www.computop-paygate.com/Credit.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
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.

The following table describes the result parameters with which the Computop Paygate responds to your system

pls. be prepared to receive additional parameters at any time and do not check the order of parameters

the key (e.g. MerchantId, RefNr) should not be checked case-sentive

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	n8	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

Space shortcuts

Page tree

About Zinia

General information about Zinia

Process flow chart

Paygate interface

Definitions

Data formats

Abbreviations

Zinia

Initializing Zinia payments

ArticleList

Example of ArticleList as JSON string

Capture a Zinia payment transaction (full / partial capture)

Cancellation / return of Zinia payments

Crediting Zinia payments

Paygate

Computop

Help

Intranet Tools