easyCredit

Logo

Info

EasyCredit ist Anbieter einer Rechnungs- und Ratenkauf-Lösung in Deutschland. Die Kalkulation aller möglichen Raten wird von easyCredit übernommen, nachdem der Kunde zu easyCredit weitergeleitet wurde.

Typ

Zahlungen per Rechnungs- und Ratenkauf

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

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 Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Der Minimal- und Maximalbetrag bei easyCredit sind 200-5000 €.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

Term

n..2

O

Laufzeit in Monaten. Hier kann ggf. eine vom Kunden bereits in der Beispielrechnung gewählte Laufzeit vorbelegt werden.

EventToken

enum

M

Definiert die bei easyCredit auszuführende Anfrage:

<INT> zur Initialisierung eines Vorgangs

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.

Personendaten

Hinweis: Werden Personendaten angegeben, so sind diese als Gruppe vollständig zu übermitteln.

Salutation

a..15

C

Anrede HERR oder FRAU

FirstName

ans..50

C

Vorname

LastName

ans..50

C

Nachname

DateOfBirth

dttm

C

Geburtsdatum im Format JJJJ-MM-TT

Beschäftigungsdaten

Hinweis: Werden Beschäftigungsdaten angegeben, so sind diese als Gruppe vollständig zu übermitteln.

Employment

enum

C

Beschäftigung des Kunden. Mögliche Werte sind:

EMPLOYEE

EMPLOYEE_PUBLIC_SECTOR

WORKER

CIVIL_SERVANT

RETIREE

SELF_EMPLOYED

UNEMPLOYED

OTHER

MonthlyNetIncome

n..12

C

Monatliches Nettoeinkommen des Kunden in der kleinsten Währungseinheit (z.B. EUR Cent)

Rechnungsadresse

Hinweis: Wird eine Rechnungsadresse angegeben, so muss diese vollständig übermittelt werden.

bdFirstName

ans..50

M

Vorname in der Rechnungsadresse

bdLastName

ans..50

M

Nachname in der Rechnungsadresse

bdStreet

a..50

C

Straße

bdStreetNr

ans..5

C

Hausnummer

bdAddressAddition

a..50

C

Adresszusatz

bdZip

n5

C

Postleitzahl

bdCity

ans..50

C

Stadt

bdCountryCode

a2

C

Ländercode in der Rechnungsadresse gemäß ISO 3166, zweistellig. Derzeit ist nur DE erlaubt.

Lieferadresse

Hinweis: Wird eine Lieferadresse angegeben, so muss diese vollständig übermittelt werden.

PackingStation

an..30

O

Packstation

sdFirstName

ans..50

M

Vorname in der Lieferadresse

sdLastName

ans..50

M

Nachname in der Lieferadresse

sdStreet

a..50

C

Straße

sdStreetNr

ans..5

C

Hausnummer

sdAddressAddition

a..50

C

Adresszusatz

sdZip

n5

C

Postleitzahl

sdCity

ans..50

C

Stadt

sdCountryCode

a2

C

Ländercode in der Lieferdresse gemäß ISO 3166, zweistellig. Derzeit ist nur DE erlaubt.

Kontaktdaten

Email

ans..50

M

E-Mail-Adresse des Kunden

MobileNr

ans..50

O

Mobiltelefonnummer des Kunden

Bankdaten

IBAN

ans..34

O

IBAN des Kunden

BIC

an..11

O

BIC des Kunden

Weitere Kundendaten

Phone

ans..15

O

Telefonnummer des Kunden

Title

enum

O

Titel des Kunden. Mögliche Werte sind:

<PROFDR> für Prof. Dr.

<DR> für Dr.

<PROF> für Prof.

<DRDR> für Dr. Dr.

MaidenName

ans..50

O

Geburtsname

PlaceOfBirth

ans..50

O

Geburtsort

Risikorelevante Daten

CustomerStatus

enum

O

Status des Kunden beim Webshop. Mögliche Werte sind:

<NEUKUNDE>

<BESTANDSKUNDE>

<PREMIUMKUNDE>

CustomerSince

dttm

O

Beginn der Kundenbeziehung beim Webshop im Format JJJJ-MM-TT

CustomerLoggedIn

enum

O

Flag, ob die Bestellung als registrierter Kunde mit Login oder als Gast erfolgt:

<YES> Kunde war eingeloggt

<NO> Kunde hat als Gast bestellt

NumberArticles

n..5

O

Anzahl der Produkte im Warenkorb

NumberOrders

n..10

O

Anzahl der bisherigen Bestellungen im Webshop

NegativePaymentInfo

enum

O

Negative Zahlungsinformationen zu dem Kunden. Mögliche Werte sind:

<KEINE_ZAHLUNGSSTOERUNGEN>

<ZAHLUNGSVERZOEGERUNG>

<ZAHLUNGSAUSFALL>

<KEINE_INFORMATION>

RiskArticles

enum

O

Einschätzung des Händlers, ob sich im Warenkorb mindestens ein bonitätskritischer Artikel befindet. Mögliche Werte sind:

<YES> Es befindet sich ein bonitätskritischer Artikel im Warenkorb

<NO> Es befindet sich kein bonitätskritischer Artikel im Warenkorb

Artikelliste

ArticleList

ans..1024

O

Warenkorbinformationen (inkl. Artikelnummern), zu den im Rahmen eines Ratenkaufs bestellten Artikeln. Diese Daten können in die Kreditentscheidung mit einfließen. Die Artikelliste muss im JSON-Format erstellt werden.

1
{
2
  "shoppingCartInformation": [
3
      {
4
        "productName": "Washing Machine",
5
        "quantity": 1,
6
        "price": 599.95,
7
        "manufacturer": "Siemens",
8
        "productCategory": "Household Appliances",
9
        "articleNumber": [
10
          {
11
            "numberType": "GTIN",
12
            "number": 1111111
13
          }
14
        ]
15
      }
16
    ]
17
}

Anschließend muss die im JSON-Format erstellte Artikelliste Base64 encodiert werden.

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) und 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)

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

UserData

ans..1024

O

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

CodeExt

ans..1024

O

Fehlercode von easyCredit ratenkauf, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..1024

O

Fehlertext von easyCredit ratenkauf, wenn mit Computop Helpdesk abgesprochen

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 Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

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 Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Der Minimal- und Maximalbetrag bei easyCredit sind 200-5000 €.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

EventToken

enum

M

Definiert die bei easyCredit zu stellende Anfrage:

<GET> Mit diesem EventToken werden alle Rateninformationen abgerufen.

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)

Financing

ans..1024

O

Enthält alle notwendigen Daten für eine vorherige Initialisierung. Sie werden im JSON-Format und Base64-codiert zurückgegeben.

Beispiel-JSON-Format (bereits Base64-dekodiert):

1
{
2
  "decision": {
3
    "transactionId": "EWZEN7",
4
    "deviceIdentToken": "dffedf20-21df-11ec-9621-0242ac130002",
5
    "orderValue": 2614.79,
6
    "interest": 234.56,
7
    "nominalInterest": 8.64,
8
    "effectiveInterest": 8.99,
9
    "merchantSpecificInterest": 8.99,
10
    "totalValue": 2849.35,
11
    "decisionOutcome": "POSITIVE",
12
    "numberOfInstallments": 9,
13
    "minNumberOfInstallments": 2,
14
    "maxNumberOfInstallments": 60,
15
    "installment": 302,
16
    "lastInstallment": 293.58,
17
    "firstInstallmentDate": "2023-03-20",
18
    "lastInstallmentDate": "2023-03-20",
19
    "amortizationPlanText": "string",
20
    "urlPreContractualInformation": "string",
21
    "installmentPlans": [
22
      {
23
        "totalValuePlan": 0,
24
        "interests": {
25
          "effectiveInterest": 8.99,
26
          "nominalInterest": 8.64,
27
          "interest": 234.56
28
        },
29
        "paymentPlan": {
30
          "numberOfInstallments": 9,
31
          "firstInstallmentDate": "2023-03-20",
32
          "lastInstallmentDate": "2023-03-20",
33
          "installment": 302,
34
          "lastInstallment": 293.58
35
        }
36
      }
37
    ],
38
    "mtan": {
39
      "required": true,
40
      "status": "PENDING",
41
      "remainingAttempts": 2,
42
      "successful": true,
43
      "mobilePhoneNumberInvalid": true,
44
      "skipMobilePhoneNumberValidation": true
45
    },
46
    "bankAccountCheck": {
47
      "required": false,
48
      "successful": false
49
    }
50
  },
51
  "transaction": {
52
    "financingTerm": 6,
53
    "orderDetails": {
54
      "orderValue": 2614.79,
55
      "orderId": "A1ZU560",
56
      "numberOfProductsInShoppingCart": 1,
57
      "invoiceAddress": {
58
        "address": "Beuthener Str. 25",
59
        "additionalAddressInformation": "3 OG",
60
        "zip": "90471",
61
        "city": "Nürnberg",
62
        "country": "DE",
63
        "firstName": "Ralf",
64
        "lastName": "Ratenkauf"
65
      },
66
      "shippingAddress": {
67
        "address": "Beuthener Str. 25",
68
        "additionalAddressInformation": "3 OG",
69
        "zip": "90471",
70
        "city": "Nürnberg",
71
        "country": "DE",
72
        "firstName": "Ralf",
73
        "lastName": "Ratenkauf",
74
        "packageStation": true
75
      },
76
      "shoppingCartInformation": [
77
        {
78
          "productName": "Washing Machine",
79
          "quantity": 1,
80
          "price": 599.95,
81
          "manufacturer": "Siemens",
82
          "productCategory": "Household Appliances",
83
          "articleNumber": [
84
            {
85
              "numberType": "GTIN",
86
              "number": 1111111
87
            }
88
          ]
89
        }
90
      ]
91
    },
92
    "shopsystem": {
93
      "shopSystemManufacturer": "Shopware 5.5.10",
94
      "shopSystemModuleVersion": "1.6.3"
95
    },
96
    "customer": {
97
      "gender": "MR",
98
      "firstName": "Ralf",
99
      "lastName": "Ratenkauf",
100
      "birthDate": "1949-10-17",
101
      "birthName": "string",
102
      "birthPlace": "string",
103
      "title": "PROFDR",
104
      "contact": {
105
        "email": "test@test.de",
106
        "mobilePhoneNumber": "017186397426",
107
        "phoneNumber": "01771234567",
108
        "phoneNumbersConfirmed": false
109
      },
110
      "bank": {
111
        "iban": "DE06760320009210030015",
112
        "bic": "MARKDEFFXXX"
113
      },
114
      "employment": {
115
        "employmentType": "EMPLOYEE",
116
        "monthlyNetIncome": 3000
117
      },
118
      "companyName": ""
119
    },
120
    "customerRelationship": {
121
      "customerStatus": "EXISTING_CUSTOMER",
122
      "customerSince": "2007-10-10",
123
      "orderDoneWithLogin": false,
124
      "numberOfOrders": 3,
125
      "negativePaymentInformation": "NO_INFORMATION",
126
      "riskyItemsInShoppingCart": false,
127
      "logisticsServiceProvider": "Hermes"
128
    },
129
    "consent": {
130
      "sepaMandate": true,
131
      "advertisement": true,
132
      "dataProcessing": true,
133
      "consentToActInOnwnName": true
134
    },
135
    "redirectLinks": {
136
      "urlSuccess": "https://www.google.com/search?q=easycreditSuccess",
137
      "urlCancellation": "https://www.google.com/search?q=easycreditCanceled",
138
      "urlDenial": "https://www.google.com/search?q=easycreditDenied",
139
      "urlAuthorizationCallback": "https://www.google.com/search?=ratenkaufCallback"
140
    }
141
  },
142
  "status": "OPEN"
143
}

CodeExt

ans..1024

O

Fehlercode von easyCredit ratenkauf, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..1024

O

Fehlertext von easyCredit ratenkauf, wenn mit Computop Helpdesk abgesprochen

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 Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

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 Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Der Minimal- und Maximalbetrag bei easyCredit sind 200-5000 €.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

EventToken

enum

M

Definiert die bei easyCredit auszuführende Anfrage:

<CON> Setzt einen Vorgang bei easyCredit von ZUGESAGT auf den Status BESTAETIGT. Die Zusage darf nicht länger als 30 Minuten her sein und die vorher eingeholte easyCredit-Entscheidung muss GRUEN gewesen sein.

Date

dttm

O

Datum, an dem die verkaufte Leistung/Ware geliefert wurde im Format JJJJ-MM-TT. Die Lieferung wird somit automatisch zusammen mit der Bestätigung angestoßen.

Hinweis: Für das automatische Ausführen der Lieferung muss der Händler korrekt bei Computop konfiguriert sein. Bitte wenden Sie sich Hierzu an den Computop Helpdesk.

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)

CodeExt

ans..1024

O

Fehlercode von easyCredit ratenkauf, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..1024

O

Fehlertext von easyCredit ratenkauf, wenn mit Computop Helpdesk abgesprochen

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 Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

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 Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Der Minimal- und Maximalbetrag bei easyCredit sind 200-5000 €.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

Date

dttm

O

Datum, an dem die verkaufte Leistung/Ware geliefert wurde. im Format JJJJ-MM-TT. Die Lieferung wird separat von der Bestätigung angestoßen.

Hinweis: Für das manuelle Ausführen der Lieferung muss der Händler korrekt bei Computop konfiguriert sein. Das kann auch mit dem Parameter Capture übersteuert werden. Wenden Sie sich hierzu bitte an den Computop Helpdesk.

Capture

an..6

OM

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture).

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.

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

Request

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)

CodeExt

ans..1024

O

Fehlercode von easyCredit ratenkauf, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..1024

O

Fehlertext von easyCredit ratenkauf, wenn mit Computop Helpdesk abgesprochen

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 Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

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 Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Der Minimal- und Maximalbetrag bei easyCredit sind 200-5000 €.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

Date

dttm

M

Datum, zu dem die Rückabwicklung vom Händler entgegengenommen wurde im Format JJJJ-MM-TT

Reason

enum

M

Grund für die Rückabwicklung. Mögliche Werte sind:

<WIDERRUF_VOLLSTAENDIG>

<WIDERRUF_TEILWEISE>

<RUECKGABE_GARANTIE_GEWAEHRLEISTUNG>

<MINDERUNG_GARANTIE_GEWAEHRLEISTUNG>

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.

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

Request

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)

CodeExt

ans..1024

O

Fehlercode von easyCredit ratenkauf, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..1024

O

Fehlertext von easyCredit ratenkauf, wenn mit Computop Helpdesk abgesprochen