Page tree

Search

Skip to end of metadata
Go to start of metadata


Ü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 und Tschechien. Für Ungarn, Rumänien, Russland und Türkei ist die Anbindung PayU CEE GECAD zu verwenden. Dafür gibt es ein separates Handbuch.


Logo

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.

TypGemischte Zahlarten


Diagramm zum Prozessablauf

PayU CEE Single Prozessablauf


Paygate-Schnittstelle

Definitionen

Datenformate:

FormatBeschreibung

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

CND

Bedingung (condition)

M

Pflicht (mandatory)

O

optional

C

bedingt (conditional)


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, rufen Sie folgende URL auf:


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:

Parameter

Format

CND

Beschreibung

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

Transaktionsnummer des Händlers, die eindeutig sein muss

RefNr

ans..30

O

Eindeutige Referenznummer

Amount

n..10

M

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

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217. Derzeit nur PLN und CZK zulässig.

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

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.

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.

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. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData.

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 zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Capture

ans..6

O

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture). AUTO: Buchung sofort nach Autorisierung (Standardwert). MANUAL: Buchung erfolgt durch den Händler. <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 Konto-auszug 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:

Prodkuktname,Einzelpreis,Anzahl

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

Die Summe der Preise 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 an den Helpdesk und an den PayU support.

PayType

ans..4

O

Zu verwendende Zahlungsart. Mögliche Werte stehen in der Liste http://developers.payu.com/en/quick_start.html#introduction_paymenttypes unter Name.

AuthCode

n6

O

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

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 von Händler zu setzender Wert, um Informationen wieder unverschlüsselt zurückzugeben, z.B. die MID

Custom

ans..1024

O

Der Händler kann mehrere Werte durch | getrennt übergeben, die unverschlüsselt durch & getrennt zurückgegeben werden.

Custom=session=123|id=456 wird in der Antwort zu Session=123&id=456

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

C

Telefonnummer des Kunden , verpflichtend im Fall der Zahlungsart TWISTO (PayType=dpcz)

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 Result 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) edie Übergabe, welche Auswirkungen auf das Scoring Result 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) edie Übergabe, welche Auswirkungen auf das Scoring Result 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) edie Übergabe, welche Auswirkungen auf das Scoring Result 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) edie Übergabe, welche Auswirkungen auf das Scoring Result 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 Result haben kann.

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 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 oder URLNotify übergibt. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

Parameter

Format

CND

Beschreibung

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

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

Transaktionsnummer des Händlers

RefNr

ans..30

O

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

n8

M

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

CodeExt

n..10

O

Fehlercode von PayU, wenn mit Computop Support abgesprochen

ErrorText

ans..256

O

Fehlertext von PayU, wenn mit Computop Support abgesprochen

UserData

ans..1024

O

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

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

Plain

ans..50

O

Ein von Händler zu setzender Wert, um Informationen wieder unverschlüsselt zurückzugeben, z.B. die MID

Custom

ans..1024

O

Der Händler kann mehrere Werte durch | getrennt übergeben, die unverschlüsselt durch & getrennt zurückgegeben werden.

Custom=session=123|id=456 wird in der Antwort zu Session=123&id=456

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 via Formular-Schnittstelle

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


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:

Parameter

Format

CND

Beschreibung

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

Transaktionsnummer des Händlers, die 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. PLN Grosz).

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

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.

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.

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. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData.

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 zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

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 Konto-auszug des Kunden.

OrderDesc2

ans..384

O

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

Plain

ans..50

O

Ein von Händler zu setzender Wert, um Informationen wieder unverschlüsselt zurückzugeben, z.B. die MID

Custom

ans..1024

O

Der Händler kann mehrere Werte durch | getrennt übergeben, die unverschlüsselt durch & getrennt zurückgegeben werden.

Custom=session=123|id=456 wird in der Antwort zu Session=123&id=456

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:

Parameter

Format

CND

Beschreibung

Template

ans..20

M

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

M

Formular Hintergrundumgebung:

- URL für ein Hintergrundbild

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

- HTML-Farbname

BGColor

ans..7

M

Formular Hintergrundfarbe:

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

- HTML-Farbname

BGImage

ans..256

M

Formular Hintergrundbild:

- URL für ein Hintergrundbild

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

FColor

ans..6

M

Textfarbe:

- HTML-Farbwert als HEX-Wert oder

- HTML-Farbname

FFace

a..10

M

HTML-Name der Schriftart

FSize

n2

M

Zahl für die Schriftgröße

Language

a2

(enum)

M

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

M

URL für Schaltfläche „Abbrechen“

Center

n1

M

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

tWidth

ans..4

M

Breite der Tabelle für die Eingabe der Kreditkartendaten als Prozent- (50%) oder Pixelwerte (320)

tHeight

ans..4

M

Höhe der Tabelle für die Eingabe der Kreditkartendaten 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 oder URLNotify übergibt. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben:

Parameter

Format

CND

Beschreibung

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

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

Transaktionsnummer des Händlers

RefNr

ans..30

O

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

n8

M

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

CodeExt

n..10

O

Fehlercode von PayU, wenn mit Computop Support abgesprochen

ErrorText

ans..256

O

Fehlertext von PayU, wenn mit Computop Support abgesprochen

UserData

ans..1024

O

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

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

PCNr

n..16

O

Pseudo Card Number: Vom Paygate generierte Zufallszahl, die eine reale Kreditkartennummer repräsentiert. Die Pseudokartennummer (PKN) be-ginnt mit 0, und die letzten 3 Stellen entsprechen denen der realen Kar-tennummer. Die PKN können Sie wie eine reale Kartennummer für Autori-sierung, Buchung und Gutschriften verwenden.

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 YYYYMM

MaskedPan

an..19

O

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 von Händler zu setzender Wert, um Informationen wieder unverschlüsselt zurückzugeben, z.B. die MID

Custom

ans..1024

O

Der Händler kann mehrere Werte durch | getrennt übergeben, die unverschlüsselt durch & getrennt zurückgegeben werden.

Custom=session=123|id=456 wird in der Antwort zu Session=123&id=456

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, rufen Sie folgende URL auf:


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:

Parameter

Format

CND

Beschreibung

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

Transaktionsnummer des Händlers, die eindeutig sein muss

RefNr

ns..30

O

Eindeutige Referenznummer

Amount

n..10

M

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

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

Capture

a..6

O

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture). AUTO: Buchung sofort nach Autorisierung (Standardwert). MANUAL: Buchung erfolgt durch den Händler. <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 zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

OrderDesc

ans..35

M

Beschreibung der gekauften Waren, Einzelpreise usw.

Die ersten 27 Zeichen erscheinen auf dem Konto-auszug des Kunden.

RTF

a1

O

„R“ zur Ausführung von wiederkehrenden Zahlungen

CCNr

n..19

M

Pseudokartennummer

CCExpiry

n6

M

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

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:

Parameter

Format

CND

Beschreibung

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

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

Transaktionsnummer des Händlers

RefNr

ns..30

O

Eindeutige Referenznummer des Händlers

Status

a..30

M

OK, AUTHORIZED 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

n8

M

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

CodeExt

n..10

O

Fehlercode von PayU, wenn mit Computop Support abgesprochen

ErrorText

ans..256

O

Fehlertext von PayU, wenn mit Computop Support 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:


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:

Parameter

Format

CND

Beschreibung

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 Transaktion

TransID

ans..64

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

Amount

n..10

M

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

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currency

a..3

M

Währungskürzel, drei Zeichen DIN / ISO 4217

RefNr

ans..30

O

Eindeutige Referenznummer

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

ReqIDans..32OUm Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

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


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

Parameter

Format

CND

Beschreibung

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

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

Transaktionsnummer des Händlers

Status

a..30

M

OK 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

n8

M

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

RefNr

ans..30

O

Referenznummer des Händlers

CodeExt

n..10

O

Fehlercode von PayU, wenn mit Computop Support abgesprochen

ErrorText

ans..256

O

Fehlertext von PayU, wenn mit Computop Support 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:


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:

Parameter

Format

CND

Beschreibung

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 Transaktion

TransID

ans..64

M

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

Currency

a..3

M

Währungskürzel, drei Zeichen DIN / ISO 4217

RefNr

ans..30

O

Eindeutige Referenznummer

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

OrderDesc

ans..768

O

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

ReqIDans..32OUm Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

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


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

Parameter

Format

CND

Beschreibung

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

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

Transaktionsnummer des Händlers

Status

a..30

M

OK 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

n8

M

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

CodeExt

n..10

O

Fehlercode von PayU, wenn mit Computop Support abgesprochen

ErrorText

ans..256

O

Fehlertext von PayU, wenn mit Computop Support 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:


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

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.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

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

PayID

an32

M

ID des Paygate zur Identifizierung einer Zahlung

TransID

ans..64

M

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

Currency

a3

M

Währungskürzel, drei Zeichen DIN / ISO 4217

MAC

an64

M

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

ReqIDans..32OUm Doppelzahlungen zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion mit derselben ReqID erneut eingereicht wird, führt das Paygate keine Zahlung aus sondern gibt nur den Status der ursprünglichen Transaktion zurück. Bitte beachten Sie, dass das Paygate für die erste initiale Aktion einen abgeschlossenen Transaktionsstatus haben muss. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Parameter für Storno von Zahlungen mit PayU CEE Single


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

Parameter

Format

CND

Beschreibung

MID

ans..30

MC

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

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

Transaktionsnummer des Händlers

Status

a..50

M

OK 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

n8

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:

Aktion

Version

Beschreibung

Capture

1.0 / 2.0

Standardversion ohne Rückgabe von 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 Code

 

1.x / 2x.

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:

HEAD,<MerchantID>,<Date>,<Version>

PayU,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>

PayU,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>

FOOT,<CountRecords>,<SumAmount>


Beispiel für Master MID Funktion:

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


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

Parameter

Format

CND

Beschreibung

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

Currency

a3

M

Währungskürzel, drei Zeichen DIN / ISO 4217

TransID

ans..64

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ns..30

O

eindeutige Referenznummer

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:

HEAD,<MerchantID>,<Date>,<Version>

PayU,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>

PayU,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>

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

Parameter

Format

CND

Beschreibung

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

Code

n8

M

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

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien