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

Logo

Info

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

Typ

Zahlungen per Rechnungs- und Ratenkauf

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

Diagramm zum Prozessablauf

Zinia Prozessablauf

-Schnittstelle

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.

Zinia kennt 2 unterschiedliche Anfragen, die je nach Situation und Fortschritt im Zahlungsprozess ausgeführt werden müssen. andelt diese Anfragen in die entsprechenden Zinia-Anfragen um. Dabei gilt folgendes Mapping:

-Anfrage	Zinia-Anfrage	Beschreibung
Authorize	Merchant_login Create_order	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.

Initialisierung von Zinia-Zahlungen

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

Zinia.aspx

Key	Format	CND	Beschreibung
PayType	enum	M	Enum: BNPL, INSTALMENTS
pmtChannel	enum	M	Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER und 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	enum	M	PERSON oder COMPANY
docNumber	ans..100	M	Nummer des Rechtsdokuments
docType	enum	M	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	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
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	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

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.name	ans..64	M	Artikelname
ArticleList.description	ans..64	M	Artikelbeschreibung
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

Key	Format	CND	Beschreibung
Status	a..50	M	INIT oder FAILED

Key	Format	CND	Beschreibung
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 abgesprochen
ExternalCode	ans..64	O	Fehlercode von Zinia, wenn mit 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:

capture.aspx

Key	Format	CND	Beschreibung
InvoiceID	ans..50	O	Rechnungsnummer
InvoiceUrl	ans..256	O	RechnungsURL

Parameter für Buchungen von Zinia-Zahlungen

Key	Format	CND	Beschreibung
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 abgesprochen
ExternalCode	ans..64	O	Fehlercode von Zinia, wenn mit abgesprochen

Antwort-Parameter für Buchungen von Zinia-Zahlungen

Gutschrift von Zinia-Zahlungen

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

credit.aspx

Parameter für Gutschriften von Zinia-Zahlungen

Key	Format	CND	Beschreibung
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 abgesprochen
ExternalCode	ans..64	O	Fehlercode von Zinia, wenn mit 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:

reverse.aspx

Parameter für Storno von Zinia-Zahlungen

Key	Format	CND	Beschreibung
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 abgesprochen
ExternalCode	ans..64	O	Fehlercode von Zinia, wenn mit 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”