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

TypePayments by Invoice and Installments


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


Process flow chart


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.

The table is being loaded. Please wait for a bit ...

Computop request

Zinia request

Description

Beschreibung

AuthorizeMerchant_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.

CaptureCapture

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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

PayTypeString MEnum: BNPL, INSTALMENTS.Enum: BNPL, INSTALMENTS.
pmtChannelStringM

Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER

and CLICKANDCOLLECT

Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER

and CLICKANDCOLLECT

OrderDescans..768ODescription of the goods purchasedBeschreibung der gekauften Waren
E-mailans..255MeMail address of the card holderE-Mail-Adresse des Karteninhabers
CustomerIDan..30OUnique customer ID in merchant system or the customer’s email addressEindeutige ID des Kunden im Händlersystem oder die E-Mail-Adresse des Kunden
Titleans..45OTitleTitel
Salutationans..45OSalutationAnrede
Gendera1MGender: Sex (M=male / F=female / U=unknown)Geschlecht: M=male, F=female, U=unknown
DateOfBirthdttm8C

Date of birth in the format YYYYMMDD.


Geburtsdatum im Format JJJJMMTT.


PhoneAreaCodeans..30CTelephone code. Mandatory if MobileAreaCode is not transmitted.Telefonvorwahl. Pflicht, wenn kein MobileAreaCode übergeben ist.
Phoneans..30CPhone number. Mandatory if Mobile is not transmitted.Rufnummer. Pflicht, wenn kein Mobile übergeben ist.
FaxAreaCodeans..30OFax area codeFax-Vorwahl
Faxans..30OFax numberFaxnummer
MobileAreaCodeans..30CMobile area code. Mandatory if PhoneAreaCode is not transmitted.Mobil-Vorwahl. Pflicht, wenn kein PhoneAreaCode übergeben ist.
Mobileans..30CMobile telephone number. Mandatory if Phone is not transmitted.Mobiltelefonnummer. Pflicht, wenn kein Phone übergeben ist.
ShopSystem

ans..127

OName of the shop systemName des Shop-Systems
ShopSystemVersion

ans..127

OVersion name of the shop systemVersionsname des Shop-Systems



Customer dataKundendaten
CompanyName

ans..100

CCompany nameFirmenname
CompanyIDans..100C

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
CustomerTypeStringOPERSON or COMPANYPERSON oder COMPANY
docNumberStringOLegal document numberNummer des Rechtsdokuments
docTypeStringOLegal document type
ENUM: 

NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER and 

PASSPORT

Rechtsdokumenttyp
ENUM: 

NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER and 

PASSPORT





Delivery dataLieferdaten
sdSalutationans..45OSalutationAnrede
sdCompanyans..100OCompany nameFirmenname
sdFirstName

ans..100

M

First name of the customerVorname des Kunden
sdLastName

ans..100

M

Last name of the customerNachname des Kunden
sdStreet

ans..100

O

Street name and house numberStraßenname und Hausnummer
sdStreetHouseNumber

ans..10

O

Street numberHausnummer
sdStreetAddition

ans..50

O

Addition in the delivery addressZusatz in der Lieferadresse
sdZIPCode

ans..10

O

PostcodePostleitzahl
sdCity

ans..255

O

CityOrt
sdCountryCode

a2

O

Two characters country code according to ISO 3166Ländercode zweistellig gemäß ISO 3166
sdPhone

ns..32

O

Customer’s phone numberTelefonnummer des Kunden



Invoice dataRechnungsdaten
bdSalutationans..45OSalutationAnrede
bdCompanyans..100OCompany nameFirmenname
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 nameVorname
LastName

ans..100

M

Last nameNachname
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.

(info) 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.

(info) 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.

(info) 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.nameans..64MArticle Name

ArticleList.description

ans..64

MArticle 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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre 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

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Zinia, if agreed with Computop Helpdesk

Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment to be captured

Vom Paygate vergebene ID für die zu buchende Zahlung

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
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

InvoiceIDans..50OInvoice numberRechnungsnummer
InvoiceUrlans..256OInvoice URLRechnungsURL


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Zinia, if agreed with Computop Helpdesk

Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Zinia, if agreed with Computop Helpdesk

Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

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:


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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

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.

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment to be credited

Vom Paygate vergebene ID für die gutzuschreibende Zahlung

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
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.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
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.

KeyFormatCNDDescriptionBeschreibung
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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
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!

KeyFormatCNDDescriptionBeschreibung
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)
ExternalMessageans..256O

Error text from Zinia, if agreed with Computop Helpdesk

Fehlertext von Zinia, wenn mit Computop Helpdesk abgesprochen

ExternalCodeans..64O

Error code from Zinia, if agreed with Computop Helpdesk

Fehlercode von Zinia, wenn mit Computop Helpdesk abgesprochen