About Thunes

General information about Thunes

In France, customers can offer the local payment methods Cofidis, 1euro.com, Cetelem and Facilypay which specialize in instalment payments for credit card transactions. Online shoppers can pay for orders conveniently by credit card, however are not charged to the full amount in a one-off transaction but in fixed instalments over several months. Merchants receive the amount due immediately after the order has been actuated and so have high payment security. In addition to the instalment payment methods, offers Cheque-Vacances (eANCV) and its wallet version Cheque-Vacances Connect (cvconnect), a payment method which enables shoppers to shop online with vouchers. With the new payment methods which are extremely popular in France, merchants can achieve a increase in their turnover rates in French eCommerce.

Logo

Info

In France, customers can offer the local payment methods Cofidis, 1euro.com, Cetelem and Facilypay which specialize in instalment payments for credit card transactions. Online shoppers can pay for orders conveniently by credit card, however are not charged to the full amount in a one-off transaction but in fixed instalments over several months. Merchants receive the amount due immediately after the order has been actuated and so have high payment security.

Type

Mixed payment methods

Further information can be found on the webpage of Thunes (https://www.thunes.com/).

Process flow chart

Thunes process flow (pls. note: limonetik.aspx)

interface

Call of interface for Thunes

To make a payment with Thunes (Limonetik) over a form, please use the following URL:

limonetik.aspx

Key	Format	CND	Description	Beschreibung
TaxAmount	n..10	O	Tax amount of the entire order in the smallest currency unit (e.g. EUR Cent)	Steuerbetrag der gesamten Bestellung in der kleinsten Währungseinheit (z.B. EUR Cent)

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..128	O	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise etc.

Key	Format	CND	Description	Beschreibung
PayType	ans..21	M	Payment method that shall be used. Possible values: cofidis3xcb cofidis4xcb 1euro echequevacances facilypay-3x (FR & DE) facilypay-3xsansfrais facilypay-4x facilypay-4xsansfrais cvconnect cetelem3xcb cetelem4xcb upchequedejeuner apetiz passrestaurant sofinco2xcb sofinco2xcbsansfrais sofinco3xcb sofinco3xcbsansfrais sofinco4xcb sofinco4xcbsansfrais giftcardbanqueaccord	Zahlungsart, die verwendet werden soll. Mögliche Werte: cofidis3xcb cofidis4xcb 1euro echequevacances facilypay-3x (FR & DE) facilypay-3xsansfrais facilypay-4x facilypay-4xsansfrais cvconnect cetelem3xcb cetelem4xcb upchequedejeuner apetiz passrestaurant sofinco2xcb sofinco2xcbsansfrais sofinco3xcb sofinco3xcbsansfrais sofinco4xcb sofinco4xcbsansfrais giftcardbanqueaccord
			Invoicing address	Rechnungsadresse
CompanyName	ans..50	C	Company name, if shop delivery, StorePickup, Network-Pickup or TravelPickup is selected	Firmenname, wenn shop delivery, StorePickup, Network-Pickup oder TravelPickup gewählt wurde
CustomerID	ans..20	C	Customer number Mandatory with Facilypay and Sofinco	Kundennummer Pflicht bei Facilypay und Sofinco
CustomerClassification	a..12	C	Hint about customer type. Possible values: Professional, Individual Mandatory with Facilypay	Kundentyphinweis. Mögliche Werte: Professional, Individual Pflicht bei Facilypay
CustomerInformation	ans..100	C	Additional information about the customer. For Cetelem the merchant can submit several values separated by \| which are agreed between merchant and Cetelem. Example: CustomerInformation =CFID=true\|CNEW=false Mandatory with Facilypay, Cetelem	Zusätzliche Information zum Kunden. Bei Cetelem kann der Händler mehrere Werte getrennt durch \| übergeben, die zwischen Händler und Cetelem abgesprochen sind. Zum Beispiel: CustomerInformation =CFID=true\|CNEW=false Pflicht bei Facilypay, Cetelem
Salutation	ans..20	C	Salutation Mandatory with Facilypay, Cetelem and Cofidis	Anrede Pflicht bei Facilypay, Cetelem und Cofidis
FirstName	ans..50	C	First name Mandatory with Facilypay, Cetelem and Cofidis	Vorname Pflicht bei Facilypay, Cetelem und Cofidis
LastName	ans..50	C	Last name Mandatory with Facilypay, Cetelem and Cofidis	Nachname Pflicht bei Facilypay, Cetelem und Cofidis
Street	ans..80	C	Street name and street number Mandatory with Facilypay, Cetelem and Cofidis	Straße und Hausnummer Pflicht bei Facilypay, Cetelem und Cofidis
AddressAddition	ans..80	O	Address c/o	Adresszusatz
ZIPCode	ans..10	C	Postcode Mandatory with Facilypay, Cetelem and Cofidis	Postleitzahl Pflicht bei Facilypay, Cetelem und Cofidis
City	ans..100	C	City Mandatory with Facilypay, Cetelem and Cofidis	Ort Pflicht bei Facilypay, Cetelem und Cofidis
CountryCode	a2	C	Two characters country code according to ISO 3166-1 alpha-2 Available are FR and DE. Mandatory with Facilypay, Sofinco, cvconnect, Cetelem, upchequedejeuner and Cofidis	Ländercode zweistellig gemäß ISO 3166-1 alpha-2) Verfügbar sind FR und DE. Pflicht bei Facilypay, Sofinco, cvconnect, Cetelem, upchequedejeuner und Cofidis
Email	ans..100	C	E-mail address Mandatory with Facilypay, Cetelem, Cofidis, CVConnect and Cheque-Vacances (eANCV) with split payments,, giftcardbanqueaccord and Sofinco (all connected pay types), upchequedejeuner, apetiz, passrestaurant	E-Mail-Adresse Pflicht bei Facilypay, Cetelem, Cofidis, CVConnect und Cheque-Vacances (eANCV) mit Ratenzahlungen, Sofinco (alle verbundenen Zahlarten), giftcardbanqueaccord , upchequedejeuner, apetiz, passrestaurant
Phone	ns..50	OC	Phone number: is not mandatory for FacilyPay and Cetelem if parameter MobileNo is transmitted. e.g. +49123456789 Mandatory with Cofidis	Telefonnummer: muss bei FacilyPay und Cetelem nicht übergeben werden, wenn der Parameter MobileNo übergeben wird. z.B. +49123456789 Pflicht bei Cofidis
MobileNo	ns..50	OC	Mobile phone number: is not mandatory for FacilyPay and Cetelem if parameter Phone is transmitted. e.g. +49123456789 Mandatory with Cofidis	Handynummer: muss bei FacilyPay und Cetelem nicht übergeben werden, wenn der Parameter Phone übergeben wird. z.B. +49123456789 Pflicht bei Cofidis
Language	as5	O	Language for displaying the form. Possible de-DE or fr-FR. Default value: fr-FR	Sprache in der das Formular angezeigt werden soll. Möglich de-DE oder fr-FR. Standardwert: fr-FR
			Delivery address	Lieferadresse
sdCompanyName	ans..50	C	Company name in the delivery address Mandatory with Facilypay if ShippingData Type StorePickup, NetworkPickup, TravelPickup or Other is selected	Firmenname in der Lieferadresse Pflicht bei Facilypay, wenn ShippigData Type StorePickup, NetworkPickup, TravelPickup oder Other gewählt wurde
sdSalutation	ans..20	C	Salutation in the delivery address Mandatory with Facilypay, Cetelem and Sofinco	Anrede in der Lieferadresse Pflicht bei Facilypay, Cetelem und Sofinco
sdFirstName	ans..50	C	First name in the delivery address Mandatory with Facilypay, Cetelem and Sofinco	Vorname in der Lieferadresse Pflicht bei Facilypay, Cetelem und Sofinco
sdLastName	ans..50	C	Last name in the delivery address Mandatory with Facilypay, Cetelem and Sofinco	Nachname in der Lieferadresse Pflicht bei Facilypay, Cetelem und Sofinco
sdStreet	ans..80	C	Street name and street number in the delivery address Mandatory with Facilypay, Cetelem and Sofinco	Straßenname und Hausnummer in der Lieferadresse Pflicht bei Facilypay, Cetelem und Sofinco
sdAddressAddition	ans..80	O	Address addition in the delivery address	Adresszusatz in der Lieferadresse
sdZipCode	ans..10	C	Postcode in the delivery address Mandatory with Facilypay, Cetelem and Sofinco	Postleitzahl in der Lieferadresse Pflicht bei Facilypay, Cetelem und Sofinco
sdCity	ans..100	C	Town/city in the delivery address Mandatory with Facilypay, Cetelem and Sofinco	Ort in der Lieferadresse Pflicht bei Facilypay, Cetelem und Sofinco
sdCountryCode	a2	C	Country code for the delivery address, 2 characters according to ISO 3166-1. Mandatory with Facilypay, Cetelem and Sofinco	Ländercode der Lieferadresse zweistellig gemäß ISO-3166-1 Pflicht bei Facilypay, Cetelem und Sofinco
sdPhone	ans..50	OC	Phone number: is not mandatory for FacilyPay and Cetelem if parameter MobileNo is transmitted. e.g. +49123456789	Telefonnummer: muss bei FacilyPay und Cetelem nicht übergeben werden, wenn der Parameter MobileNo übergeben wird. z.B. +49123456789
sdMobileNo	ans..50	OC	Mobile phone number: is not mandatory for FacilyPay and Cetelem if parameter Phone is transmitted. e.g. +49123456789	Handynummer: muss bei FacilyPay und Cetelem nicht übergeben werden, wenn der Parameter Phone übergeben wird. z.B. +49123456789
			Product information	Produktinformationen
ArticleList	ans..1024	C	Article list. Mandatory with Facilypay. These parameters must have the following structure: ID,Description,UnitPrice,Quantity,Category,Brand Several articles can be separated with a +, e.g.: 123,iPhone 6s,700,1,Phones,Apple+321,Galaxy S7,700,2,Phones,Samsung Possible values for Category: ComputersAndSoftware Electronics Phones Appliances HomeAndGarden Fashion HealthAndBeauty Jewellery Sport LeisureAndHobbies CarsAndMotorbikes Furniture KidsAndBaby VideoGamesAndConsoles ToysAndGames Pets FoodAndDrink GiftAndFlowers Entertainment Travel AuctionsAndGroupBuying ServicesForIndividuals ServicesForProfessionals	Artikelliste. Pflicht bei Facilypay. Dieser Parameter muss folgenden Aufbau haben: ID,Description,UnitPrice,Quantity,Category,Brand Mehrere Artikel können durch ein + getrennt werden, z.B.: 123,iPhone 6s,700,1,Phones,Apple+321,Galaxy S7,700,2,Phones,Samsung Mögliche Werte für Category: ComputersAndSoftware Electronics Phones Appliances HomeAndGarden Fashion HealthAndBeauty Jewellery Sport LeisureAndHobbies CarsAndMotorbikes Furniture KidsAndBaby VideoGamesAndConsoles ToysAndGames Pets FoodAndDrink GiftAndFlowers Entertainment Travel AuctionsAndGroupBuying ServicesForIndividuals ServicesForProfessionals
ShippingData	ans..1024	C	Delivery data. Mandatory with Facilypay. These parameters must have the following structure: Type,Description,Speed,ExpectedDate,ExpectedDelay e.g.: Other,DHL,Standard,2016-06-30,3 Possible values for Type: StorePickup NetworkPickup TravelPickup Carrier EDelivery Other Possible values for Speed: Express Standard	Lieferdaten. Pflicht bei Facilypay. Dieser Parameter muss folgenden Aufbau haben: Type,Description,Speed,ExpectedDate,ExpectedDelay z.B.: Other,DHL,Standard,2016-06-30,3 Mögliche Werte für Type: StorePickup NetworkPickup TravelPickup Carrier EDelivery Other Mögliche Werte für Speed: Express Standard

Parameters for payments with Thunes

Key	Format	CND	Description	Beschreibung
CodeExt	ans..256	C	Error code from Limonetik. Notice: Is returned only if Status=FAILED. Use is possible only in agreement with .	Fehlercode von Limonetik. Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem möglich.
ErrorText	ans..128	C	Detailed Limonetik error message. Notice: Is returned only if Status=FAILED. Use is possible only in agreement with .	Detaillierte Limonetik-Fehlermeldung. Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem möglich.
TransactionID	ans..50	O	ID for identification of payment form	ID zur Identifizierung des Zahlscheins

Results parameters for URLNotify, URLSuccess and URLFailure

Capture

Captures are possible via a Server-to-Server connection. To carry out a Capture for Thunes via a Server-to-Server connection, please use the following URL:

capture.aspx

Parameters for Thunes captures

Result parameters for Thunes captures

Credit with reference

credit.aspx

Notice: With Facilypay a refund usually is possible only 48 hours after the payment. Thunes stores the refund request and retries the request to Facilypay until this will be processed. During this time the transaction is “Suspended” and no other refunds are possible.

Parameters for credits of Thunes payments

Result parameters for credits of Thunes payments

Reversal

To cancel a transaction with Thunes, please use the following URL:

reverse.aspx

Parameters for reversals of Thunes payments

Result parameters for reversals of Thunes payments

Batch processing via the interface

This section describes the parameters which must be transferred within the data set (Record) for executing of captures, credits and reversals for Thunes and which information can be found within the response file about the payment status.

Following table gives an overview of all batch versions that are possible for a specific action an their specialities:

Action	Version	Description	Beschreibung
Capture	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
Credit	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
Reverse	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2x.	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)

Description of the possible batch versions

The structure for a Thunes payment within a Batch file to be submitted is the following:

HEAD,<MerchantID>,<Date>,<Version>
Limonetik,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
Limonetik,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
Limonetik,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

Key

Format

CND

Description

Beschreibung

Type

a..11

M

HEAD for Header, FOOT for Footer, Limonetik for Thunes (Limonetik)

HEAD für Header, FOOT für Footer, Limonetik für Thunes (Limonetik)

Action

a..20

M

The parameter Action defines the type of transaction:

Capture

Credit

Reverse (cancellation)

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

Reverse (Storno)

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks the following way:

HEAD,<MerchantID>,<Date>,<Version>
Limonetik,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
Limonetik,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
Limonetik,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Key	Format	CND	Description	Beschreibung
Action	a..20	M	The parameter Action defines the type of transaction: Capture Credit Reverse (cancellation)	Der Action-Parameter definiert die Art der Transaktion: Capture (Buchung) Credit (Gutschrift) Reverse (Storno)

Description of result parameters within the record for Batch files