Allgemeine Hinweise

Zweck

Das Computop Das 

Beachten Sie bitte, dass die Computop die 

Beachten Sie bitte, dass jederzeit ohne vorherige Ankündigung neue Datensatz-Typen hinzugefügt werden können.

Unterstützte Zahlungssysteme, Zahlungsmethoden und Acquirer

System

Prozessor / Acquirer / Gateway

Kreditkarten

American Express

American Express (EPA & GRRCN)

AIBMS
AsiaPay
BNP
ConCardis
Elavon (EU & US)
EVO (GICC)
FirstData
iCard
JPMorgan Chase (Salem and Tampa)
Lufthansa AirPlus
OmniPay (EMS, Global Payments, Paysquare,Payvision)
Paynetics
Payone
SIX Payment Services
Vantiv
Wirecard
Worldline

Alternativen

AfterPay/PayByBill

AfterPay/arvato

PayPal

PayPal

PPRO

Hinweis: Bei PPRO werden auch fehlgeschlagene Payments im Settlement-File ausgeweisen. An folgenden Merkmalen kann das fehlgeschlagene Payment erkannt werden: Die fehlerhaften Transaktionen werden immer mit dem Transaction Date = 01.01.1970 01:00:00, Amount Capture = 0 und der fixed_fee ausgewiesen.

Abruf

Händler können die 

Abruf

Händler können die Computop Settlement-Files nach eigenem Ermessen von einem Computop SFTP-Zugang abrufen. Zur Konfiguration und für die Zugangsdaten wenden Sie sich bitte an den Computop Helpdesk: helpdesk@computop.com.

Dateiaufbau

Jedes Settlement-File gliedert sich in einen Header-Bereich, einen oder mehrere Detail-Datensätze sowie einen Gesamtsummen-Datensatz. Die Codierung für die Zeilenwechsel ist auf Händlerebene konfigurierbar. Einige Felder können Werte variabler Länge enthalten. Wenn keine Größen angegeben sind, gilt keine Feldgrößenbegrenzung.

Notation der Datenformate

a

alphabetische Zeichen A-Z, a-z

n

numerische Ziffern, 0-9

an

alphanumerische Zeichen A-Z, a-z, 0-9

ans

alphanumerisch und Sonderzeichen

ns

numerisch und Sonderzeichen

3

feste Länge mit 3 Stellen/Zeichen

..17

variable Länge mit bis zu maximal 3 Stellen/Zeichen. Die Mindestlänge ist durch die spezifischen Anforderungen des Datenelements selbst vorgegeben, aber sollte mindestens 1 Zeichen betragen.

tstp

Verzeichnis der Datenelemente

Alle Datenelemente des Computop des 

ACQUIRER_FEE

Gebühren für die Dienstleistungen des Acquirers

AUTHORIZATION_AMOUNT

Autorisierter Betrag in der kleinsten Einheit der Transaktionswährung (z.B. EUR Cent)

CAPTURE_DATE

Datum und Uhrzeit, wann eine Transaktion vom Aqcuirer / Zahlungssystem zum Settlement akzeptiert wurde im Format <DD.MM.YYYY hh:mm:ss>. Wenn die Zeit nicht angegeben ist, wird sie auf ‘00:00:00’ gesetzt.

COUNTER

Zähler zur Gewährleistung eindeutiger Dateinamen (linksbündig, mit Nullen aufgefüllt)

CUSTOMER_INFO

Konstruiertes Feld mit spezifischen kundenbezogenen Informationen je nach Zahlungsmethode. Unterfelder sind getrennt durch ‘#’ (U+0023) (Doppelkreuz).

EXTENDED_INFO

Konstruiertes Feld mit zusätzlichen Informationen, die je nach Zahlungsmethode verfügbar sind. Unterfelder sind getrennt durch ‘#’ (U+0023) (Doppelkreuz).

FILE_CREATION_DATE

Datum, wann das Computop Settlement-File erzeugt wurde, <DDMMYYYY>.

INTERCHANGE_FEE

Vom Kartenaussteller berechnete Gebühren

MERCHANT_ID

Computop Händleridentifikation

ORDER_DESCRIPTION

Eine Beschreibung der Bestellung, zu der die Zahlung gehört

PAYMENT_CREATION_DATE

Datum und Uhrzeit, wann die Zahlung angelegt wurde, <DD.MM.YYYY hh:mm:ss>.

PROCESSING_FEE

Gebühren für die Dienstleistungen der Prozessoren (PSP, Gateway, Netzbetreiber)

RECORD_COUNT

Gesamtzeilenanzahl  im Bereich der detaillierten Datensätze

RECORD_TYPE

Header-Datensatz

Kennzeichnet den betreffenden Eintrag als Header-Datensatz, Wert ‘100’.

Detail-Datensatz

Bezeichner der bestimmten Zahlungsmethode und Art des Buchungskonteneintrags (z.B. Belastung und Gutschrift). Gebühren der Kunden werden als Belastungen und Zahlungen an Kunden als Gutschriften gekennzeichnet.

Gesamtsummen-Datensatz

Kennzeichnet den betreffenden Eintrag als Gesamt-Datensatz, Wert ‘900’.

REFERENCE_NUMBER

Die Referenznummer ist eine eindeutige Zeichenkette des Händlers zum Identifizieren einer Zahlung (z.B. Rechnungsnummer, Ticket-Nummer usw.). Sie wird normalerweise an das Zahlungssystem weitergeleitet und in den Abrechnungsdaten / Berichten wiedergegeben, so dass ein Abgleich mit eingereichten Transaktionen möglich ist.

SCHEME_FEE

Von der Kartenorganisation berechnete Gebühr

STATUS

Der Status der Zahlung, derzeit immer ‘OK’

TOTAL_AMOUNT

Summe aller Transaktionsbeträge (Gutschriften werden ebenfalls für den Gesamtbetrag summiert) im Bereich der Detail-Datensätze in der kleinsten Einheit der Transaktionswährung (z.B. EUR Cent)

TRANSACTION_AMOUNT

Vom Zahlungssystem verarbeiteter Betrag in der kleinsten Einheit der Transaktionswährung (z.B. EUR Cent)

TRANSACTION_CURRENCY

Dreistelliger Währungscode gemäß ISO 4217 für die Währung, in der die Transaktion verarbeitet wurde

TRANSACTION_ID

Dateinamen

Namenskonvention:         <MERCHANT_ID>#<FILE_CREATION_DATE>#<COUNTER>.ctsf

Nr.

Element

Format

Beispiel

1

MERCHANT_ID

an..20

ACME01

2

FILE_CREATION_DATE

N8

20201014

3

COUNTER

N3

001

Dateinamensbeispiel:            ACME01#20201014#001.ctsf

Datensätze

Header-Datensatz

1

RECORD_TYPE

N3

100

2

MERCHANT_ID

An..30

ACME01

3

DATE

N8

20200424

4

VERSION

An..4

1.0

Detail-Datensatz

Version 1.0

Nr.

Element

Format

Beispiel

1

RECORD_TYPE

N3

510

2

TRANSACTION_ID

An..64

890_XUoqyBWuGw

3

TRANSACTION_CURRENCY

A3

EUR

4

AUTHORIZATION_AMOUNT

N..12

789

5

TRANSACTION_AMOUNT

N..12

700

6

PAYMENT_CREATION_DATE

Tstp

20.04.2020 14:18:23

7

STATUS

An..

OK

8

REFERENCE

An..30

qArxtOE4w3FsSX5

9

CUSTOMER_INFO

Ans..160

4111xxxxxxxx9996#VISA

10

CAPTURE_DATE

Tstp

24.04.2020 00:00:00

11

ORDER_DESCRIPTION

Ans..384

Monatliche Abonnementgebühr für ACME TV

12

EXTENDED_INFO

Ans..

1.875#EUR

Version 1.1 [1]

1

N3

510

2

TRANSACTION_ID

An..64

890_XUoqyBWuGw

3

TRANSACTION_CURRENCY

A3

EUR

4

AUTHORIZATION_AMOUNT

N..12

789

5

TRANSACTION_AMOUNT

N..12

700

6

PAYMENT_CREATION_DATE

Tstp

20.04.2020 14:18:23

7

STATUS

An..

OK

8

REFERENCE

An..30

qArxtOE4w3FsSX5

9

CUSTOMER_INFO

Ans..160

4111xxxxxxxx9996#VISA

10

CAPTURE_DATE

Tstp

24.04.2020 00:00:00

11

ORDER_DESCRIPTION

Ans..384

Monatliche Abonnementgebühr für ACME TV

12

EXTENDED_INFO

Ans..20

1.875#EUR

13

INTERCHANGE_FEE

Ans..20

1.875#13#EUR

14

SCHEME_FEE

Ans..20

1.875#13#EUR

15

ACQUIRER_FEE

Ans..20

1.875#13#EUR

16

PROCESSING_FEE

Ans..20

1.875#13#EUR

Version 1.2 [2]

1

N3

510

2

MERCHANT_ID

An..20

ACME01

3

TRANSACTION_ID

An..64

890_XUoqyBWuGw

4

TRANSACTION_CURRENCY

A3

EUR

5

AUTHORIZATION_AMOUNT

N..12

789

6

TRANSACTION_AMOUNT

N..12

700

7

PAYMENT_CREATION_DATE

Tstp

20.04.2020 14:18:23

8

STATUS

An..

OK

9

REFERENCE

An..30

qArxtOE4w3FsSX5

10

CUSTOMER_INFO

Ans..160

4111xxxxxxxx9996#VISA

11

CAPTURE_DATE

Tstp

24.04.2020 00:00:00

12

ORDER_DESCRIPTION

Ans..384

Monatliche Abonnementgebühr für ACME TV

13

EXTENDED_INFO

Ans..20

1.875#EUR

14

INTERCHANGE_FEE

Ans..20

1.875#13#EUR

15

SCHEME_FEE

Ans..20

1.875#13#EUR

16

ACQUIRER_FEE

Ans..20

1.875#13#EUR

17

PROCESSING_FEE

Ans..20

1.875#13#EUR

Version 1.3 [3]

1

N3

510

2

TRANSACTION_ID

An..64

890_XUoqyBWuGw

3

TRANSACTION_CURRENCY

A3

EUR

4

AUTHORIZATION_AMOUNT

N..12

789

5

TRANSACTION_AMOUNT

N..12

700

6

PAYMENT_CREATION_DATE

Tstp

20.04.2020 14:18:23

7

STATUS

An..

OK

8

REFERENCE

An..30

qArxtOE4w3FsSX5

9

CUSTOMER_INFO

Ans..160

4111xxxxxxxx9996#VISA

10

CAPTURE_DATE

Tstp

24.04.2020 00:00:00

11

ORDER_DESCRIPTION

Ans..384

Monatliche Abonnementgebühr für ACME TV

12

EXTENDED_INFO

Ans..20

1.875#EUR

13

PAYOUT_ID

Ans..

1586789310000001

14

PAYOUT_DATE

N8

20.04.2020

PAYOUTPAYOUT-Elemente sind verfügbar für:

• AIBMS
• AirPlus
• Amex (EPA)
• PayOne
• Concardis
• Elavon
• Klarna
• PPRO
• Wirecard

Version 1.4 [4]

Wie V1.0, aber mit Settlement und DCC-Daten zusätzlich in EXTENDED_INFO:

<EXTENDED_INFO>#
settlementamount=<SETTLEMENT_AMOUNT>#
settlementcurrency=<SETTLEMENT_CURRENCY>#
dccRate=<DCC_RATE>#
dccMargin=<DCC_MARGIN>

Ohne DCC werden nur Settlement-Informationen bereitgestellt.

[1] IC++ Elemente sind nur verfügbar, wenn sie von der Acquiring Bank bereitgestellt werden
[2] IC++ Elemente sind nur verfügbar, wenn sie von der Acquiring Bank bereitgestellt werden
[3] PAYOUT Elemente sind nur verfügbar, wenn sie von der Acquiring Bank bereitgestellt werden
[4] Settlement und DCC-Elemente sind nur verfügbar, wenn sie von der Acquiring Bank bereitgestellt werden

Gesamtsummen-Datensatz

Nr.

Element

Format

Beispiel

1

RECORD_TYPE

N3

900

2

RECORD_COUNT

N..5

36

3

TOTAL_AMOUNT

N..12

798960

Zusätzliche Informationen

Feld "Customer_Info"

Zahlungsmethode

Aufbau / Anmerkung

Beispiel

AFTERPAY

[Customer_ID]

8902265613

ALIPAY grenzüberschreitend

-

ALIPAY heimisch

[Customer_ID]

John.doe@gmail.com

AMAZON PAY

[Customer_Name]#
[Customer_E-Mail]

John Doe#
john.doe@gmail.com

BARZAHLEN

[Customer_E-Mail]#
[Shop_URL]

john.doe@gmx.de

BILLPAY

[Merchant_Customer_ID]#
[Billpay_Customer_ID]#
[Claim_ID]#
[Activation_Date]#
[Due_Date]#
[Customer_Country]

184614#
836758#
1092900#
08.09.2020 00:00:00#
24.09.2020 00:00:00#
DEU

CHINAPAY

-

CREDIT CARD

Maskierte Kartennummer oder Karten-Token und Kartenmarke: [0000xxxxxxxx0000]#
[Brand]

4111xxxxxxxx9996#
Visa

DIRECT DEBIT

[Account_Holder]#
[Account_Number]#
[Bank_ Code]#
[Bank]

oder

[Account_Holder]#
[IBAN]#
[BIC]#
[Bank]

oder

[IBAN]#
[BIC]

John Doe#
10602437#
205950#
Barclays

oder

John Doe#
GB58BARC20595010602437#
BARCGB22#
Barclays

oder

GB58BARC20595010602437#
BARCGB22

IDEAL

[Account_Holder]#
[IBAN]#
[BIC]#
[Bank]

John Doe#
NL12RABO0388375809#
RABONL2U#
Rabobank

KLARNA

[OCR_No]#
[Invoice_No]

1834143680436#
519072450221831988

LIMONETIK

[Customer_E-Mail]

john.doe@gmail.com

PAGBRASIL

[Customer_Name]#
[Customer_E-Mail]

John Doe#
john.doe@bol.com.br

PAYDIREKT

[Customer_BankID]

eba960e5-dd37-4d82-b479-ae3d28205994

PAYPAL

[Payer_ID]#
[Payer]

A59XV256BZ#
john.doe@gmx.de

PAYU

[Customer_Name]#
[Customer_E-Mail]

MAGDALENA WITKOWSKA#
magdalena.witkowska@interia.pl

PPRO

-

SOFORT (KLARNA SOFORT)

siehe DIRECT DEBIT

siehe DIRECT DEBIT

TRUSTLY

[Customer_Country]#
[Customer_First_Name]#
[Customer_Last_Name]#

SE#
John#
Doe

Feld "Extended_Info"

Zahlungsmethode

Aufbau / Anmerkung

Beispiel

AFTERPAY

[Invoice_No]

61075095

ALIPAY grenzüberschreitend

[Merchant_Discount]

ALIPAY heimisch

[Merchant_Discount_Rate]#
[Merchant_Discount]

0.014#
9.87

AMAZON PAY

[SellerOrderId]#
[SellerReferenceId]#
[AmazonOrderReferenceId]#
[AmazonTransactionId]#
[TotalTransactionFee]

BARZAHLEN

[Merchant_Discount]#
[VAT]

2.469#
0.46911

BILLPAY

[Portal_ID]#
[Merchant_Discount_Type]#
[Merchant_Discount_Rate]#
[Merchant_Discount]

4151#
3#
0.0135#
2.07

CHINAPAY

[Merchant_Discount]#[Currency]

CREDIT CARD [5]

[Merchant_Discount_Rate]#
[Merchant_Discount]#
[Currency]

CHARGEBACK

[ARN]#
[Reason_Code]#
[Status]

RETRIEVAL REQUEST

[ARN]#
[Reason_Code]#
[Status]

TC40/SAFE

[ARN]#
[Code]#

1.875#
1.95#
EUR

74527646319021051645048#
0350#
MI1

74527646319021051645048#
0350#
MI1

74627546887030655470117#
6

Feld "Extended_Info"

[

DIRECT DEBIT

[PmtInfId]

oder

[Mandate_ID]#[IP address]

Chargeback [6]

[reasonCode]#[trigger]#[token]

reasonCode -

• 4-stelliger SEPA reason code

trigger -

• “CHB” = Chargeback
• “B1”..”B3” = CB nach 1., 2. oder 3. Neuversuch

token -

• ACT - CB wurde vom Kunden ausgelöst
• RFND - CB wurde vom Händler ausgelöst
• FRM - Formatfehler
• NSF - unzureichend

5e736c2d718843149b71e3439b292dfe

reasonCode=MD17#trigger=CHB#token=NSF

IDEAL

NL#
[IP address]

NL#
82.151.44.149

KLARNA

[Merchant_Discount_Type]=[Merchant_Discount];[VAT_AMOUNT]#[Merchant_Discount_Type]=[Merchant_Discount];[VAT_AMOUNT]#...

oder

[Merchant_Discount]

PURCHASE_FEE_PERCENTAGE=4.84;0.92

0.00

LIMONETIK

“paytype=“[Brand]#
“PaymentOrderId=”[OrderId]#
“fee=”[Fee]

FEE

“paytype=“[Brand]#
“PaymentOrderId=”[OrderId]#
“type=“[Type]

paytype=FacilyPay 3xCB#
PaymentOrderId=465224938699#
fee=2.64

paytype=FacilyPay 3xCB#
PaymentOrderId=162741148844#
type=Charge

PAGBRASIL

[Pymt_Mthd]#
[Settled_Amount]#
[Merchant_Discount]#
[Pymt_Date]

CHARGEBACK

[Pymt_Mthd]#
[Settled_Amount]#
[CB_Date]#
[Pymt_Date]

Boleto bancário#
129.9#
22.9#
04/15/2020

Credit card#
0#
16/05/20#
03/09/2020

PAYDIREKT

[correlationId]#
[endToEndReferenceNumber]#
[paymentInformationId]

113811779-00000001#
PD29AC32139C0F40F4B2541287900138D6#
GIMBPROVDR20161201000000021579

PAYPAL

[Merchant_Discount]#
[Currency]#
[Transaction_Type (credit / debit)]

203#
EUR#
CR

PAYU

[Order_ID]#
[Trans_ID]#
[Merchant_Discount]

[P6061489]#
[608365647]#
[1.25]

PPRO

Credit
[Channel]#
[TAG]#
[Country]#
[Selling_Point]#
fixed_fee=[FIXED_FEE_AMOUNT]#
fixed_fee_currency=[FIXED_FEE_CURRENCY]#
external_fee=[EXTERNAL_FEE_AMOUNT]#
external_fee_currency=[EXTERNAL_FEE_CURRENCY]#
minimum_discount_fee=[MINIMUM_DISCOUNT_FEE_AMOUNT]#
discount_rate=[DISCOUNT_RATE]

Channel Vom Zahlungssystem oder vom Händler bereitgestellt. Das wird individuell gehandhabt, aber normalerweise nutzen wir den Wert "testchannel" für Testkonten und "livechannel" für aktive Konten.

TAG Hängt vom Zahlungssystem ab und wird vom Paygate bereitgestellt (muss mit PPRO abgesprochen werden). Das wird individuell gehandhabt. Die aktuellste Liste wird beim Integrationsprozess mit verteilt.

• ideal
• p24
• sepadirectdebit
• sofort
• yellowpay
• …
• Country Der Parameter AddrCountryCode wird in der Händleranfrage bereitgestellt

SellingPoint Vom Händler bereitgestellt

Chargeback
[Chargeback_ID]#
[Chargeback_Reason_Code]#
[Chargeback_RefNumber]

SOFORT (KLARNA SOFORT)

[Customer_ID]#
[Country]#
[Mandate_ID]#
[IP address]

9139795844#
DE#
9135762874-203185592#
78.49.133.9

TRUSTLY

[Merchant_Discount]#
[Currency]#
[Value_Date]#
[Order_ID]#
[Acc_Name]#
[Order_Type]

0.05
SEK
2020-01-30 13:28:45#
3209647863#
SWEDENESSE#
User deposit of client funds to SWEDENESSE#

[Fee Rate]#[Fee]

[5] Datensätze CB, RR und TC40/SAFE sind nur verfügbar, wenn von der Acquiring Bank bereitgestellt
[6] b4payment/SEPAexpress

Feld "Record_Type"

Datensatz

Zahlungsmethode

Transaktionstyp

510

CREDIT CARD [7]

Belastung

511

Gutschrift

512

Rückbuchung

514

Suchanfrage

517

TC40/SAFE

520

PAYPAL

Belastung

521

Gutschrift

522

Rückbuchung

710

PPRO

Belastung

711

Gutschrift

712

Rückbuchung

[7] Elemente CB, RR und TC40/SAFE sind nur verfügbar, wenn von der Acquiring Bank bereitgestellt

Beispiel