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

Type

Payments by Invoice and Installments

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

Process flow chart

Zinia process flow

interface

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.

Zinia has 2 different requests which must be carried out in the payment process depending on the situation and progress. converts these requests into the corresponding Zinia requests. In this case the following mapping applies:

request	Zinia request	Description	Beschreibung
Authorize	Merchant_login Create_order	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.	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	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:

Zinia.aspx

Key	Format	CND	Description	Beschreibung
PayType	String	M	Enum: BNPL, INSTALMENTS.	Enum: BNPL, INSTALMENTS.
pmtChannel	String	M	Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER and CLICKANDCOLLECT	Enum: ECOMMERCE , POS , POS_HOME_DELIVERY , CALL_CENTER and CLICKANDCOLLECT
OrderDesc	ans..768	O	Description of the goods purchased	Beschreibung der gekauften Waren
E-mail	ans..255	M	eMail address of the card holder	E-Mail-Adresse des Karteninhabers
CustomerID	an..30	O	Unique customer ID in merchant system or the customer’s email address	Eindeutige ID des Kunden im Händlersystem oder die E-Mail-Adresse des Kunden
Title	ans..45	O	Title	Titel
Salutation	ans..45	O	Salutation	Anrede
Gender	a1	M	Gender: Sex (M=male / F=female / U=unknown)	Geschlecht: M=male, F=female, U=unknown
DateOfBirth	dttm8	C	Date of birth in the format YYYYMMDD.	Geburtsdatum im Format JJJJMMTT.
PhoneAreaCode	ans..30	C	Telephone code. Mandatory if MobileAreaCode is not transmitted.	Telefonvorwahl. Pflicht, wenn kein MobileAreaCode übergeben ist.
Phone	ans..30	C	Phone number. Mandatory if Mobile is not transmitted.	Rufnummer. Pflicht, wenn kein Mobile übergeben ist.
FaxAreaCode	ans..30	O	Fax area code	Fax-Vorwahl
Fax	ans..30	O	Fax number	Faxnummer
MobileAreaCode	ans..30	C	Mobile area code. Mandatory if PhoneAreaCode is not transmitted.	Mobil-Vorwahl. Pflicht, wenn kein PhoneAreaCode übergeben ist.
Mobile	ans..30	C	Mobile telephone number. Mandatory if Phone is not transmitted.	Mobiltelefonnummer. Pflicht, wenn kein Phone übergeben ist.
ShopSystem	ans..127	O	Name of the shop system	Name des Shop-Systems
ShopSystemVersion	ans..127	O	Version name of the shop system	Versionsname des Shop-Systems
			Customer data	Kundendaten
CompanyName	ans..100	C	Company name	Firmenname
CompanyID	ans..100	C	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
CustomerType	String	O	PERSON or COMPANY	PERSON oder COMPANY
docNumber	String	O	Legal document number	Nummer des Rechtsdokuments
docType	String	O	Legal document type ENUM: NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER and PASSPORT	Rechtsdokumenttyp ENUM: NATIONAL_ID , SSN , FOREIGN_NATIONAL_NUMBER and PASSPORT
			Delivery data	Lieferdaten
sdSalutation	ans..45	O	Salutation	Anrede
sdCompany	ans..100	O	Company name	Firmenname
sdFirstName	ans..100	M	First name of the customer	Vorname des Kunden
sdLastName	ans..100	M	Last name of the customer	Nachname des Kunden
sdStreet	ans..100	O	Street name and house number	Straßenname und Hausnummer
sdStreetHouseNumber	ans..10	O	Street number	Hausnummer
sdStreetAddition	ans..50	O	Addition in the delivery address	Zusatz in der Lieferadresse
sdZIPCode	ans..10	O	Postcode	Postleitzahl
sdCity	ans..255	O	City	Ort
sdCountryCode	a2	O	Two characters country code according to ISO 3166	Ländercode zweistellig gemäß ISO 3166
sdPhone	ns..32	O	Customer’s phone number	Telefonnummer des Kunden
			Invoice data	Rechnungsdaten
bdSalutation	ans..45	O	Salutation	Anrede
bdCompany	ans..100	O	Company name	Firmenname
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 name	Vorname
LastName	ans..100	M	Last name	Nachname
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. 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. 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. 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.name	ans..64	M	Article Name
ArticleList.description	ans..64	M	Article 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

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

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)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with	Fehlertext von Zinia, wenn mit abgesprochen
ExternalCode	ans..64	O	Error code from Zinia, if agreed with	Fehlercode von Zinia, wenn mit abgesprochen

Capture a Zinia payment transaction (full / partial capture)

In order to capture a payment transaction with Zinia, please use the following URL:

capture.aspx

Key	Format	CND	Description	Beschreibung
InvoiceID	ans..50	O	Invoice number	Rechnungsnummer
InvoiceUrl	ans..256	O	Invoice URL	RechnungsURL

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)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with	Fehlertext von Zinia, wenn mit abgesprochen
ExternalCode	ans..64	O	Error code from Zinia, if agreed with	Fehlercode von Zinia, wenn mit 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:

reverse.aspx

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)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with	Fehlertext von Zinia, wenn mit abgesprochen
ExternalCode	ans..64	O	Error code from Zinia, if agreed with	Fehlercode von Zinia, wenn mit abgesprochen

Crediting Zinia payments

In order to credit a payment transaction with Zinia, please use the following URL:

Credit.aspx

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)
ExternalMessage	ans..256	O	Error text from Zinia, if agreed with	Fehlertext von Zinia, wenn mit abgesprochen
ExternalCode	ans..64	O	Error code from Zinia, if agreed with	Fehlercode von Zinia, wenn mit abgesprochen