Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEWORK and version Dokumentation
Table of Contents


Über Zinia

Allgemeine Informationen über Zinia

Zinia ist eine „Buy Now Pay Later“-Lösung der Santander Bank.Mit Zinia können Kunden in ihrem eigenen Tempo bezahlen.Genießen Sie beim Einkaufen mit Zinia völlige Freiheit.Außerdem keine Zinsen oder versteckten Kosten!Klingt gut, oder?Nur 2 einfache Schritte für die Zahlung an der Kasse

1. Der Kunde wählt Zinia als Zahlungsoption.

  • In 30 Tagen bezahlen: Der Kunde hat bis zu 30 Tage nach dem Versand Zeit, per Banküberweisung zu bezahlen.
  • In bis zu 36 Raten bezahlen: Wählen Sie an der Kasse die Finanzierungslaufzeit aus, die für den Kunden am besten geeignet ist.Die Raten werden alle 30 Tage nach dem Versand fällig.

2. Geben Sie die Handynummer und das Geburtsdatum des Kunden ein.

Die Zahlung mit Zinia im Online-Shop motiviert Kunden, hochwertige Warenkörbe zu bestellen.Dies erhöht auch den Umsatz


Page properties
Logo

Info
Excerpt
Zinia bietet die Option „Jetzt kaufen, später bezahlen“ für Einkäufe an
TypZahlungen per Rechnungs- und Ratenkauf

Weitere Informationen finden Sie auf der Webseite von Zinia (https://www.zinia.com).

Diagramm zum Prozessablauf

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameZinia_ProcessFlow
DisableCachingtrue
PageWithExcerptEN:Zinia

Zinia Prozessablauf


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording (veraltet)
-Schnittstelle

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameDefinition
PageWithExcerptDefinition DE


Zinia

Eine Zahlung mit Zinia besteht aus zwei Transaktionsschritten.Zu Beginn ist eine Initialisierung notwendig, die die Weiterleitungs-URL zurückgibt, zu der der Kunde weitergeleitet werden muss.Nach der Weiterleitung kann der Kunde die von Zinia angebotene Zahlungsmethode auswählen, um den Checkout abzuschließen.

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording (veraltet)
Zinia kennt 2 unterschiedliche Anfragen, die je nach Situation und Fortschritt im Zahlungsprozess ausgeführt werden müssen
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording (veraltet)
andelt diese Anfragen in die entsprechenden Zinia-Anfragen um.Dabei gilt folgendes Mapping:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording (veraltet)
-Anfrage

Zinia-Anfrage

Beschreibung

AuthorizeMerchant_login
Create_order

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording (veraltet)
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.

CaptureCaptureAktiviert und/oder führt die Zahlung durch.Diese Aufforderung muss beim Versand der Ware erfolgen.



Initialisierung von Zinia-Zahlungen

Um eine Zinia-Zahlung über eine Server-zu-Server-Kommunikationzu initialisieren, verwenden Sie bitte folgende URL:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
Zinia.aspx


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptEN:Reuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1771513804926_1356492613
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameRefNr
pagerefnr
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameAmount
pageAmount
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCurrency
pageCurrency
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Key

Format

CND

Beschreibung

PayTypeenumMEnum: BNPL, INSTALMENTS
pmtChannelenumM

Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER und CLICKANDCOLLECT

OrderDescans..768OBeschreibung der gekauften Waren
E-mailans..255ME-Mail-Adresse des Karteninhabers
CustomerIDan..30OEindeutige ID des Kunden im Händlersystem oder die E-Mail-Adresse des Kunden
Titleans..45OTitel
Salutationans..45OAnrede
Gendera1MGeschlecht: M=männlich, F=weiblich, U=unbekannt
DateOfBirthdttm8C

Geburtsdatum im Format JJJJMMTT

PhoneAreaCodeans..30CTelefonvorwahl. Pflicht, wenn kein MobileAreaCode übergeben ist.
Phoneans..30CRufnummer. Pflicht, wenn kein Mobile übergeben ist.
FaxAreaCodeans..30OFax-Vorwahl
Faxans..30OFaxnummer
MobileAreaCodeans..30CMobil-Vorwahl. Pflicht, wenn kein PhoneAreaCode übergeben ist.
Mobileans..30CMobiltelefonnummer. Pflicht, wenn kein Phone übergeben ist.
ShopSystem

ans..127

OName des Shop-Systems
ShopSystemVersion

ans..127

OVersionsname des Shop-Systems



Kundendaten
CompanyName

ans..100

CFirmenname
CompanyIDans..100C

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

Beispiel: 123423-CO

CustomerTypeenumMPERSON oder COMPANY
docNumberans..100MNummer des Rechtsdokuments
docTypeenumM

Rechtsdokumenttyp

ENUM: NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER und PASSPORT




Lieferdaten
sdSalutationans..45OAnrede
sdCompanyans..100OFirmenname
sdFirstName

ans..100

M

Vorname des Kunden
sdLastName

ans..100

M

Nachname des Kunden
sdStreet

ans..100

M

Straßenname
sdStreetNr

an..10

M

Hausnummer
sdStreetAddition

ans..50

O

Zusatz in der Lieferadresse
sdZIP

ans..10

M

Postleitzahl
sdCity

ans..255

M

Ort
sdCountryCode

a2

M

Ländercode zweistellig gemäß ISO 3166
sdPhone

ns..32

O

Telefonnummer des Kunden



Rechnungsdaten
bdSalutationans..45OAnrede
bdCompanyans..100OFirmenname
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

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

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLSuccess
pageURLSuccess
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLFailure
pageURLFailure
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLNotify
pageURLNotify
typepage

Parameter für die Initialisierung von Zinia-Zahlungen

ArticleList

Hier werden die Artikelinformationen definiert.Bitte beachten Sie, dass die ArticleList Base64-kodiert sein sollte, wie im folgenden Beispiel beschrieben.

Key

Format

CND

Beschreibung

ArticleList.nameans..64MArtikelname

ArticleList.description

ans..64

MArtikelbeschreibung
ArticleList.id

n..8

M

Artikel-ID

ArticleList.imageUrl

ans..64

O

Bild-URL des Artikels

ArticleList.amount

ans..16

M

Nettopreis pro Artikel.

Bitte beachten Sie, dass Werte mit „.“ als Dezimaltrennzeichen angegeben werden müssen. Dieser Wert muss mit dem Wert im Parameter „Amount“ übereinstimmen.

ArticleList.currency

ans..16

M

Währung, in der der Artikel verkauft wird

ArticleList.quantity

ans..16

M

Anzahl der Artikel

ArticleList.totalAmount

ans..16

M

Bruttopreis pro Artikel.

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

ArticleList.vatPercent

ans..16

M

Mehrwehrtsteuer in Prozent

ArticleList.vatAmount

ans..256

M

Mehrwertsteuer als Betrag pro Artikel.

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

ArticleList.discount

ans..16

M

Rabattbetrag (nur für statistische Zwecke).

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


Beispiel von ArticleList als JSON-String

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameZinia_ArticleList_example
DisableCachingtrue
PageWithExcerptEN:Zinia


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1771513843033_105508673
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Key

Format

CND

Beschreibung

Status

a..50

M

INIT oder FAILED

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameRefNr
pagerefnr
typepage

Key

Format

CND

Beschreibung

InfoText

ans..1024

O

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

Fehlertext von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording (veraltet)
abgesprochen

ExternalCodeans..64O

Fehlercode von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording (veraltet)
abgesprochen

Antwort-Parameter für die Initialisierung von Zinia-Zahlungen


Buchung einer Zinia-Zahlungstransaktion (Voll- / Teilbuchung)

Um eine Zahlungstransaktion mit Zinia zu buchen, verwenden Sie bitte folgende URL:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
capture.aspx

 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1771513858843_1875337325
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID_Capture
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameAmount
pageAmount
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCurrency
pageCurrency
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameReqId-ans..32
pageReqId
typepage

Key

Format

CND

Beschreibung

InvoiceIDans..50ORechnungsnummer
InvoiceUrlans..256ORechnungsURL

Parameter für Buchungen von Zinia-Zahlungen


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1771513874234_-706951651
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Key

Format

CND

Beschreibung

InfoText

ans..1024

O

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

Fehlertext von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording (veraltet)
abgesprochen

ExternalCodeans..64O

Fehlercode von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording (veraltet)
abgesprochen

Antwort-Parameter für Buchungen von Zinia-Zahlungen


Gutschrift von Zinia-Zahlungen

Um eine Zahlungstransaktion mit Zinia gutzuschreiben, verwenden Sie bitte folgende URL:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
credit.aspx


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1771513890954_394897658
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID_Credit
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameAmount
pageAmount
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCurrency
pageCurrency
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameReqId-ans..32
pageReqId
typepage

Parameter für Gutschriften von Zinia-Zahlungen


 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1771513902816_-528519112
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Key

Format

CND

Beschreibung

InfoText

ans..1024

O

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

Fehlertext von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording (veraltet)
abgesprochen

ExternalCodeans..64O

Fehlercode von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording (veraltet)
abgesprochen

Antwort-Parameter für Gutschriften von Zinia-Zahlungen


Storno / Rückgabe von Zinia-Zahlungen

Um eine Zinia-Zahlung teilweise oder vollständig zu stornierenoder Änderungen an einer Zahlung vorzunehmen, verwenden Sie bitte folgende URL:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
reverse.aspx


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1771513922732_-25005679
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameAmount
pageAmount
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCurrency
pageCurrency
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameReqId-ans..32
pageReqId
typepage

Parameter für Storno von Zinia-Zahlungen


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1771513940426_1719487257
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Key

Format

CND

Beschreibung

InfoText

ans..1024

O

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

Fehlertext von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording (veraltet)
abgesprochen

ExternalCodeans..64O

Fehlercode von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording (veraltet)
abgesprochen

Antwort-Parameter für Storno von Zinia-Zahlungen


Einschränkungen für die Zinia Sandbox

Bei Verwendung der Zinia Sandbox gelten die folgenden Einschränkungen:

  • Der Amount kann nicht kleiner als 50€ sein
  • Der Nachname muss "ZINIA_AP" sein
  • Das OTP (Einmalpasswort) ist stets “9999”