Page tree

Search

Skip to end of metadata
Go to start of metadata


Über Cetelem FullCB

Allgemeine Informationen über Cetelem FullCB


Logo

Info

Cetelem FullCB oder Cetelem 3xCB/4xCB ist auch bekannt als BNPP PF FullCB (BNP Paribas Personal Finance FullCB).

Die Zahlungsmethode Cetelem 3x/4x 3x/4x FullCB ermöglicht Kunden, ihre Online-Einkäufe zwischen 90€ und 3000€ mit CB, Visa oder Mastercard Debitkarten in 3 oder 4 Ratenzahlungen zu bezahlen. Derm Händler wird garantiert, den vollen Betrag der Transaktionen zu erhalten, sobald die Kreditanfrage von Cetelem genehmigt/validiert ist. Die akzeptierten Kreditkarten sind Cartes Bancaires (CB), französische VISA-Karte und französische MasterCard. Andere Kartenmarken wie Electron, Maestro, Prepaid-Karten und virtuelle Karten werden nicht akzeptiert.

Nachdem die Zahlung genehmigt worden ist, wir dem Karteninhaber 1/3 oder 1/4 des Kaufpreises belastet und dann wird seine Zahlungskarte monatlich für die verbleibenden fälligen Raten belastet. Dem Händler wird der Gesamtbetrag der Bestellung innerhalb von 48 Stunden nach der Inkassoanfrage ausgezahlt.

Die Zahlungen sind garantiert.

TypZahlungen per Kreditkarte


Diagramm zum Prozessablauf


Cetelem FullCB Prozessablauf


Paygate-Schnittstelle

Definitionen

Datenformate:

FormatBeschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

ISODateTime (JJJJ-MM-TTThh:mm:ss)


Abkürzungen:

AbkürzungBeschreibung

CND

Bedingung (condition)

M

Pflicht (mandatory)

O

optional

C

bedingt (conditional)


Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.


Zahlung mit Cetelem FullCB via Formular-Schnittstelle

Um eine Zahlung mit FullCB abzuwickeln, verwenden Sie bitte folgende URL:


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

TransID

asn..64

M

Transaktionsnummer des Händlers, die für jede Zahlung eindeutig sein sollte

RefNr

an..30

O

Ergänzende Transaktionsnummer. Nur folgende Zeichen sind erlaubt:

  • Buchstaben [A-Za-z] (von A bis Z in Groß- oder Kleinschreibung)
  • Ziffern [0-9] (von 0 bis 9)

Hinweis: Falls die RefNr nicht vorhanden ist, wird stattdessen die TransID verwendet. Deshalb muss die TransID in diesem Fall Format und Länge der RefNr einhalten.

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217. Nur EUR zulässig.

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

URLSuccess

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData.

URLFailure

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData.

Response

a7

O

Die Status-Rückmeldung, die das Paygate an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt.

URLNotify

ans..256

M

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData.

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop

ReqID

ans..32

O

Um Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

OrderDesc

ans..768

M

Beschreibung der Waren, Einzelpreise usw., Verwendungszweck auf dem Kontoauszug

SellingPoint

ans..50

O

Verkaufsstelle

Service

ans..50

O

verkaufte Produkte oder Dienstleistung

Channel

ans..64

O

Konfigurationskanal des PPRO-Vertrags (Account und ContractID sind im System hinterlegt). Wenn vorhanden, überschreibt er eventuell im System hinterlegten Channel.

Plain

ans..50

O

Ein von Händler zu setzender Wert, um Informationen wieder unverschlüsselt zurückzugeben, z.B. die MID

Custom

ans..1024

O

Der Händler kann mehrere Werte durch | getrennt übergeben, die unverschlüsselt durch & getrennt zurückgegeben werden.

Custom=session=123|id=456 wird in der Antwort zu Session=123&id=456

PayTypen1MZu verwendende Cetelem-Zahlungsmethode. 1 → Cetelem3xCB, 2 → Cetelem4xCB
EnhancedDataans..400O

Spezifische Daten des Händlers, basierend auf der Vereinbarung zwischen BNPP PF FullCB und dem Händler. Nachstehendes Format wird verwendet:

VARIABLE_NAME1=VALUE| VARIABLE_NAME2=VALUE|…

Kundeninformationen
Salutationa..4MZulässige Werte: M, Mme, Mlle und mit einer Abbildung der englischen auf die französische Anrede (Mr, Mrs, Miss)
FirstNameans..40MVorname des Kunden
LastNameans..40MNachname des Kunden
Emailans..100ME-Mail-Adresse des Kunden
Phoneans..30MTelefonnummer des Kunden
CustomerInformationans..400O

Spezielle Danten, die für spezielle Aktionen bereitgestellte werden können, basierend auf der Vereinbarung zwischen BNPP PF FullCB und dem Händler. Format nachstehend:

VARIABLE_NAME1=VALUE| VARIABLE_NAME2=VALUE|…

Das Paygate leitet diese Information nur ohne eine Validierung weiter.
Rechnungsadresse
bdFirstNameans..40MVorname für die Rechnungsadresse
bdLastNameans..40MNachname für die Rechnungsadresse
bdStreetans..60MStraßenname und Hausnummer in der Rechnungsadresse
bdAddressAdditionans..60OZusätzliche/ergänzende Adresszeile
bdZipn..5MPostleitzahl in der Rechnungsadresse
bdCityans..40MStadt/Ort in der Rechnungsadresse
bdCountryCodea2MLändercode der Rechnungsadresse gemäß ISO-3166-1, alphanumerisch 2-stellig
Lieferadresse
UseBillingDataa..3MRechnungsdaten als Lieferdaten verwenden (ja/nein) - falls ja, dann sind alle Parameter der Lieferadresse Pflicht außer "sdAddressAddition"
sdFirstNameans..40OVorname in der Lieferadresse
sdLastNameans..40ONachname in der Lieferadresse
sdStreetans..60OStraßenname und Hausnummer in der Lieferadresse
sdAddressAdditionans..60OAdresszusatz in der Lieferadresse - auch optional, wenn "UseBillingData" wahr / ja ist
sdZipn..5OPostleitzahl in der Lieferadresse
sdCityans..40OStadt/Ort in der Lieferadresse
sdCountryCodea2OLändercode der Lieferadresse gemäß ISO-3166-1, alphanumerisch 2-stellig

Parameter für Zahlungen mit CeletemFullCB


Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate an Ihre URLSuccess, URLFailure oder URLNotify übergibt. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen, die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers, die für jede Zahlung eindeutig sein sollte

RefNr

an..30

C

Ergänzende Transaktionsnummer. Nur folgende Zeichen sind erlaubt:

  • Buchstaben [A-Za-z] (von A bis Z in Groß- oder Kleinschreibung)
  • Ziffern [0-9] (von 0 bis 9)

Hinweis: Falls die RefNr nicht vorhanden ist, wird stattdessen die TransID verwendet. Deshalb muss die TransID in diesem Fall Format und Länge der RefNr einhalten.

Status

a..30

M

OK bei URLSuccess und AUTHORIZE_REQUEST oder FAILED bei URLFailure

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

UserData

ans..1024

O

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop

PaymentPurpose

ans..26

M

Zahlungszweck

PaymentGuarantee

a..12

C

NONE = keine Zahlungsgarantie,

VALIDATED = Kundenkonto valide, aber keine Zahlungsgarantie,

FULL = Zahlungsgarantie

Hinweis: Dieser Parameter wird nur zurückgegeben, falls der Status=OK ist.

ErrorText

ans..256

C

Detaillierte PPRO Fehlermeldung.

Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem Computop Support möglich.

TransactionID

an..14

M

Externe ID der Zahlungsanfrage

CodeExt

n2

M

Antwortcode der Gutschriftsanfrage

PIDan..25MExterne ID der Transaktionsanfrage

Plain

ans..50

O

Ein von Händler zu setzender Wert, um Informationen wieder unverschlüsselt zurückzugeben, z.B. die MID

Custom

ans..1024

O

Der Händler kann mehrere Werte durch | getrennt übergeben, die unverschlüsselt durch & getrennt zurückgegeben werden.

Custom=session=123|id=456 wird in der Antwort zu Session=123&id=456

Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify mit Cetelem FullCB



Gutschrift mit Referenz

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Bei einer Gutschrift mit Bezug auf eine Buchung ist die Höhe der Gutschrift auf die Höhe der vorherigen Buchung beschränkt.

Um eine Gutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

PayID

an32

M

Vom Paygate vergebene ID für die gutzuschreibende Transaktion

TransID

ans..64

M

Transaktionsnummer des Händlers, die für jede Zahlung eindeutig sein sollte

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a..3

M

Währungskürzel, drei Zeichen DIN / ISO 4217

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

ReqIDans..32OUm Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Parameter für Gutschrift von Zahlungen mit Cetelem FullCB über Socket-Verbindungen


Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien

XID

an32

M

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

TransID

ans..64

M

Transaktionsnummer des Händlers, die für jede Zahlung eindeutig sein sollte

Status

a..30

M

OK oder FAILED

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

TransactionID

an..14

M

Externe ID der Zahlungsanfrage

CodeExt

n2

M

Antwortcode der Gutschriftsanfrage

PIDan..25MExterne ID der Transaktionsanfrage

Antwort-Parameter für Gutschrift von Zahlungen mit Cetelem FullCB über Socket-Verbindungen