• DeutschEnglish

FLOA Pay

Über FLOA Pay

Allgemeine Informationen über FLOA Pay

Logo

COO 6505 1000 12 647140

Info

FLOA Pay ermöglicht es einem Händler, 3X-, 4X-, 1XD- oder 3XD-Ratenpläne für Kunden während des Bezahlvorgangs anzubieten.

Im ersten Schritt prüft FLOA Pay den Kunden auf die Berechtigung für die gewählte Ratenzahlung. Bei einem positiven Ergebnis leitet FLOA Pay den Kundan dann zur FLOA Pay Hosted Payment page weiter.

Ein Händler kann bei FLOA Pay für eine automatische Buchung (AUTO) oder manuelle Buchung (MANUAL) konfiguriert werden. Bei der AUTO-Buchung erwartet FLOA Pay keine Buchung durch den Händler. FLOA Pay bucht automatisch basierend auf der Autorisierung. Bei manueller Buchung (MANUAL) muss der Händler die Buchungs-API aufrufen.

Nach einer Bonitätsprüfung übernimmt FLOA Pay das gesamte Zahlungsausfallrisiko des Kunden für jede Transaktion. Der Händler erhält nach der Buchung den vollen Betrag der Ratenzahlung von FLOA Pay.

Typ

Zahlungen per Rechnungs- und Ratenkauf

Weitere Informationen finden Sie auch auf der Webseite von FLOA Pay (https://www.floapay.com/).

Diagramm zum Prozessablauf

Prozessablauf für Ratenzahlung mit FLOA Pay

Hinweis: FLOA Pay führt anhand der bereitgestellten Daten eine Berechtigungsprüfung durch und leitet den Kunden im Erfolgsfall auf die Zahlungsseite weiter. Das Ergebnis der Autorisierung wird im Rückruf und in der Benachrichtigung bereitgestellt.

Paygate-Schnittstelle

Definitionen

Datenformate

Format

Beschreibung

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ürzung

Beschreibung

Kommentar

CND

Bedingung (condition)

M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich

C

bedingt (conditional)

Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist

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

Autorisierung

Um eine Ratenzahlung mit FLOA Pay anzulegen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/floapay.aspx

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:

KeyFormatCNDDescription

MerchantID

ans..30

M

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

TransID

ans..64

M

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop 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. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

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.

Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

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.

Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

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. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

Allgemeine Hinweise:

  • Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.

  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

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 (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

EventToken

ans..5

O

Falls der Parameter nicht gesendet wird, ist das eine allgemeine Autorisierungsanfrage.

Falls EventToken=SCHEDULE ist, gibt die Anfrage den geschätzten Zeitplan basierend auf dem Betrag zurück.

Language

ans..5

O

Sprache. "fr-FR" ist der Standardwert.

Mögliche Werte:

  • "fr-FR" für eine französische Bestellung in Französisch

  • "fr-BE" für eine belgische Bestellung in Französisch

  • "nl-BE" für eine belgische Bestellung in Flämisch

  • "en-BE" für eine belgische Bestellung in Englisch

  • "es-ES" für eine spanische Bestellung in Spanisch

  • "it-IT" für eine italienische Bestellung in Italienisch

MerchantIDExt

n..10

O

Von FLOA Pay bereitgestellte MerchantID

PayType

n..10

O

Von FLOA Pay bereitgestellte MerchantSiteID

CustomerID

ans..30

C

Die eindeutige Kennung des Kunden im Informationssystem des Händlers.

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

FirstName

ans..64

C

Vorname des Käufers.

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

LastName

ans..64

C

Nachname des Käufers.

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

MaidenName

ans..64

O

Geburtsname

Salutation

ans..3

O

Anrede

DateOfBirth

dttm

O

Geburtsdatum des Käufers.

Format: JJJJ-MM-TT

PlaceOfBirth

ans..6

O

Postleitzahl des Geburtsortes.

  • Muss 2, 3 oder 5 Zeichen enthalten

  • Muss "99" sein, wenn Ausländer

  • Muss "972" für Martinique sein

  • Muss "06000" für Nizza sein und nicht "6000"

MobileNr

ans..15

C

Privat- oder Handynummer.

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

Email

ans..60

C

E-Mail-Adresse des Käufers.

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

AddrStreet

ans..32

O

Die Hauptadresse

AddrStreet2

ans..32

O

Zusatzadresse 1 (Gebäude, Wohnung, Türcode)

AddrZIP

ans..10

O

Postleitzahl

AddrCity

ans..50

O

Ort

AddrCountryCode

ans..2

C

Ländercode zweistellig gemäß ISO 3166-2.

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

PersonID

ans..8

C

Steueridentifikationsnummer, obligatorisch für Kunden in Spanien und Italien.

Pflicht, wenn Country="ES" oder Country="IT"

Date

ans..10

C

Kaufdatum der Bestellung.

Format: TT/MM/JJJJ

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

Channel

ans..18

C

Verkaufskanal.

Mögliche Werte:

  • DESKTOP

  • TABLET

  • TABLET_IPAD

  • SMARTPHONE

  • SMARTPHONE_ANDROID

  • SMARTPHONE_IPHONE

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

DeliveryChannel

ans..3

C

Liefermethode des Händlers. „STD“ ist der Standardwert.

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

NumberArticles

ans..3

C

Anzahl der Artikel in der Bestellung.

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

ActivationDelay

n..3

C

Nur für 1XD: Anzahl Tage der Zurückstellung

Homepage

ans..256

C

URL der Homepage der Händlerseite,

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

URLBack

ans..256

C

URL zurück zur vorherigen Seite der Händlerseite.

Pflicht, wenn der Parameter EventToken nicht gesendet wird.

Fee

n..10

O

Gesamtbetrag der mit der Bestellung verbundenen Gebühren (in Cent)

Discount

n..10

O

Gesamtbetrag der mit der Bestellung verbundenen Rabatte (in Cent)

shAmount

n..10

O

Gesamtbetrag der Versandkosten für die Bestellung (in Cent)

sdStreet

ans..32

O

Lieferadresse Zeile 1

sdStreet2

ans..32

O

Lieferadresse Zeile 2

sdZIP

ans..10

O

Postleitzahl der Lieferadresse

sdCity

ans..50

O

Ort der Lieferadresse

sdCountryCode

ans..2

O

Alpha-2 ISO-Ländercode (z. B. FR)

CustomerHistory

ans..1024

O

Informationen zur Kundenhistorie als JSON-String im Base64-Format. Siehe JSON-Objekt: CustomerHistory

TravelDetails

ans..1024

O

Reisedetails (einschließlich Passdaten) als JSON-String im Base64-Format. Siehe JSON-Objekt: TravelDetails

StayDetails

ans..1024

O

Aufenthaltsdetails als JSON-String im Base64-Format. Siehe JSON-Objekt: StayDetails

ProductDetails

ans..1024

O

Produktdetails als JSON-String im Base64-Format. Siehe JSON-Objekt: ProductDetails

AdditionalFields

ans..1024

O

Array des JSON-Objektes AdditionalField als String im Base64-Format.

Parameter für Ratenzahlungen mit FLOA Pay

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

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

AUTHORIZE_REQUEST (URLSuccess) oder FAILED (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

an8

M

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

UserData

ans..1024

O

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

CodeExt

n..10

O

Fehlercode von FLOA Pay, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..256

O

Fehlertext von FLOA Pay, wenn mit Computop Helpdesk abgesprochen

PaymentDetails

ans..512

O

Wenn EventToken=SCHEDULE ist, enthält der Parameter Informationen zum voraussichtlichen Zeitplan im folgenden Format.

Beispiel: <TotalAmount>;<Date1>;<Amount1>;<Date2>;<Amount2>;<Date3>;<Amount3>;...

<TotalAmount> ist der Gesamtbetrag, den der Kunde zahlen wird (Kaufbetrag + Zinsen, Gebühren usw.)

<Date1> ist das Datum  der ersten Rückzahlung

<Amount1> ist der Betrag der ersten Rückzahlung

usw.

Ergebnis-Parameter für Ratenzahlungen mit FLOA Pay

Buchung

Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Es sind sowohl Komplettbuchungen als auch Teilbuchungen möglich. Um eine Ratenzahlung mit FLOA Pay über eine Server-zu-Server-Verbindung zu buchen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/capture.aspx

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:

KeyFormatCNDDescription

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 zu buchende Zahlung

TransID

ans..64

M

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

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop 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. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

UserData

ans..1024

O

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Parameter für Buchungen mit FLOA Pay

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

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (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

an8

M

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

UserData

ans..1024

O

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

CodeExt

n..10

O

Fehlercode von FLOA Pay, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..256

O

Fehlertext von FLOA Pay, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter für Buchungen mit FLOA Pay

Gutschrift mit Referenz

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Es sind sowohl Komplettgutschriften als auch Teilgutschriften zulässig. Um eine Ratenzahlung mit FLOA Pay gutzuschreiben, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/credit.aspx

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:

KeyFormatCNDDescription

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 Zahlung

TransID

ans..64

M

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

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop 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. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

UserData

ans..1024

O

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Parameter für Gutschrift von Zahlungen mit FLOA Pay

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

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (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

an8

M

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

UserData

ans..1024

O

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

CodeExt

n..10

O

Fehlercode von FLOA Pay, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..256

O

Fehlertext von FLOA Pay, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter für Gutschrift von Zahlungen mit FLOA Pay

Storno

Stornierungen sind über eine Server-zu-Server-Kommunikation möglich. Es ist nur eine vollständige Stornierung zulässig. Um eine Ratenzahlung mit FLOA Pay zu stornieren, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/reverse.aspx

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:

KeyFormatCNDDescription

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 zu stornierende Zahlung

TransID

ans..64

M

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

Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop 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. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

UserData

ans..1024

O

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Parameter für Storno von Zahlungen mit FLOA Pay

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

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDDescription

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 sowie im Capture- oder Credit-Request.

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

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Status

a..50

M

OK (URLSuccess) oder FAILED (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

an8

M

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

UserData

ans..1024

O

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

CodeExt

n..10

O

Fehlercode von FLOA Pay, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..256

O

Fehlertext von FLOA Pay, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter für Storno von Zahlungen mit FLOA Pay

JSON-Objekte

Die JavaScript Object Notation, kurz JSON, ist ein kompaktes Datenformat in einem gut lesbaren Textformat zum Zweck des Datenaustauschs zwischen Anwendungen. JSON ist unabhängig von der Programmiersprache. Parser gibt es in praktisch allen weit verbreiteten Sprachen. Weitere Informationen zu JSON finden Sie unter diesem Link:

https://wiki.selfhtml.org/wiki/JavaScript/JSON

Der nächste Abschnitt beschreibt JSON-Objekte, die für Anfragen erforderlich sind oder in der Antwort zurückgegeben werden.

Hinweis: Der JSON-String kann Sonderzeichen enthalten und muss daher auch Base64-codiert sein. Andernfalls kann es zu Übertragungsproblemen kommen.

CustomerHistory

KeyFormatCNDDescription

CanceledOrderAmount

n..10

O

Gesamtbetrag in Cent der in den letzten 2 Jahren stornierten Bestellungen

CanceledOrderCount

n..3

O

Anzahl der vom Kunden in den letzten 2 Jahren aufgegebenen und stornierten Bestellungen

FirstOrderDate

ans..10

O

Datum der ersten Kundenbestellung im Format TT/MM/JJJJ

FraudAlertCount

n..3

O

Anzahl der Betrugsmeldungen bezüglich Kundenbestellungen in den letzten 2 Jahren

LastOrderDate

ans..10

O

Datum der letzten Kundenbestellung im Format TT/MM/JJJJ

PaymentIncidentCount

n..3

O

Anzahl der Zahlungsvorfälle im Zusammenhang mit Kundenbestellungen in den letzten 2 Jahren

RefusedManyTimesOrderCount

n..3

O

Anzahl der Bestellungen, deren Ratenzahlung in den letzten 2 Jahren abgelehnt wurde

UnvalidatedOrderCount

n..3

O

Anzahl der in der Validierungsphase abgelehnten Bestellungen in den letzten 2 Jahren

ValidatedOneTimeOrderCount

n..3

O

Anzahl der Bestellungen, die in den letzten 2 Jahren in 1 Rate bezahlt wurden

ValidatedOrderCount

n..3

O

Anzahl der in den letzten 2 Jahren validierten Bestellungen

ClientIpAddressRecurrence

n..3

O

Wiederholung der Kunden-IP-Adresse in den letzten 2 Jahren

OngoingLitigationOrderAmount

n..10

O

Laufende noch nicht beigelegte Streitwerte

PaidLitigationOrderAmount24Month

n..10

O

Betrag der in den letzten 2 Jahren beigelegten Rechtsstreitigkeiten

ScoreSimulationCount7Days

n..3

O

Anzahl der simulierten Scores in den letzten 7 Tagen

Schema von CustomerHistory

1
{
2
"$schema": "http://json-schema.org/draft-07/schema#",
3
"$id": "https://www.computop-paygate.com/schemas/merchantCustomerHistory.json",
4
"title": "Merchant Customer History",
5
"description": "Merchant Customer History Data",
6
"type": "object",
7
"properties": {
8
"firstOrderDate": {
9
"type": ["string", "null"],
10
"minLength": 10,
11
"maxLength": 10
12
},
13
"lastOrderDate": {
14
"type": ["string", "null"],
15
"minLength": 10,
16
"maxLength": 10
17
},
18
"canceledOrderAmount": {
19
"type": ["integer", "null"]
20
},
21
"canceledOrderCount": {
22
"type": ["integer", "null"]
23
},
24
"fraudAlertCount": {
25
"type": ["integer", "null"]
26
},
27
"paymentIncidentCount": {
28
"type": ["integer", "null"]
29
},
30
"refusedManyTimesOrderCount": {
31
"type": ["integer", "null"]
32
},
33
"unvalidatedOrderCount": {
34
"type": ["integer", "null"]
35
},
36
"validatedOneTimeOrderCount": {
37
"type": ["integer", "null"]
38
},
39
"validatedOrderCount": {
40
"type": ["integer", "null"]
41
},
42
"clientIpAddressRecurrence": {
43
"type": ["integer", "null"]
44
},
45
"ongoingLitigationOrderAmount": {
46
"type": ["integer", "null"]
47
},
48
"paidLitigationOrderAmount24Month": {
49
"type": ["integer", "null"]
50
},
51
"scoreSimulationCount7Days": {
52
"type": ["integer", "null"]
53
}
54
},
55
"additionalProperties": false
56
}

TravelDetails

KeyFormatCNDDescription

Insurance

ans..30

O

Vom Kunden gewählte Art der Zusatzversicherung.

Hängt vom Händler ab.

Traveltype

ans..30

O

Art der Flüge:

- Unknown: unbekannt

- OneWay: Einweg

  • TwoWay: Hin- und Rückflug

  • Multiple: mehrere Ziele

DepartureDate

ans..16

C

Pflicht für Reiseveranstalter, optional für alle anderen: Startdatum im Format: TT/MM/JJJJ HH:MM

ReturnDate

ans..30

C

Pflicht für Reiseveranstalter, optional für alle anderen: Rückreisedatum im Format: TT/MM/JJJJ HH:MM

DestinationCountry

ans..2

C

Pflicht für Reiseveranstalter, optional für alle anderen: Alpha-2 ISO-Code des Ziellandes

TicketCount

n..3

O

Anzahl der Tickets

TravellerCount

n..3

C

Pflicht für Reiseveranstalter, optional für alle anderen: Anzahl der Passagiere

travelClass

ans..16

O

Art der gewählten Klasse:

- unbekannt

- Economy

- PremiumEconomy

- Business

- First

- andere

OwnTicket

n1

O

Indikator zur Erkennung, ob der Inhaber der zur Finanzierung der Reise verwendeten Kreditkarte teilnimmt:

1 = wahr

0 = falsch

MainDepartureCompany

ans..3

O

One-Way-Flug der Fluggesellschaft

TravellerPassportList

array

O

Informationen zu den Reisepässen des/der Reisenden

Array of TravellerPassport (siehe JSON-Objekt: TravellerPassport)

DepartureAirport

ans..3

O

IATA-Code des Abflughafens

ArrivalAirport

ans..3

O

IATA-Code des Ankunftsflughafens

DiscountCode

ans..30

O

Rabattcode

LuggageSupplement

ans..30

O

Gepäckzuschlag

ModificationCancellation

n1

O

Änderungsstornierung.

1 = wahr

0 = falsch

TravellerPassport

KeyFormatCNDDescription

ExpirationDate

ans..10

O

Ablaufdatum des Reisepasses im Format TT/MM/JJJJ

IssuanceCountry

ans..2

O

Alpha-2-ISO-Code des Ausstellungslandes des Reisepasses

Schema von TravelDetails

1
{
2
"$schema": "http://json-schema.org/draft-07/schema#",
3
"$id": "https://www.computop-paygate.com/schemas/travelDetails.json",
4
"title": "Travel Details",
5
"description": "Travel Details Data",
6
"type": "object",
7
"properties": {
8
"insurance": {
9
"type": ["string", "null"],
10
"maxLength": 30
11
},
12
"travelType": {
13
"type": ["string", "null"],
14
"maxLength": 30
15
},
16
"departureDate": {
17
"type": ["string", "null"],
18
"minLength": 16,
19
"maxLength": 16
20
},
21
"returnDate": {
22
"type": ["string", "null"],
23
"minLength": 16,
24
"maxLength": 16
25
},
26
"destinationCountry": {
27
"type": ["string", "null"],
28
"minLength": 2,
29
"maxLength": 2
30
},
31
"ticketCount": {
32
"type": ["integer", "null"]
33
},
34
"travellerCount": {
35
"type": ["integer", "null"]
36
},
37
"travelClass": {
38
"type": ["string", "null"],
39
"enum": ["Unknown", "Economy", "PremiumEconomy", "Business", "First", "Others"],
40
"maxLength": 16
41
},
42
"ownTicket": {
43
"type": ["integer", "null"],
44
"enum": [1, 0]
45
},
46
"mainDepartureCompany": {
47
"type": ["string", "null"],
48
"maxLength": 3
49
},
50
"travellerPassportList": {
51
"type": "array",
52
"items": {
53
"type": ["object", "null"],
54
"properties": {
55
"expirationDate": {
56
"type": ["string", "null"],
57
"minLength": 10,
58
"maxLength": 10
59
},
60
"issuanceCountry": {
61
"type": ["string", "null"],
62
"minLength": 2,
63
"maxLength": 2
64
}
65
}
66
}
67
},
68
"departureAirport": {
69
"type": ["string", "null"],
70
"minLength": 3,
71
"maxLength": 3
72
},
73
"arrivalAirport": {
74
"type": ["string", "null"],
75
"minLength": 3,
76
"maxLength": 3
77
},
78
"discountCode": {
79
"type": ["string", "null"],
80
"maxLength": 30
81
},
82
"luggageSupplement": {
83
"type": ["string", "null"],
84
"maxLength": 30
85
},
86
"modificationCancellation": {
87
"type": ["integer", "null"],
88
"enum": [1, 0]
89
}
90
},
91
"additionalProperties": false
92
}

StayDetails

KeyFormatCNDDescription

Company

ans..50

O

Reeder/Betreiber/Hotelkette

Destination

ans..50

O

Zielstadt

NightNumber

n..3

O

Anzahl der Übernachtungen

RoomRange

n..3

O

Zimmerbereich

Schema von StayDetails

1
{
2
"$schema": "http://json-schema.org/draft-07/schema#",
3
"$id": "https://www.computop-paygate.com/schemas/stayDetails.json",
4
"title": "Stay Details",
5
"description": "Stay Details Data",
6
"type": "object",
7
"properties": {
8
"company": {
9
"type": ["string", "null"],
10
"maxLength": 50
11
},
12
"destination": {
13
"type": ["string", "null"],
14
"maxLength": 50
15
},
16
"nightNumber": {
17
"type": ["integer", "null"]
18
},
19
"roomRange": {
20
"type": ["integer", "null"]
21
}
22
},
23
"additionalProperties": false
24
}

ProductDetails

KeyFormatCNDDescription

Category1

ans..30

O

Produktkategorienummer 1

Category2

ans..30

O

Produktkategorienummer 2

Category3

ans..30

O

Produktkategorienummer 3

Schema von ProductDetails

1
{
2
"$schema": "http://json-schema.org/draft-07/schema#",
3
"$id": "https://www.computop-paygate.com/schemas/productDetails.json",
4
"title": "Product Details",
5
"description": "Product Details Data",
6
"type": "object",
7
"properties": {
8
"category1": {
9
"type": ["string", "null"],
10
"maxLength": 30
11
},
12
"category2": {
13
"type": ["string", "null"],
14
"maxLength": 30
15
},
16
"category3": {
17
"type": ["string", "null"],
18
"maxLength": 30
19
}
20
},
21
"additionalProperties": false
22
}

AdditionalFields

KeyFormatCNDDescription

Index

integer

M

Feldindex

Value

ans..10

M

Feldwert

ValueType

ans..1

M

Typ des Feldes

Mögliche Werte "N" (numerisch), "T" (Text)

Schema von AdditionalFields

1
{
2
"$schema": "http://json-schema.org/draft-07/schema#",
3
"$id": "https://www.computop-paygate.com/schemas/additionalFields.json",
4
"title": "Product Details",
5
"description": "Additional Fields Data",
6
"type": "array",
7
"maxItems": 20,
8
"items": [{
9
"index": {
10
"type": ["integer", "null"]
11
},
12
"value": {
13
"type": ["string", "null"],
14
"maxLength": 10
15
},
16
"fieldType": {
17
"type": ["string", "null"],
18
"maxLength": 1
19
}
20
}],
21
"additionalProperties": false
22
}

Anfragebeispiel

Rohanfrage

merchantid=BNP_DEMO_AXEPTA&RefNr=xyz512&Date=17/04/2023&ActivationDelay=2&MerchantIDExt=38&PayType=7377&Currency=EUR&Language=fr-FR&CustomerID=340&LastName=Doe&FirstName=John&Salutation=Mr&MaidenName=Johns&DateOfBirth=1991-10-22&PlaceOfBirth=96050&MobileNr=0123456789&Email=test@&AddrStreet=Rosental 1&AddrStreet2=Alexander Platz&AddrZIP=75008&AddrCity=Paris&AddrCountryCode=FR&PersonID=40919740A&Channel=DESKTOP&DeliveryChannel=STD&NumberArticles=3&Amount=55000&Fee=550&Discount=300&shAmount=400&sdStreet=Heiligstrasse 9&sdStreet2=Willy Brandt Platz&sdCity=Paris&sdZip=75008&sdCountryCode=FR&CustomerHistory=eyJmaXJzdE9yZGVyRGF0ZSI6IjExLzEwLzIwMjAiLCJsYXN0T3JkZXJEYXRlIjoiMTUvMDcvMjAyMSIsImNhbmNlbGVkT3JkZXJBbW91bnQiOjAsImNhbmNlbGVkT3JkZXJDb3VudCI6MCwiZnJhdWRBbGVydENvdW50IjowLCJwYXltZW50SW5jaWRlbnRDb3VudCI6NSwicmVmdXNlZE1hbnlUaW1lc09yZGVyQ291bnQiOjAsInVudmFsaWRhdGVkT3JkZXJDb3VudCI6MCwidmFsaWRhdGVkT25lVGltZU9yZGVyQ291bnQiOjAsInZhbGlkYXRlZE9yZGVyQ291bnQiOjEsImNsaWVudElwQWRkcmVzc1JlY3VycmVuY2UiOjMsIm9uZ29pbmdMaXRpZ2F0aW9uT3JkZXJBbW91bnQiOjAsInBhaWRMaXRpZ2F0aW9uT3JkZXJBbW91bnQyNE1vbnRoIjowLCJzY29yZVNpbXVsYXRpb25Db3VudDdEYXlzIjowfQ==&TravelDetails=eyJkZXBhcnR1cmVEYXRlIjpudWxsLCJyZXR1cm5EYXRlIjpudWxsLCJkZXN0aW5hdGlvbkNvdW50cnkiOiJTUCIsInRpY2tldENvdW50IjoyLCJ0cmF2ZWxsZXJDb3VudCI6MiwidHJhdmVsQ2xhc3MiOiJFY29ub215Iiwib3duVGlja2V0IjoxLCJtYWluRGVwYXJ0dXJlQ29tcGFueSI6IkVSRyIsImRlcGFydHVyZUFpcnBvcnQiOiJGUkEiLCJhcnJpdmFsQWlycG9ydCI6IkJBUiIsImRpc2NvdW50Q29kZSI6IjEyMzQ1NiIsImx1Z2dhZ2VTdXBwbGVtZW50Ijoibm9pZGVhIix0cmF2ZWxsZXJQYXNzcG9ydExpc3Q6W3siZXhwaXJhdGlvbkRhdGUiOiIxMi8wNS8yMDI5IiwiaXNzdWFuY2VDb3VudHJ5IjoiRlIifSx7ImV4cGlyYXRpb25EYXRlIjoiMTUvMDgvMjAyOSIsImlzc3VhbmNlQ291bnRyeSI6IkRFIn1dfQ==&StayDetails=eyJjb21wYW55IjoiQk5CIiwiZGVzdGluYXRpb24iOiJCYXJjZWxvbmEiLCJuaWdodE51bWJlciI6MTAsInJvb21SYW5nZSI6MX0=&ProductDetails=eyJjYXRlZ29yaWUxIjoicHJlbWl1bSIsImNhdGVnb3JpZTIiOiJwcmVtaXVtIiwiY2F0ZWdvcmllMyI6InByZW1pdW0ifQ==&AdditionalFields=eyJhZGRpdGlvbmFsRmllbGRzIjpbeyJpbmRleCI6IjEiLCJ2YWx1ZSI6IjgiLCJmaWVsZFR5cGUiOiJOIn0seyJpbmRleCI6IjIiLCJ2YWx1ZSI6IjciLCJmaWVsZFR5cGUiOiJOIn0seyJpbmRleCI6IjMiLCJ2YWx1ZSI6IjYiLCJmaWVsZFR5cGUiOiJOIn0seyJpbmRleCI6IjEiLCJ2YWx1ZSI6IjIwMjItMDgtMTEiLCJmaWVsZFR5cGUiOiJUIn0seyJpbmRleCI6IjIiLCJ2YWx1ZSI6InByaXZhdGUgdmVoaWNsZSIsImZpZWxkVHlwZSI6IlQifSx7ImluZGV4IjoiMyIsInZhbHVlIjoiTWVyY2VkZXMiLCJmaWVsZFR5cGUiOiJUIn1dfQ==&Homepage=https://computop.com/uk/&URLBack=https://computop.com/de/&URLSuccess=https://floapay.readme.io/reference/pr%C3%A9sentation&URLFailure=https://floapay.readme.io/reference/v1stored-payment-methodspost

CustomerHistory aus Base64 dekodiert

{"firstOrderDate":"11/10/2020","lastOrderDate":"15/07/2021","canceledOrderAmount":0,"canceledOrderCount":0,"fraudAlertCount":0,"paymentIncidentCount":5,"refusedManyTimesOrderCount":0,"unvalidatedOrderCount":0,"validatedOneTimeOrderCount":0,"validatedOrderCount":1,"clientIpAddressRecurrence":3,"ongoingLitigationOrderAmount":0,"paidLitigationOrderAmount24Month":0,"scoreSimulationCount7Days":0}

TravelDetails aus Base64 dekodiert

{"departureDate":null,"returnDate":null,"destinationCountry":"SP","ticketCount":2,"travellerCount":2,"travelClass":"Economy","ownTicket":1,"mainDepartureCompany":"ERG","departureAirport":"FRA","arrivalAirport":"BAR","discountCode":"123456","luggageSupplement":"noidea",travellerPassportList:[{"expirationDate":"12/05/2029","issuanceCountry":"FR"},{"expirationDate":"15/08/2029","issuanceCountry":"DE"}]}

StayDetails aus Base64 dekodiert

{"company":"BNB","destination":"Barcelona","nightNumber":10,"roomRange":1}

ProductDetails aus Base64 dekodiert

{"categorie1":"premium","categorie2":"premium","categorie3":"premium"}

AdditionalFields aus Base64 dekodiert

{"additionalFields":[{"index":"1","value":"8","fieldType":"N"},{"index":"2","value":"7","fieldType":"N"},{"index":"3","value":"6","fieldType":"N"},{"index":"1","value":"2022-08-11","fieldType":"T"},{"index":"2","value":"private vehicle","fieldType":"T"},{"index":"3","value":"Mercedes","fieldType":"T"}]}

Paygate

Documentation (EN)

Dokumentation (DE)

Paygate Status