• DeutschEnglish

Enterpay

Über Enterpay

Allgemeines zu Enterpay

Logo

COO 6505 1000 13 7779169

Info

Enterpay ist ein finnisches FinTech-Startup, das sich zum Ziel gesetzt hat, den B2B-E-Commerce (Business-to-Business) anzukurbeln und den Zahlungsprozess für den B2B-E-Commerce zu optimieren, indem der Prozess zur Risikobewertung der Gegenpartei automatisiert wird.

Im B2B-Handel sind Rechnungen die bevorzugte Methode. Diese werdeb jedoch oft manuell abgewickelt, was sie zeitaufwändig und potenziell riskant macht. Da die Online-Käufe im B2B-Markt weiterhin schnell wachsen, erwarten B2B-Käufer die schnlle und reibungslose Erfahrung, die sie vom B2C-Handel kennen. Enterpay hat eine technische Lösung entwickelt, die den veränderten Erwartungen der B2B-Kunden gerecht wird und ihnen ermöglicht, Rechnungszahlungen im B2B-Geschäft einfach, schnell und sicher durchzuführen. Das Zahlungssystem von Enterpay besteht aus einer Plattform, auf der alle erforderlichen Parteien den automatisierten B2B-Handel ermöglichen und nahtlos zusammenarbeiten können. Enterpay arbeitet mit Banken und PSPs zusammen, damit diese ihren B2B-Händlerkunden eine rein digitale und vollautomatisierte Rechnungsstellung und Factoring-Lösung anbieten können. Die Technologie führt automatisch die Betrugs- und Kreditrisikobewertung durch und lässt sich in verschiedene E-Commerce-Plattformen und Zahlungs-Gateways integrieren.

Typ

Zahlungen per Rechnungs- und Ratenkauf

Weitere Informationen finden Sie auch auf der Webseite von Enterpay (https://www.enterpay.eu/).

Diagramm zum Prozessablauf

Autorisierung

Rechnungs-Aktualisierung

Hinweis: Der Händler sendet die Bestell-ID (TransID) und eine Liste der Artikel-IDs, die korrigiert werden müssen. Bei Enterpay werden in einer Rechnung enthaltene Artikel durch ihren internen Index identifiziert (Enterpay-Parameter update[cart_items][N][num], nicht durch die vom Händler bereitgestellte Artikel-ID (Enterpay-Parameter update[cart_items][N][identifier_merchant]). Bei einer Rechnungsaktualisierung müssen Artikel mit genau demselben Index an Enterpay gesendet werden, den GetStatus zurückgibt. Daher muss vor dem Senden der Rechnungsaktualisierung die GetStatus-API aufgerufen werden.

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 Rechnung anzulegen, verwenden Sie bitte folgende URL:

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

Die URL wird sowohl zum Anlegen einer Rechnung (EventToken=CRT) als auch zum Aktualisieren einer Rechnung (EventToken=UPD) verwendet.

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

EventToken

enum

m

CRT (für Rechnung anlegen)

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.

Language

ans..5

O

ArticleList

ans..1024

M

Artikelliste im folgenden Format.

name,unit_price_excluding_tax,quantity,identifier,tax_rate+

name,unit_price_excluding_tax,quantity,identifier,tax_rate+

...

Parameter

CND

Beschreibung

name

M

Name des Produkts, wie er auf der Rechnung angezeigt wird

unit_price_excluding_tax

M

Kosten dieses Artikels mit Steuern

quantity

M

Menge der Artikel in dieser Zeile

identifier

M

Produktkennung in der Datenbank des Händlers

tax_rate

M

Für dieses Produkt geltender Mehrwertsteuersatz, z.B. 0.24 bedeutet 24%

InvoiceDate

dttm

O

Der Parameter bestimmt das Rechnungsdatum. Er kann nicht in der Vergangenheit liegen.

Format: JJJJ-MM-TT

InvoiceText

ans..100

O

Ein optionales Metadatenfeld für die Bequemlichkeit des Benutzers

Der Block der Rechnungsadresse ist optional. Wenn der Block vorhanden ist, müssen die Pflichtfelder im Block ausgefüllt werden.

bdStreet

ans..100

M

Straßenadresse der Rechnungsadresse des Benutzers

bdStreet2

ans..100

O

Zusätzliche Informationen zur Straßenadresse der Rechnungsadresse des Benutzers

bdZIP

ans..10

M

Postleitzahl der Rechnungsadresse des Benutzers

bdCity

ans..100

M

Ort der Rechnungsadresse des Benutzers

bdCountryCode

ans..10

O

Ländercode der Rechnungsadresse des Benutzers

Der Block der Lieferdresse ist optional. Wenn der Block vorhanden ist, müssen die Pflichtfelder im Block ausgefüllt werden.

sdStreet

ans..100

M

Straßenadresse der Lieferadresse des Benutzers

sdStreet2

ans..100

O

Zusätzliche Informationen zur Straßenadresse der Lieferadresse des Benutzers

sdStreet2

ans..100

O

Zusätzliche Informationen zur Straßenadresse der Lieferadresse des Benutzers

sdZIP

ans..10

M

Postleitzahl der Lieferadresse des Benutzers

sdCity

ans..100

M

Ort der Lieferadresse des Benutzers

sdCountryCode

ans..10

O

Ländercode der Lieferadresse des Benutzers

Der Käufer-Block ist optional und alle Felder sind optional. Es ist besser, die Informationen weiterzugeben, da dies die Benutzererfahrung verbessert. In diesem Fall muss der Käufer diese Informationen auf der Seite von Enterpay nicht erneut eingeben.

FirstName

ans..125

O

Vorname des Käufers

LastName

ans..125

O

Nachname des Käufers

Phone

ans..50

O

Telefonnummer des Käufers mit Ländervorwahl, z.B. +35812345678

DateOfBirth

dttm

O

Geburtsdatum des Käufers.

Format: JJJJ-MM-TT

Email

ans..50

O

E-Mail-Adresse des Käufers

CompanyName

ans..125

O

Unternehmensname des Käufers

CompanyID

ans..40

O

Firmen-ID des Unternehmens des Käufers, z.B. 1234567-8

TaxNumber

ans..20

O

Europäische Umsatzsteuer-Identifikationsnummer des Unternehmens des Käufers, z.B. FI12345678

Der SubMerchant-Block ist optional und alle Felder sind optional

StoreName

ans..255

O

Name der Organisation des Sub-Händlers

subMIDAddrStreet

ans..100

O

Straßenadresse in der Rechnungs-/Lieferadresse des Sub-Händlers

subMIDAddrStreet2

ans..100

O

Zusätzliche Informationen zur Straßenadresse in der Rechnungs-/Lieferadresse des Sub-Händlers

subMIDAddrZip

ans..10

O

Postleitzahl der Rechnungs-/Lieferadresse des Sub-Händlers

subMIDAddrCity

ans..100

O

Ort der Rechnungs-/Lieferadresse des Sub-Händlers

subMIDAddrCountryCode

ans..10

O

Ländercode der Rechnungs-/Lieferadresse des Sub-Händlers

Parameter zum Anlegen einer Rechnung mit Enterpay

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..30

M

AUTHORIZE_REQUEST 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

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

ans..1024

O

Fehlercode von Enterpay, falls mit Computop Helpdesk abgesprochen.

ErrorText

ans..1024

O

Fehlermeldung von Enterpay, falls mit Computop Helpdesk abgesprochen.

Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure bei Enterpay

Rechnung aktualisieren

Das Aktualisieren einer Rechnung ist über eine Server-zu-Server-Verbindung möglich.

Um eine Rechnung zu aktualisieren, verwenden Sie bitte folgende URL:

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

Die URL wird sowohl zum Anlegen einer Rechnung (EventToken=CRT) als auch zum Aktualisieren einer Rechnung (EventToken=UPD) verwendet.

Die Aktualisierung einer Rechnung ist nur für nicht aktivierte (nicht gebuchte) Rechnungen möglich. Falls der Parameter InvoiceDate im API-Aufruf UpdateInvoice enthalten ist, wird der Aufruf die aktualisierte Rechnung automatisch vollständig aktivieren (buchen). Somit ist kein nachfolgender API-Aufruf zur Aktivierung (Buchung) für die Rechnung erforderlich. Von Seite des Paygate wird die Autorisierungs-Transaktion aktualisiert und die Buchungstransaktion angelegt. Falls der Parameter InvoiceDate im API-Aufruf UpdateInvoice nicht enthalten ist, bleibt die Rechnung inaktiv und ein API-Aufruf zur Aktivierung (Buchung) sollte explizit gesendet werden. Nur autorisierte Transaktionen werden aktualisiert.

Die Artikelliste sollte alle Artikel enthalten (auch jene, die nicht geändert werden sollten), weil die gesamte Artikelliste durch die jetzt gesendete ersetzt wird. Falls jedoch nur der Parameter InvoiceDate gesendet wird, wird nur InvoiceDate aktualisiert.

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

EventToken

enum

M

UPD (für Rechnung aktualisieren)

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.

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.

ArticleList

ans..1024

M

Artikelliste im folgenden Format.

name,unit_price_excluding_tax,quantity,identifier,tax_rate+

name,unit_price_excluding_tax,quantity,identifier,tax_rate+

...

Parameter

CND

Beschreibung

name

M

Name des Produkts, wie er auf der Rechnung angezeigt wird

unit_price_excluding_tax

M

Kosten dieses Artikels mit Steuern

quantity

M

Menge der Artikel in dieser Zeile

identifier

M

Produktkennung in der Datenbank des Händlers

tax_rate

M

Für dieses Produkt geltender Mehrwertsteuersatz, z.B. 0.24 bedeutet 24%

InvoiceDate

dttm

O

Der Parameter bestimmt das Rechnungsdatum. Er kann nicht in der Vergangenheit liegen.

Format: JJJJ-MM-TT

Parameter zum Aktualisieren einer Rechnung mit Enterpay

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..30

M

AUTHORIZE_REQUEST 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

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

ans..1024

O

Fehlercode von Enterpay, falls mit Computop Helpdesk abgesprochen.

ErrorText

ans..1024

O

Fehlermeldung von Enterpay, falls mit Computop Helpdesk abgesprochen.

Ergebnis-Parameter beim Aktualisieren einer Rechnung mit Enterpay

Vollständige Buchung

Eine vollständige Buchung ist über eine Server-zu-Server-Verbindung möglich.

Um eine Rechnung vollständig zu buchen, verwenden Sie bitte folgende URL:

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

Die URL wird sowohl für die vollständige Buchung (EventToken=) als auch die Teilbuchung einer Rechnung (EventToken=) verwendet.

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

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

EventToken

enum

M

ACF (für Komplettbuchung der Rechnung)

MAC

an64

M

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

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.

UserData

ans..1024

O

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

Parameter für vollständige Buchung von Enterpay-Zahlungen

The following table describes the result parameters with which the Computop Paygate responds to your system

pls. be prepared to receive additional parameters at any time and do not check the order of parameters

the key (e.g. MerchantId, RefNr) should not be checked case-sentive

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

ans..1024

O

Fehlercode von Enterpay, falls mit Computop Helpdesk abgesprochen.

KeyFormatCNDDescription

ErrorText

ans..1024

O

Fehlermeldung von Enterpay, falls mit Computop Helpdesk abgesprochen.

Ergebnis-Parameter beim Aktualisieren einer Rechnung mit Enterpay

Teilbuchung

Teilbuchungen sind über eine Server-zu-Server-Verbindung möglich. Bei einer Teilbuchung muss in der Anfrage eine neue TransID bereitgestellt werden. Diese neue TransID wird für die Buchung der nächsten Rechnung verwendet.

Um eine Rechnung teilweise zu buchen, verwenden Sie bitte folgende URL:

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

Die URL wird sowohl für die vollständige Buchung (EventToken=ACF) als auch die Teilbuchung einer Rechnung (EventToken=ACP) verwendet.

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

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

EventToken

enum

M

ACF (für Komplettbuchung der Rechnung)

MAC

an64

M

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

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.

UserData

ans..1024

O

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

ArticleList

ans..1024

M

Artikelliste im folgenden Format.

quantity,name+

quantity,name+

...

Parameter

CND

Beschreibung

quantity

M

Menge der Artikel in diese Zeile

name

M

Name des Produkts, wie er auf der Rechnung angezeigt wird

Parameter für Teilbuchung von Enterpay-Zahlungen

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

ans..1024

O

Fehlercode von Enterpay, falls mit Computop Helpdesk abgesprochen.

ErrorText

ans..1024

O

Fehlermeldung von Enterpay, falls mit Computop Helpdesk abgesprochen.

Ergebnis-Parameter für Teilbuchung von Enterpay-Zahlungen

Storno

Stornierungen sind über eine Server-zu-Server-Verbindung möglich. Stornierungen sind nur für nicht aktivierte (nicht gebuchte) Rechnungen möglich. Es ist nur eine vollständige Stornierung zulässig. Falls eine Rechnung bereits aktiviert (gebucht) war, sollte eine Gutschrift verwendet werden.

Um eine Stornierung einer Rechnung auszuführen, 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

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:

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.

UserData

ans..1024

O

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

Parameter für Stornierung von Enterpay-Zahlungen

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

ans..1024

O

Fehlercode von Enterpay, falls mit Computop Helpdesk abgesprochen.

ErrorText

ans..1024

O

Fehlermeldung von Enterpay, falls mit Computop Helpdesk abgesprochen.

Ergebnis-Parameter für Stornierung von Enterpay-Zahlungen

Gutschrift (Rückerstattung)

Gutschriften (Rückerstattungen) sind über eine Server-zu-Server-Verbindung möglich. Gutschriften sind nur für bereits aktivierte (gebuchte) Rechnungen möglich. Es sind vollständige oder teilweise Gutschriften zulässig. Falls eine Rechnung noch nicht aktiviert (gebucht) war, sollte eine Stornierung verwendet werden.

Um eine Gutschrift zu einer Rechnung auszuführen, 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 gutzuschreibende Zahlung

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:

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.

UserData

ans..1024

O

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

ArticleList

ans..1024

M

Artikelliste im folgenden Format.

name,refunding_type,currency,refunded_amount+

name,refunding_type,currency,refunded_amount+

...

Parameter

CND

Beschreibung

name

M

Name des Produkts, wie er auf der Rechnung angezeigt wird

refunding_type

M

amount

Konstanter Wert

currency

M

Währung

refunded_amount

M

Der zu erstattende Betrag dieses Kaufartikels

Parameter für Gutschrift von Enterpay-Zahlungen

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

ans..1024

O

Fehlercode von Enterpay, falls mit Computop Helpdesk abgesprochen.

ErrorText

ans..1024

O

Fehlermeldung von Enterpay, falls mit Computop Helpdesk abgesprochen.

Ergebnis-Parameter für Gutschrift von Enterpay-Zahlungen

Paygate

Documentation (EN)

Dokumentation (DE)

Paygate Status