Über Cofidis

Allgemeine Informationen über Cofidis

Die 4-Sterne-Karte wurde von Cofidis bereits bei der Gründung 1982 eingeführt, anfangs exklusiv für Kunden der Marke 3 Suisses. Als eine persönliche Karte kombiniert sie Zahlungsfunktionen und Kundenvorteile. Das Design maßgeschneiderter Produkte und Dienstleistungen entsprechend den Erwartungen und Wünschen der Kunden hat Cofidis im Laufe der Jahre ermöglicht, die 4-Sterne-Karte auch andere Marken (in Geschäften und im Internet) auszudehnen wie Feu Vert, Maty, Blancheporte, Helline, Bon prix, etc.

Ab jetzt sprechen wir von dem 4-Sterne-Netzwerk. Zahlen Sie Ihre Käufe in mehreren Raten.

Die 4-Sterne-Karte ist eine revolvierende Kreditkarte, die Ihnen je nach Betrag Ihrer Einkäufe und der Marke ermöglicht, in mehreren Raten zu bezahlen.


Logo

Info

Die 4-Sterne-Karte ist eine persönliche Karte, die Zahlungsfunktionen und Kundenvorteile kombiniert. Das Design der maßgeschneiderten Produkte und Dienstleistungen orientiert sich an den Erwartungen und Wünschen der Kunden. Zahlen Sie Ihre Käufe in mehreren Raten. Die 4-Sterne-Karte ist eine revolvierende Kreditkarte, die Ihnen je nach Betrag Ihrer Einkäufe und der Marke ermöglicht, in mehreren Raten zu bezahlen.

TypeZahlungen per Kreditkarte

Diagramm zum Prozessablauf

Cofidis Prozessablauf über die Formular-Schnittstelle


-Schnittstelle

Sonderzeichen

Cofidis akzeptiert nur ein begrenzte Auswahl an Sonderzeichen gemäß folgender Tabelle:

Zeichen

Name
:Doppelpunkt
.Punkt

Leerzeichen
@At-Zeichen (Klammeraffe)
+Pluszeichen
%Prozentzeichen
*Sternchen
/Schrägstrich
_Unterstrich
-Strich (Trennstrich/Minuszeichen)


Kreditkartenmarken

Kreditkartenmarke, korrekte Schreibweise für CCBrand

Carte 4Etoiles (Carte Helline4etoiles – branded)


Kreditkartenzahlung mit Cofidis über Cofidis Formular-Schnittstelle

Um eine TLS-Kreditkartenzahlung über ein Cofidis-Formular abzuwickeln, verwenden Sie bitte folgende URL:

cofidis.aspx

 

Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..15

O

Eindeutige Referenznummer des Händlers

Key

Format

CND

Beschreibung

OrderDescans..768MBeschreibung der Waren, Einzelpreise usw.
CCBrandan14M"Carte 4Etoiles"

Parameter für Kreditkartenzahlungen über die Cofidis Formular-Schnittstelle


Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..15

O

Eindeutige Referenznummer des Händlers

Key

Format

CND

Beschreibung
addata1n..3M

Gemäß der vom Kunden gewählten Modalität:

  • 000 : kleine Monatsrate
  • 993 : 3 Monate Zahlungsaufschub
  • Anderer Wert: Anzahl der Raten
    • 001 (Sofortzahlung),
    • 003 Mindestbetrag: 70€
    • 010 Mindestbetrag: 200€
EIDan8C

Vom vergebene ID

Ergebnis-Parameter für URLSuccess, URLFailure and URLNotify über die Cofidis Formular-Schnittstelle


Kreditkartenzahlung mit Cofidis über standardmäßige Formular-Schnittstelle

Um eine TLS-Kreditkartenzahlung mit Cofidis über ein standardmäßiges -Formular abzuwickeln, verwenden Sie bitte folgende URL:

payssl.aspx

 

Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key

Format

CND

Beschreibung
expirationTime

ans..19

O

Zeitstempel für den Endzeitpunkt der Transaktionsverarbeitung, Angabe in UTC.

Format: YYYY-MM-ddTHH:mm:ss

DateOfBirthn8MGeburtsdatum im Format "TTMMJJJJ"

RefNr

ns..30

M

Eindeutige Referenznummer des Händlers, welche als Auszahlungsreferenz in der entsprechenden Acquirer EPA-Datei angegeben wird. Bitte beachten Sie, ohne die Übergabe einer eigenen Auszahlungsreferenz können Sie die EPA-Transaktionen nicht zuordnen, zusätzlich kann das Settlement File (CTSF) auch nicht zusätzlich angereichert werden.

OrderDescans..768MBeschreibung der Waren, Einzelpreise usw.

CreditCardHolder

ans..60

O

Name des Karteninhabers

RTF

a1

O

Bei wiederkehrenden Zahlungen (Abos): I = Initialzahlung eines neuen Abos, R = Wiederkehrende Zahlung (Recurring)

addata1

ans..28

O

Transaktionscode [AN3]/Anzahl Raten [AN2]/Rechnungsnummer [AN15]/Rechnungsdatum[N8]

Zu übergeben ohne Trennzeichen. Für die initiale Reservierung können Rechnungsnummer und Rechnungsdatum noch nicht vorhanden sein. In diesem Fall sind diese Felder mit Leerzeichen anzugeben.

Der Transaktionscode wurde entsprechend der Cofidis-Spezifikation umgesetzt, siehe nachfolgende Tabelle Transaktionscodes. Bitte beachten Sie den separaten Hinweis zu diesem Parameter.

Textfeld1

ans..30

O

Weitere Referenznummer der Transaktion

Parameter für Kreditkartenzahlungen mit Cofidis über ein -Formular


Hinweis zum Cofidis-Parameter Addata1: Cofidis erwartet, dass alle Reservierungen mit dem Transaktionscode 590 durchgeführt und bei der Buchung durch den korrekten Transaktionscode ersetzt werden. Da Rechnungsnummer und Datum bei der Reservierung eventuell noch unbekannt sind, übergeben Sie dafür bei der Reservierung Leerzeichen. Falls der Transaktionscode bei der Faktura nicht mehr verfügbar ist, kann die Reservierung bereits mit dem korrekten Code durchgeführt werden. ersetzt dann den Buchungs-Transaktionscode durch die 590 und ändert ihn bei Faktura auf den bei der Reservierung übergebenen zurück. Dabei werden auch die Rechnungsnummer und das Rechnungsdatum übernommen und an Cofidis übergeben.

Finanzierungstyp

PGI-Request

Transaktionscode

Anzahl der Raten

Kleine Rate

Buchung, tel. Autorisierung

460

0 (irrelevant)

Kleine Rate

Gutschrift

470

0 (irrelevant)

Sofortzahlung

Buchung

423

1

Sofortzahlung

Gutschrift

523

1

Monatsrate

Buchung

423

x

Monatsrate

Gutschrift

523

x

Zahlpause

Buchung

974

0 (irrelevant)

Zahlpause

Gutschrift

975

0 (irrelevant)

Cofidis Transaktionscodes


Um das Layout der SSL-Seite an den Shop anzupassen, können Sie mit den folgenden unverschlüsselten Parametern Farben, Schriften und Bilder konfigurieren:

Key

Format

CND

Beschreibung

Language

a2

(enum)

O

Sprachcode: <de> deutsch, <al> albanisch, <at> österreichisch, <cz/cs> tschechisch, <dk> dänisch, <en> englisch, <fi> finnisch, <fr> französisch, <gr> griechisch, <hu> ungarisch, <it> italienisch, <jp> japanisch, <nl> holländisch, <no> norwegisch, <pl> polnisch, <pt> portugiesisch, <ro> rumänisch, <ru> russisch, <es> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> türkisch, <zh> Simplified Chinese

Ohne Angabe ist die Sprache Deutsch.

CCSelecta..16OBestimmt die vorausgewählte Kartenmarke im Formular: VISA, MasterCard, AMEX, DINERS, JCB, CBN, Hipercard, Elo, Aura, Dankort, Airplus, ComfortCard, CUP oder Maestro

Layout-Parameter für -Formulare bei Kreditkartenzahlungen



Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..15

O

Eindeutige Referenznummer des Händlers, welche als Auszahlungsreferenz in der entsprechenden Acquirer EPA-Datei angegeben wird. Bitte beachten Sie, ohne die Übergabe einer eigenen Auszahlungsreferenz können Sie die EPA-Transaktionen nicht zuordnen, zusätzlich kann das Settlement File (CTSF) auch nicht zusätzlich angereichert werden.

Key

Format

CND

Beschreibung
TIDn..15MDer Wert wird als TransaktionsID des Providers zurückgegeben
addata1ans..28ORückgabe wie beim Aufruf

Key

Format

CND

Beschreibung
CCBranda..22OCIn Kombination mit PCNr: Bezeichnung der Kreditkartenmarke. Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

Key

Format

CND

Beschreibung
MaskedPanan..19OC

Maskierte Kartennummer 6X4. Wenn Sie den Parameter MaskedPan erhalten möchten, wenden Sie sich bitte an den , der die Rückgabe aktivieren kann.

Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure mit Cofidis über ein -Formular


Kreditkartenzahlung per Server-to-Server-Verbindung

Um eine TLS-Kreditkartenzahlung mit Cofidis über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

direct.aspx

 

Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key

Format

CND

Beschreibung

CCNr

n..19

M

Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer übergeben.

CCCVC

n..4

O

Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.

CCExpiry

n6

M

Ablaufdatum der Kreditkarte im Format JJJJMM, z.B. 201707

CCBrand

a..22

M

Kreditkartenmarke. Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

Key

Format

CND

Beschreibung
DateOfBirthn8MGeburtsdatum im Format "TTMMJJJJ"

RefNr

ns..30

M

Eindeutige Referenznummer des Händlers, welche als Auszahlungsreferenz in der entsprechenden Acquirer EPA-Datei angegeben wird. Bitte beachten Sie, ohne die Übergabe einer eigenen Auszahlungsreferenz können Sie die EPA-Transaktionen nicht zuordnen, zusätzlich kann das Settlement File (CTSF) auch nicht zusätzlich angereichert werden.

OrderDescans..768MBeschreibung der Waren, Einzelpreise usw.

CreditCardHolder

ans..60

O

Name des Karteninhabers

RTF

a1

O

Bei wiederkehrenden Zahlungen (Abos): I = Initialzahlung eines neuen Abos, R = Wiederkehrende Zahlung (Recurring)

addata1

ans..28

M

Transaktionscode [AN3]/Anzahl Raten [AN2]/Rechnungsnummer [AN15]/Rechnungsdatum[N8]

Zu übergeben ohne Trennzeichen. Für die initiale Reservierung können Rechnungsnummer und Rechnungsdatum noch nicht vorhanden sein. In diesem Fall sind diese Felder mit Leerzeichen anzugeben.

Der Transaktionscode wurde entsprechend der Cofidis-Spezifikation umgesetzt, siehe nachfolgende Tabelle Transaktionscodes. Bitte beachten Sie den separaten Hinweis zu diesem Parameter.

Textfeld1

ans..30

O

Weitere Referenznummer der Transaktion
Parameter für Kreditkartenzahlungen mit Cofidis über Socket-Verbindung


Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key

Format

CND

Beschreibung
CCBranda..22OCIn Kombination mit PCNr: Bezeichnung der Kreditkartenmarke. Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

Key

Format

CND

Beschreibung
MaskedPanan..19OC

Maskierte Kartennummer 6X4. Wenn Sie den Parameter MaskedPan erhalten möchten, wenden Sie sich bitte an den , der die Rückgabe aktivieren kann.

RefNr

ans..30

O

Eindeutige Referenznummer des Händlers, welche als Auszahlungsreferenz in der entsprechenden Acquirer EPA-Datei angegeben wird. Bitte beachten Sie, ohne die Übergabe einer eigenen Auszahlungsreferenz können Sie die EPA-Transaktionen nicht zuordnen, zusätzlich kann das Settlement File (CTSF) auch nicht zusätzlich angereichert werden.

addata1

ans..28

O

Rückgabe wie beim Aufruf
Ergebnis-Parameter über Socket-Verbindungen für Cofidis


Buchung einer Kreditkartenzahlung mit Cofidis

Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Buchung (Capture) über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

capture.aspx

 

Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..15

O

Eindeutige Referenznummer des Händlers

Parameter für Buchungen von Cofidis über Socket-Verbindungen


Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..15

O

Eindeutige Referenznummer des Händlers

Ergebnis-Parameter für Buchungen von Cofidis über Socket-Verbindungen


Gutschrift mit Referenz

credit.aspx

 

Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..15

O

Eindeutige Referenznummer des Händlers

Parameter für Gutschrift von Kreditkartenzahlungen mit Cofidis über Socket-Verbindungen


Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..15

O

Eindeutige Referenznummer des Händlers

Ergebnis-Parameter für Gutschrift von Kreditkartenzahlungen mit Cofidis über Socket-Verbindungen


Storno

Stornierungen sind über eine Server-zu-Server-Kommunikation möglich. Eine Kreditkartenautorisierung senkt das Kartenlimit des Kunden. Um das Limit wieder freizugeben, kann das eine Autorisierung stornieren.

Um eine Stornierung mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:

reverse.aspx


Hinweis: Die Reverse.aspx macht nicht nur Autorisierungen, sondern IMMER DEN LETZTEN TRANSAKTIONSSCHRITT rückgängig! Falls die letzte Transaktion eine Buchung war, löst die Reverse.aspx z.B. eine Gutschrift aus. Es ist daher größte Vorsicht geboten, und die Nutzung erfolgt auf eigene Gefahr. Wir empfehlen, vor Nutzung der Reverse.aspx den Transaktionsstatus mit der Inquire.aspx prüfen.

Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..15

O

Eindeutige Referenznummer des Händlers

Parameter für Storno von Kreditkartenzahlungen mit Cofidis über Socket-Verbindungen


Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..15

O

Eindeutige Referenznummer des Händlers

Ergebnis-Parameter für Storno von Kreditkartenzahlungen mit Cofidis über Socket-Verbindungen


Batch-Nutzung der Schnittstelle

Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer Kreditkartenzahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.

Bei den Batch-Aufrufen ist die verwendete Batch-Version zu unterscheiden, wovon die optionalen Parameter abhängen. Alle mit „2.“ beginnen Versionsbezeichnungen betreffen Aufrufe für einen Konzern. Das bedeutet, innerhalb einer Batch-Datei mit einer bestimmten MerchantID können auch Transaktionen anderer Händler mit einer abweichenden Sub-MID übertragen werden.

Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:

Action

Version

Beschreibung

Capture

1.x / 2.x

Standardversion
Credit1.x / 2.xStandardversion
Reverse1.x / 2.xStandardversion

Beschreibung der möglichen Batch-Versionen


Der Aufbau für eine Cofidis-Kreditkartenzahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:


Beispiel für Master-MID-Funktion:


Key

Format

CND

Beschreibung

Type

a..11

M

HEAD für Header, FOOT für Footer, CC für Cofidis

Action

a..20

M

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

Reverse (Storno)

Key

Format

CND

Beschreibung

TransID

ans..15

M

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..15

O

Eindeutige Referenznummer des Händlers

Beschreibung der Felder im Datensatz von Batch-Dateien

 

Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:


Key

Format

CND

Beschreibung

Action

a..20

M

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

Reverse (Storno)

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien