• DeutschEnglish

PayU CEE Single

Über PayU CEE Single

Allgemeines zu Zahlungsmethoden via PayU CEE Single

Für die Anbindung an PayU gibt es je nach Ländern zwei verschiedene Varianten der Schnittstelle sowie zwei zugehörige Handbücher. Diese Anbindung PayU CEE Single gilt nur für Polen, Tschechien und die Slowakei. Für Ungarn, Rumänien, Russland und die Türkei ist die Anbindung PayU CEE GECAD zu verwenden. Dafür gibt es ein separates Handbuch: PayU CEE GECAD.

Logo

COO 6505 1000 10 6092951

Info

PayU ist das führende Wallet-System in Polen. Die umfassenden Zahlungsdienstleistungen können Händler über das Paygate auch in Osteuropa und weiteren Ländern anbieten und erreichen damit über 500 Millionen potenzielle Kunden.

Typ

Gemischte Zahlarten

Card Scheme

VISA

MasterCard

Diagramm zum Prozessablauf

PayU CEE Single Prozessablauf

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.

Zahlung mit PayU CEE Single via Formular-Schnittstelle

Um eine Zahlung mit PayU CEE Single über ein Paygate-Formular abzuwickeln, verwenden Sie bitte folgende URL:

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

BLIK OneClick

Es gibt 4 mögliche Szenarien, um eine Zahlung mittels BLIK OneClik zu verarbeiten.

Szenario 1: Zahlung mittels AuthCode

Diese Szenario ist für alle Händler möglich.

Um diese Option zu verwenden, muss der Parameter PayType auf "blik" gesetzt sein und der Parameter AuthCode einen gültigen Autorisierungscode enthalten. Bitte beachten Sie, dass bezüglich dieser Funktionalität der Kunde/Client/Browser nicht zum Computop Paygate weitergeleitet wird und Ihr Shopsystem ausschließlich über die URLNotify-Antwort den Status der Zahlung zurückerhält.

Bitte beachten Sie, dass die zusätzliche BLIK-OneClick-Variante auch auf dem PayU Account (POS-ID) aktiv ist.

Szenario 2: Zahlung mittels AuthCode mit Token-Registrierung

Diese Szenario ist nur für Händler möglich, die auf Seite von PayU als "vertrauenswürdige Händler" registriert sind.

Um diese Option zu verwenden, muss der Parameter PayType auf "blik" gesetzt sein und der Parameter AuthCode einen gültigen Autorisierungscode enthalten.

Da der Händler bei PayU als "vertrauenswürdiger Händler" registriert ist, wird nach der erfolgreichen Zahlung ein Token bei PayU erzeugt und registriert. Dieses Token wird in der Antwort im Parameter TokenExt zurückgegeben. Das Token kann später für weitere Zahlungen verwendet werden (siehe nachstehend Szenario 3 und Szenario 4).

Szenario 3: Zahlung mittels Token

Diese Szenario ist nur für Händler möglich, die auf Seite von PayU als "vertrauenswürdige Händler" registriert sind.

Ein mittels Szenario 2 erzeugtes Token kann für weitere Zahlungen verwendet werden. In diesem Szenario muss der Parameter PayType auf "blik" gesetzt sein und der Parameter TokenExt ein gültiges Token enthalten.

Szenario 4: Zahlung mittels Token mit Alternativen

Diese Szenario ist nur für Händler möglich, die auf Seite von PayU als "vertrauenswürdige Händler" registriert sind.

Ein mittels Szenario 2 erzeugtes Token kann für weitere Zahlungen verwendet werden. In diesem Szenario muss der Parameter PayType auf "blik" gesetzt sein und der Parameter TokenExt ein gültiges Token enthalten (wie oben im Szenario 3).

Ein Kunde kann aber Konten bei mehreren Banken haben und BLIK bei jeder dieser Banken nutzen. Dadurch kann mehreren Geräten/Bankapplikationen derselbe Token zugeordnet werden.

In diesem Fall enthält die Antwort den Parameter Alternatives im Format "appKey1:appLabel1, appKey2:appLabel2, appKey3:appLabel3". Falls die Antwort den Parameter Alternatives enthält, sollte eine neue Zahlungsanfrage so gesendet werden, dass der Parameter PayType gleich "blik" ist, der Parameter TokenExt dasselbe Token wie die anfängliche Zahlungsanfrage enthält und der Parameter AppKey einen der im Parameter Alternatives zurückgegebenen AppKeys enthält.

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, z.B. EUR, USD, GBP. Nur EUR, PLN und CZK 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.

Capture

an..6

OM

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

Buchungsart

Beschreibung

AUTO

Buchung sofort nach Autorisierung (Standardwert).

MANUAL

Buchung erfolgt durch den Händler – in der Regel erfolgt die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.

<Zahl>

Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

OrderDesc

ans..35

M

Beschreibung der gekauften Waren, Einzelpreise usw.

Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden.

OrderDesc2

ans..384

O

Anzahl und Beschreibung gekaufter Waren, Einzelpreise. Kommaseparierte Liste, keine Sonderzeichen zulässig.

ArticleList

ans..1024

M

Artikelliste. Dieser Parameter muss folgenden Aufbau haben:

Produktname,Einzelpreis,Anzahl

Mehrere Artikel können durch ein + getrennt werden, z.B.: iPhone,700,1+Samsung Galaxy,700,2

Die Summe der Preise aus ArticleList und ShippingData muss mit dem Parameter Amount übereinstimmen. Wenn diese Prüfung deaktiviert werden soll (z.B. für die Verarbeitung von Geschenk-Gutscheinen), so wenden Sie sich bitte an den Computop Helpdesk und an den PayU Support.

PayType

ans..4

O

Zu verwendende Zahlungsart. Mögliche Werte stehen in der Liste https://developers.payu.com/en/overview.html#paymethods unter Value.  z.B. "dpcz" für Twisto CZK.

AuthCode

n6

O

Für die Zahlungsart BLIK kann der Parameter AuthCode übergeben werden. Wird dieser nicht übergeben, wird der Kunde auf eine entsprechende Seite weitergeleitet.

Bitte beachten Sie, dass die zusätzliche BLIK-OneClick-Variante auch auf dem PayU Account (POS-ID) aktiv ist.

TokenExt

ans..64

O

Für die Zahlungsart BLIK kann der Parameter TokenExt übergeben werden.

AppKey

ans..32

O

Für die Zahlungsart BLIK kann der Parameter Appkey zusammen mit dem Parameter TokenExt übergeben werden.

Falls ein Kunde Konten bei mehreren Banken hat und BLIK bei jeder dieser Banken verwendet, enthält der Parameter AppKey den Application-Key, für den das TokenExt verwendet werden soll.

Timeout

n..3

O

Dauer in Sekunden, in der die Zahlung durchgeführt werden muss

Language

a2

O

ISO-Code für Sprache; derzeit nur en, pl, cs zulässig

Plain

ans..50

O

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Bestellerdaten

FirstName

ans..100

M

Vorname des Kunden

LastName

ans..100

M

Nachname des Kunden

Email

ans..100

M

E-Mail-Adresse des Kunden

CustomerID

ans..64

C

Muss für Blik Szenario 2 (Zahlung mit AuthCode mit Token-Registrierung) gesendet werden.

Phone

ans..100

O

Telefonnummer des Kunden

SocialSecurityNumber

ans..100

O

Sozialversicherungsnummer

Lieferdaten

sdName

ans..100

C

Name.

PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.

sdStreet

ans..100

C

Straße und Hausnummer

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.

sdAddressAddition

ans..100

O

Adresszusatz

sdZIP

ans..10

C

Postleitzahl

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.

sdCity

ans..100

C

Stadt

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.

sdCountryCode

a..3

C

Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3)

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.

sdState

ans..100

O

Bundesland

sdEmail

ans..100

O

E-Mail-Adresse

sdPhone

ans..100

O

Telefonnummer

sdPOBox

ans..100

O

Postfach

ShippingData

ans..256

C

Auswahl des Versanddienstleisters.

Der Parameter muss folgenden Aufbau haben:

Land,Preis (in der kleinsten Währungseinheit),Name

Mehrere Auswahlmöglichkeiten können durch ein + getrennt werden.

z.B. PL,700,UPS+PL,600,DHL

PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.

Die Summe der Preise aus ArticleList und ShippingData muss mit dem Parameter Amount übereinstimmen. Wenn diese Prüfung deaktiviert werden soll (z.B. für die Verarbeitung von Geschenk-Gutscheinen), so wenden Sie sich bitte an den Computop Helpdesk und an den PayU Support.

Rechnungsdaten

bdName

ans..100

O

Name

bdStreet

ans..100

C

Straße und Hausnummer

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdAddressAddition

ans..100

O

Adresszusatz

bdZIP

ans..10

C

Postleitzahl

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdCity

ans..100

C

Stadt

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdCountryCode

a..3

C

Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3)

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdState

ans..100

O

Bundesland

bdEmail

ans..100

O

E-Mail-Adresse

bdPhone

ans..100

O

Telefonnummer

bdPOBox

ans..100

O

Postfach

TaxNumber

n..30

O

National Identification Number (Steuernummer)

InvoiceFlag

n1

O

Legt fest, ob der Haken zum Rechnungsversand auf der PayU-Seite angezeigt wird.

1 = Haken wird angezeigt

0 = Haken wird nicht angezeigt

Parameter für Zahlungen mit PayU CEE Single

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

OK, FAILED oder AUTHORIZE_REQUEST.

Sollte 10 Sekunden nach der Umleitung auf die CallBack-Seite kein Notify von PayU empfangen worden sein, wird als Status “AUTHORIZE_REQUEST”, als Code “00000000” und als Description ”REQUEST” an die URLSuccess übergeben.

Bitte beachten Sie, der Status “AUTHORIZE_REQUEST” wird ausschließlich an die URLSuccess gemeldet, hierzu gibt es keinen URLNotify-Aufruf.

Erhält das Computop Paygate auf dieses offene Payment einen weiteren finalen PayU Status, wird dieser separat via URLNotify gemeldet. Wenn Sie keinen separaten, finalen Status via URLNotify verarbeiten möchten, kann das offene Payment via Aufruf der reverse.aspx storniert werden und sollte PayU dennoch den Umsatz erhalten, wird dieser automatisch dem Kunden erstattet.

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

n..10

O

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..256

O

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

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.

Plain

ans..50

O

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

TransactionID

ans..32

O

ID zur Identifizierung bei PayU

AmountAuth

n..10

M

Autorisierter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

AmountCap

n..10

M

Gebuchter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

AmountCred

n..10

M

Gutgeschriebener Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

AllowedPayMethods

ans..1024

C

Base64 JSON object.

Das Objekt enthält „blickToken“ im gleichen Format, wie es von PayU zurückgegeben wurde.

Beispiel:

1
[
2
{
3
value: 'TOKB_EaVSDM7dXXN1qXXExDdakvfviizKnIys',
4
type: 'UID',
5
brandImageUrl: 'https://static.payu.com/images/mobile/logos/pbl_blik.png',
6
bankApplicationReferences: [
7
{
8
key: '18422',
9
label: 'ma...tt@co...om',
10
},
11
{
12
key: '18407',
13
label: 'ma...tt@co...om',
14
},
15
],
16
},
17
];

Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify bei PayU CEE Single

Kreditkartenzahlung mit PayU CEE Single via Formular-Schnittstelle

Um eine Kreditkartenzahlung mit PayU CEE Single über ein Paygate-Formular abzuwickeln, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/payssl.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

ns..30

O

Eindeutige Referenznummer, die auf Ihrer gedruckten Kartenabrechnung oder in der EPA-Datei (Electronic Payment Advice) erscheint. Das Format muss vorher mit Computop abgestimmt werden!

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

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.

RTF

a1

O

„I“ zur Initialisierung von wiederkehrenden Zahlungen

OrderDesc

ans..35

M

Beschreibung der gekauften Waren, Einzelpreise usw.

Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden.

OrderDesc2

ans..384

O

Anzahl und Beschreibung gekaufter Waren, Einzelpreise. Kommaseparierte Liste, keine Sonderzeichen zulässig.

Plain

ans..50

O

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

Bestellerdaten

FirstName

ans..100

M

Vorname des Kunden

LastName

ans..100

M

Nachname des Kunden

Email

ans..100

M

E-Mail-Adresse des Kunden

Phone

ans..100

O

Telefonnummer des Kunden

SocialSecurityNumber

ans..100

O

Sozialversicherungsnummer

Lieferdaten

sdName

ans..100

O

Name

sdStreet

ans..100

C

Straße und Hausnummer

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

sdAddressAddition

ans..100

O

Adresszusatz

sdZIP

ans..10

C

Postleitzahl

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

sdCity

ans..100

C

Stadt

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

sdCountryCode

a..3

C

Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3)

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

sdState

ans..100

O

Bundesland

sdEmail

ans..100

O

E-Mail-Adresse

sdPhone

ans..100

O

Telefonnummer

sdPOBox

ans..100

O

Postfach

Rechnungsdaten

bdName

ans..100

O

Name

bdStreet

ans..100

C

Straße und Hausnummer

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdAddressAddition

ans..100

O

Adresszusatz

bdZIP

ans..10

C

Postleitzahl

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdCity

ans..100

C

Stadt

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdCountryCode

a..3

C

Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3)

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdState

ans..100

O

Bundesland

bdEmail

ans..100

O

E-Mail-Adresse

bdPhone

ans..100

O

Telefonnummer

bdPOBox

ans..100

O

Postfach

TaxNumber

n..30

O

National Identification Number (Steuernummer)

Parameter für Kreditkartenzahlungen mit PayU CEE Single

Um das Layout der SSL-Seite an den Shop anzupassen, können Sie mit den folgenden unverschlüsselten Parametern Farben, Schriften und Bilder konfigurieren:

KeyFormatCNDDescription

Template

ans..20

O

Name der XSLT-Datei mit Ihrem individuellen Layout für das Bezahlformular. Wenn Sie das neugestaltete und abwärtskompatible Computop-Template nutzen möchten, übergeben Sie den Templatenamen „ct_compatible“. Wenn Sie das responsive Computop-Template für mobile Endgeräte nutzen möchten, übergeben Sie den Templatenamen „ct_responsive“.

Background

ans..256

O

Formular Hintergrundumgebung:

- URL für ein Hintergrundbild

- HTML-Farbwert für Hintergrundfarbe als HEX-Wert oder

- HTML-Farbname

BGColor

ans..7

O

Formular Hintergrundfarbe:

- HTML-Farbwert für Hintergrundfarbe als HEX-Wert oder

- HTML-Farbname

BGImage

ans..256

O

Formular Hintergrundbild:

URL für ein Hintergrundbild

Beachten Sie bitte, dass dieser Wert „BGColor“ überschreibt.

FColor

ans..7

O

Textfarbe:

- HTML-Farbwert als HEX-Wert oder

- HTML-Farbname

FFace

a..10

O

HTML-Name der Schriftart

FSize

n2

O

Zahl für die Schriftgröße

Language

a2

O

Sprachcode: <de> deutsch, <al> albanisch, <at> österreichisch, <cz/cs> tschechisch, <dk> dänisch, <en> englisch, <fi> finnisch, <fr> französisch, <gr> griechisch, <hu> ungarisch, <it> italienisch, <jp> japanisch, <nl> holländisch, <no> norwegisch, <pl> polnisch, <pt> portugiesisch, <ro> rumänisch, <ru> russisch, <es> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> türkisch, <zh> Simplified Chinese

Ohne Angabe ist die Sprache Deutsch.

CCSelect

a..16

M

Bestimmt die vorausgewählte Kartenmarke im Formular: VISA, AMEX, JCB, DINERS, MasterCard, Cartes Bancaires, Bancontact, Maestro, Dankort, Hipercard, CBN, Airplus, ComfortCard, Discover, Elo, Auro, CUP

URLBack

ans..256

O

Vollständige URL, die das Paygate aufruft, wenn der Kunde auf Abbruch klickt.

Der Parameter "URLBack" kann

  • sowohl unverschlüsselt ans Paygate übermittelt werden (Kompabilitätsmodus)

  • als auch in den verschlüsselten Übergabeparametern (bevorzugte Variante)

Wenn Sie Parameter/Werte in der URLBack übergeben möchten, so können Sie folgende Methode verwenden:

1
URLBack=https://your.shop.com/back.php?param1%3Dvalue1%26param2%3Dvalue3%26status%3Dcancelled

Wenn der Kunde auf Abbruch klickt, so wird die URL genauso aufgerufen, so dass Sie URL Decode verwenden können, um Parameter und Werte zu extrahieren.

Center

n1

O

Standardmäßig ist das Formular vertikal und horizontal zentriert. Der Wert <1> justiert es oben mittig.

tWidth

ans..4

O

Breite der Tabelle im Eingabeformular als Prozent- (50%) oder Pixelwerte (320)

tHeight

ans..4

O

Höhe der Tabelle für die Eingabe der Bezahldaten im Formular als Prozent- (70%) oder Pixelwerte (480)

Layout-Parameter für Paygate-Formulare bei Kreditkartenzahlungen mit PayU CEE Single

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

OK, FAILED oder AUTHORIZE_REQUEST.

Sollte 10 Sekunden nach der Umleitung auf die CallBack-Seite kein Notify von PayU empfangen worden sein, wird als Status “AUTHORIZE_REQUEST”, als Code “00000000” und als Description ”REQUEST” an die URLSuccess übergeben.

Bitte beachten Sie, der Status “AUTHORIZE_REQUEST” wird ausschließlich an die URLSuccess gemeldet, hierzu gibt es keinen URLNotify-Aufruf.

Erhält das Computop Paygate auf dieses offene Payment einen weiteren finalen PayU Status, wird dieser separat via URLNotify gemeldet. Wenn Sie keinen separaten, finalen Status via URLNotify verarbeiten möchten, kann das offene Payment via Aufruf der reverse.aspx storniert werden und sollte PayU dennoch den Umsatz erhalten, wird dieser automatisch dem Kunden erstattet.

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

n..10

O

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..256

O

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

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.

PCNr

n16

O

Pseudo Card Number: Vom Computop Paygate generierte Zufallszahl, die eine reale Kreditkartennummer repräsentiert. Die Pseudokartennummer (PKN) beginnt mit 0, und die letzten 3 Stellen entsprechen denen der realen Kartennummer. Die PKN kann wie eine Kreditkartennummer für Autorisierung, Buchung und Gutschriften verwendet werden.

PCNr ist ein Antwortwert vom Computop Paygate und kann ebenfalls als CCNr im Request oder als Teil von card-JSON verwendet werden.

CCBrand

a..22

O

In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard etc.

CCExpiry

n6

O

In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM

MaskedCCNr

an..19

OC

Maskierte Kartennummer 6X4

TokenExt

an..64

C

Bei wiederkehrenden Zahlungen (RTF=I) wird der Token übergeben, um die Kreditkartendaten zu referenzieren

Plain

ans..50

O

Ein einzelner Wert, der von Ihnen gesetzt werden kann, um Informationen wieder unverschlüsselt in der Antwort bzw. im Notify zurückzugeben, z.B. die MID.

Da der "Plain"-Parameter Teil des verschlüsselten "Data" im Computop Paygate ist, ist dieser vor Manipulationen geschützt.

Custom

ans..1024

O

Der "Custom"-Parameter wird vor der Verschlüsselung an den Aufruf angehängt und ist Teil des verschlüsselten "Data" im Computop Paygate -Aufruf. Dadurch ist der Wert gegen Manipulation geschützt.

Der Custom-Wert wird dann in Klartext an die Computop Paygate-Antwort angehängt und dabei wird "|" durch "&" ersetzt. Dadurch können Sie einen Custom-Wert übergeben und bekommen mehrere Key-Value-Paare zu Ihrer eigenen Verwendung in der Antwort zurück.

Hier finden Sie ein Beispiel: Custom

TransactionID

ans..32

O

ID zur Identifizierung bei PayU

AmountAuth

n..10

M

Autorisierter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

AmountCap

n..10

M

Gebuchter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

AmountCred

n..10

M

Gutgeschriebener Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify bei PayU CEE Single

Kreditkartenzahlung mit PayU CEE Single per Server-zu-Server-Verbindung

Um eine wiederkehrende Kreditkartenzahlung mit PayU CEE Single über ein Paygate-Formular auszuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/direct.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, 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:

Capture

an..6

OM

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

Buchungsart

Beschreibung

AUTO

Buchung sofort nach Autorisierung (Standardwert).

MANUAL

Buchung erfolgt durch den Händler – in der Regel erfolgt die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.

<Zahl>

Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

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.

RTF

a1

O

„I“ zur Initialisierung von wiederkehrenden Zahlungen

OrderDesc

ans..35

M

Beschreibung der gekauften Waren, Einzelpreise usw.

Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden.

CCNr

n..19

M

Kreditkartennummer

CCExpiry

n6

M

Ablaufdatum der Kreditkarte (YYYYMM), z.B. 202307

CCBrand

a..2

M

Kartenmarke: nur VISA, MasterCard. Bitte beachten Sie die Schreibweise!

TokenExt

an..64

M

Der Token, um die Kreditkartendaten bei PayU zu referenzieren

Bestellerdaten

FirstName

ans..100

M

Vorname des Kunden

LastName

ans..100

M

Nachname des Kunden

Email

ans..100

M

E-Mail-Adresse des Kunden

Phone

ans..100

O

Telefonnummer des Kunden

SocialSecurityNumber

ans..100

O

Sozialversicherungsnummer

Lieferdaten

sdName

ans..100

O

Name

sdStreet

ans..100

C

Straße und Hausnummer

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

sdAddressAddition

ans..100

O

Adresszusatz

sdZIP

ans..10

C

Postleitzahl

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

sdCity

ans..100

C

Stadt

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

sdCountryCode

a..3

C

Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3)

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.

sdState

ans..100

O

Bundesland

sdEmail

ans..100

O

E-Mail-Adresse

sdPhone

ans..100

O

Telefonnummer

sdPOBox

ans..100

O

Postfach

Rechnungsdaten

bdName

ans..100

O

Name

bdStreet

ans..100

C

Straße und Hausnummer

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdAddressAddition

ans..100

O

Adresszusatz

bdZIP

ans..10

C

Postleitzahl

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdCity

ans..100

C

Stadt

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdCountryCode

a..3

C

Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3)

Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden

bdState

ans..100

O

Bundesland

bdEmail

ans..100

O

E-Mail-Adresse

bdPhone

ans..100

O

Telefonnummer

bdPOBox

ans..100

O

Postfach

TaxNumber

n..30

O

National Identification Number (Steuernummer)

Parameter für Kreditkartenzahlungen mit PayU CEE Single über Socket-Verbindung

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 oder AUTHORIZED (URLSuccess) sowie 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

n..10

O

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..256

O

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

UserData

ans..1024

O

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

TransactionID

ans..32

O

ID zur Identifizierung bei PayU

AmountAuth

n..10

M

Autorisierter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

AmountCap

n..10

M

Gebuchter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

AmountCred

n..10

M

Gutgeschriebener Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

Ergebnis-Parameter der Socket-Verbindung bei PayU CEE Single

Buchung einer Zahlung mit PayU CEE Single

Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Buchung (Capture) für eine Kreditkartenzahlung mit PayU CEE Single über eine Server-zu-Server-Verbindung auszuführen, 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, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

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.

Parameter für Buchungen von PayU CEE Single über Socket-Verbindungen

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

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)

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

CodeExt

n..10

O

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..256

O

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter für Buchungen von PayU CEE Single über Socket-Verbindungen

Gutschrift mit Referenz

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Bei einer Gutschrift mit Bezug auf eine Buchung ist die Höhe der Gutschrift auf die Höhe der vorangegangen Buchung beschränkt. Um eine Gutschrift (Credit) mit Referenztransaktion auszuführen, 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, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

OrderDesc

ans..768

O

Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.

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.

Parameter für Gutschrift von Zahlungen mit PayU CEE Single über Socket-Verbindungen

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

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

n..10

O

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorText

ans..256

O

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

Antwort-Parameter für Gutschrift von Zahlungen mit PayU CEE Single über Socket-Verbindungen

Storno

Stornierungen sind über eine Server-zu-Server-Verbindung möglich. Um eine Stornierung auszuführen, verwenden Sie bitte folgende URL:

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

Hinweis: Die Reverse.aspx macht nicht nur Autorisierungen, sondern IMMER DEN LETZTEN TRANSAKTIONSSCHRITT rückgängig! Falls die letzte Transaktion eine Buchung war, löst die Rever-se.aspx z.B. eine Gutschrift aus. Es ist daher größte Vorsicht geboten, und die Nutzung erfolgt auf eigene Gefahr. Wir empfehlen, vor Nutzung der Reverse.aspx den Transaktionsstatus mit der Inquire.aspx prüfen.

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

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 PayU CEE Single

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

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)

Ergebnis-Parameter für Storno von Zahlungen mit PayU CEE Single

Batch-Nutzung der Schnittstelle

Grundsätzliche Informationen zur Arbeit mit Batch-Dateien sowie zu deren Aufbau erfahren Sie im separaten Handbuch zum Batchmanager. Im Batch-Verfahren sind nicht alle Funktionen verfügbar, die für die Online-Schnittstelle verfügbar sind.

Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung von Zahlungen / Gutschriften mit PayU CEE Single übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.

Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:

Action

Version

Beschreibung

Capture

1.0 / 2.0

Standardversion ohne Rückgabe von Parameter Code

1.x / 2.x

mit RefNr (gilt für alle Versionen außer 1.0)

Credit

1.0 / 2.0

Standardversion ohne Rückgabe von Parameter Code

1.x / 2.x

mit RefNr (gilt für alle Versionen außer 1.0)

Beschreibung der möglichen Batch-Versionen

Der Aufbau für eine Zahlung mit PayU in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

1
HEAD,<MerchantID>,<Date>,<Version>
2
PayU,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
3
PayU,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
4
FOOT,<CountRecords>,<SumAmount>

Beispiel für Master-MID-Funktion:

1
HEAD,[Master]MerchantID,Date,2.x
2
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
3
FOOT,CountRecords,SumAmount

Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet werden:

KeyFormatCNDDescription

Type

a..11

M

HEAD für Header, FOOT für Footer, PayU für PayU

Action

a..20

M

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

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, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

TransID

ans..64

M

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

PayID

an32

M

Vom Paygate vergebene ID für diese Transaktion

Beschreibung der Felder im Datensatz von Batch-Dateien

Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:

1
HEAD,<MerchantID>,<Date>,<Version>
2
PayU,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
3
PayU,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
4
FOOT,<CountRecords>,<SumAmount>

Die folgende Tabelle beschreibt die Antwort-Parameter, die der Batch-Manager im Record-Bereich zu jeder Transaktion speichert (hier nicht erklärte Standardparameter wie etwa <TransID> oder <RefNR> und Aufrufparameter werden unverändert zum Aufruf wieder zurückgegeben und sind vorstehend beschrieben):

KeyFormatCNDDescription

Action

a..20

M

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

PayID

an32

M

Vom Paygate vergebene ID für diese Transaktion

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Code

an8

M

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

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien

Paygate

Documentation (EN)

Dokumentation (DE)

Paygate Status