Zinia

Logo

Info

Zinia bietet die Option „Jetzt kaufen, später bezahlen“ für Einkäufe an

Typ

Zahlungen per Rechnungs- und Ratenkauf

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

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.

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

PayType

enum

M

Enum: BNPL, INSTALMENTS

pmtChannel

enum

M

Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER and CLICKANDCOLLECT

OrderDesc

ans..768

O

Beschreibung der gekauften Waren

E-mail

ans..255

M

E-Mail-Adresse des Karteninhabers

CustomerID

an..30

O

Eindeutige ID des Kunden im Händlersystem oder die E-Mail-Adresse des Kunden

Title

ans..45

O

Titel

Salutation

ans..45

O

Anrede

Gender

a1

M

Geschlecht: M=männlich, F=weiblich, U=unbekannt

DateOfBirth

dttm8

C

Geburtsdatum im Format JJJJMMTT

PhoneAreaCode

ans..30

C

Telefonvorwahl. Pflicht, wenn kein MobileAreaCode übergeben ist.

Phone

ans..30

C

Rufnummer. Pflicht, wenn kein Mobile übergeben ist.

FaxAreaCode

ans..30

O

Fax-Vorwahl

Fax

ans..30

O

Faxnummer

MobileAreaCode

ans..30

C

Mobil-Vorwahl. Pflicht, wenn kein PhoneAreaCode übergeben ist.

Mobile

ans..30

C

Mobiltelefonnummer. Pflicht, wenn kein Phone übergeben ist.

ShopSystem

ans..127

O

Name des Shop-Systems

ShopSystemVersion

ans..127

O

Versionsname des Shop-Systems

Kundendaten

CompanyName

ans..100

C

Firmenname

CompanyID

ans..100

C

Registrierungs-ID der Organisation (für den Fall, dass der Kundentyp ein Unternehmen ist) (Nur für B2B-Kunden)

Beispiel: 123423-CO

CustomerType

string

O

PERSON oder COMPANY

docNumber

string

O

Nummer des Rechtsdokuments

docType

enum

O

Rechtsdokumenttyp

ENUM: NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER und PASSPORT

Lieferdaten

sdSalutation

ans..45

O

Anrede

sdCompany

ans..100

O

Firmenname

sdFirstName

ans..100

M

Vorname des Kunden

sdLastName

ans..100

M

Nachname des Kunden

sdStreet

ans..100

O

Straßenname und Hausnummer

sdStreetHouseNumber

ans..10

O

Hausnummer

sdStreetAddition

ans..50

O

Zusatz in der Lieferadresse

sdZIPCode

ans..10

O

Postleitzahl

sdCity

ans..255

O

Ort

sdCountryCode

a2

O

Ländercode zweistellig gemäß ISO 3166

sdPhone

ns..32

O

Telefonnummer des Kunden

Rechnungsdaten

bdSalutation

ans..45

O

Anrede

bdCompany

ans..100

O

Firmenname

bdFirstName

ans..100

M

Vorname des Kunden

bdLastName

ans..100

M

Nachname des Kunden

bdCompanyName

ans..100

O

Firmenname

bdStreet

ans..50

M

Straßenname der Rechnungsadresse

bdStreetNr

ans..10

M

Hausnummer der Rechnungsadresse

bdStreetAddition

ans..50

O

Adresszusatz der Rechnungsadresse

bdZIP

ans..10

M

Postleitzahl der Rechnungsadresse

bdCity

ans..255

M

Ort der Rechnungsadresse

bdCountryCode

a2

M

Ländercode der Rechnungsadresse zweistellig gemäß ISO 3166

bdPhone

ns..32

M

Telefonnummer des Kunden

Registrierungsadresse (B2B)

FirstName

ans..100

M

Vorname

LastName

ans..100

M

Nachname

URLSuccess

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

• Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

• Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

URLFailure

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

• Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

• Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

URLNotify

ans..256

M

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

• Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.

• Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key

Format

CND

Beschreibung

ArticleList.name

ans..64

M

Artikelname

ArticleList.description

ans..64

M

Artikelbeschreibung

ArticleList.id

ans..128

M

Artikel-ID

ArticleList.imageUrl

n..8

O

Bild-URL des Artikels

ArticleList.amount

ans..16

M

Bruttopreis pro Artikel.

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen.

ArticleList.quantity

ans..16

M

Nettopreis pro Artikel.

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen.

ArticleList.totalAmount

n..2

M

Mehrwertsteuer in Prozent

ArticleList.vatPercent

ans..16

O

Mehrwertsteuer. als Betrag pro Artikel. 

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen.

ArticleList.vatAmount

ans..256

O

URL für Bestellbild.Dieses Bild ist auf der Rechnung oder neben der Ratenzahlung im Riverty-Portal zu sehen.Begrenzt auf 100-1280px.

ArticleList.discount

ans..16

O

Rabattbetrag (nur für statistische Zwecke).

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen.

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Status

a..50

M

INIT oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

InfoText

ans..1024

O

Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)

ExternalMessage

ans..256

O

Fehlertext von Zinia, wenn mit Computop Helpdeskabgesprochen

ExternalCode

ans..64

O

Fehlercode von Zinia, wenn mitComputop Helpdesk abgesprochen

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

InvoiceID

ans..50

O

Rechnungsnummer

InvoiceUrl

ans..256

O

RechnungsURL

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

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

InfoText

ans..1024

O

Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)

ExternalMessage

ans..256

O

Fehlertext von Zinia, wenn mit Computop Helpdeskabgesprochen

ExternalCode

ans..64

O

Fehlercode von Zinia, wenn mitComputop Helpdesk abgesprochen

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

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

InfoText

ans..1024

O

Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)

ExternalMessage

ans..256

O

Fehlertext von Zinia, wenn mit Computop Helpdeskabgesprochen

ExternalCode

ans..64

O

Fehlercode von Zinia, wenn mitComputop Helpdesk abgesprochen

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Status

a..50

M

OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

M

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

InfoText

ans..1024

O

Enthält einen Info-Text, der dem Kunden weitergegeben werden kann (z.B. bei Ablehnung)

ExternalMessage

ans..256

O

Fehlertext von Zinia, wenn mit Computop Helpdeskabgesprochen

ExternalCode

ans..64

O

Fehlercode von Zinia, wenn mitComputop Helpdesk abgesprochen