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
-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
Zinia kennt 2 unterschiedliche Anfragen, die je nach Situation und Fortschritt im Zahlungsprozess ausgeführt werden müssen
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording
andelt diese Anfragen in die entsprechenden Zinia-Anfragen um.Dabei gilt folgendes Mapping:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording
-Anfrage

Zinia-Anfrage

Beschreibung

AuthorizeMerchant_login
Create_order

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording
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
Zinia.aspx


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptEN:Reuse API

table-filterjoiner
inversedateFormatfalse
defaultDescription
dd M yy
export-wordfalse
show-sourceisFirstTimeEnterfalse
hideColumnsexport-csvtruefalse
sparkNameidSparkline1771513804926_1356492613
hidePanetransposetrue
datepatterndd M yy
id1712814858800_1320280316
false
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
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
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamezinia_initialise_request
DisableCachingtrue
PageWithExcerptEN:Zinia

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.

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1736435734640_-1812999658
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

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.

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamezinia_ArticleListDisableCachingtruePageWithExcerptEN:Zinia


Beispiel von ArticleList als JSON-String

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameZinia_ArticleList_example
DisableCachingtrue
PageWithExcerptEN:Zinia


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

table-filterjoiner
0
inversedateFormatfalse
defaultDescription
dd M yy
export-wordfalse
show-sourceisFirstTimeEnterfalse
hideColumnsexport-csvtruefalse
sparkNameidSparkline1771513843033_105508673
hidePanetransposetrue
datepatterndd M yy
id1712815127643_506546217
false
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order
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
SpaceWithExcerpt

EN

DE
MultiExcerptName

Zinia_initialise_response

Helpdesk-Name
PageWithExcerptWording
abgesprochen

ExternalCodeans..64O

Fehlercode von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording
abgesprochen

DisableCachingtruePageWithExcerptEN:Zinia

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
capture.aspx

 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

EN:Zinia
table-filterjoiner
inversedateFormatfalse
defaultDescription
dd M yy
export-wordfalse
show-sourceisFirstTimeEnterfalse
hideColumnsexport-csvtruefalse
sparkNameidSparkline1771513858843_1875337325
hidePanetrue
datepatterndd M yy
id1712815693250_1267075173
transposefalse
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
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
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameZinia_capture_request
DisableCachingtrue
PageWithExcerpt

Parameter für Buchungen von Zinia-Zahlungen


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

table-filterjoiner
0
inversedateFormatfalse
defaultDescription
dd M yy
export-wordfalse
show-sourceisFirstTimeEnterfalse
hideColumnsexport-csvtruefalse
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1771513874234_-706951651
transposefalseid1712815807089_1101062365
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order
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
SpaceWithExcerpt

EN

DE
MultiExcerptName

Zinia_capture_response

Helpdesk-Name
PageWithExcerptWording
abgesprochen

ExternalCodeans..64O

Fehlercode von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording
abgesprochen

DisableCachingtruePageWithExcerptEN:Zinia

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
credit.aspx


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

table-filterjoiner
inversedateFormatfalse
defaultDescription
dd M yy
export-wordfalse
show-sourceisFirstTimeEnterfalse
hideColumnsexport-csvtruefalse
sparkNameidSparkline1771513890954_394897658
hidePanetrue
datepatterndd M yy
transposefalseid1712816024055_-788662889
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
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
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameZinia_credit_request
DisableCachingtrue
PageWithExcerptEN:Zinia

Parameter für Gutschriften von Zinia-Zahlungen


 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

table-filterjoiner
0
inversedateFormatfalse
defaultDescription
dd M yy
export-wordfalse
show-sourceisFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
export-csvfalse
id1771513902816_-528519112
transposefalseid1712816060864_-627124839
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order
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
SpaceWithExcerpt

EN

DE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording

Zinia_credit_response

abgesprochen

ExternalCodeans..64O

Fehlercode von Zinia, wenn mit

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording
abgesprochen

DisableCachingtruePageWithExcerptEN:Zinia

Antwort-Parameter für Gutschriften von Zinia-Zahlungen