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

Diagramm zum Prozessablauf

Image Removed

Diagramm zum Prozessablauf

eine Zahlung mit PayU CEE Single Prozessablauf

Multiexcerpt include
SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording

-Schnittstelle

Zahlung mit PayU CEE Single via Formular-Schnittstelle

Um eine Zahlung mit PayU CEE Single über ein

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

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:

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

Produktname,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 der Parameter AuthCode übergeben werden. Wird dieser nicht übergeben, wird der Kunde auf eine entsprechende Seite weitergeleitet.

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

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:

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

Parameter für Zahlungen mit PayU CEE Single

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

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:

Layout-Parameter für

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

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

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:

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

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 vorangegangenen Buchung beschränkt.

Um eine Gutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:

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

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

Parameter für Storno von Zahlungen 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:

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:

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

Vom Händler initial vergebene ID für den zu buchenden Zahlungsvorgang

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

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:

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:

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

Vom Händler initial vergebene ID für den gutzuschreibenden Zahlungsvorgang

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.

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:

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

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

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

Vom Paygate vergebene ID für die zu stornierende Transaktion

TransID

ans..64

M

ID des Händlers zur Identifizierung des zu stornierenden Zahlungsvorgangs

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

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

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

Zahlungsvorgangs entnehmen können.

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

1.x / 2x.

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>

sieht folgendermaßen aus:

Beispiel für Master-MID-Funktion:

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

(Record) innerhalb der Batch-Datei verwendet werden:

PayID

an32

M

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>

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

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien