Über PayU CEE GECAD

Allgemeines zu Zahlungsmethoden via PayU CEE GECAD

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


Logo

Info

Der E-Commerce in den wachstumsstarken Länder Osteuropas lässt sich durch die Integration der Plattform PayU CEE GECAD ideal ansprechen: die beliebtesten Zahlarten in Ländern wie Ungarn, Rumänien, Russland oder der Türkei stehen dadurch zur Verfügung. Rund 300 Mio. Einwohner mit einer Internet-Nutzungsrate von durchschnittlich etwa 60% bilden einen attraktiven Markt für die Ausweitung des internationalen Geschäfts in Richtung Osten.

TypGemischte Zahlarten

Diagramme zum Prozessablauf

PayU CEE GECAD Prozessablauf


Prozessablauf PayU CEE GECAD über die Formular-Schnittstelle payssl.aspx


Prozessablauf PayU CEE GECAD über die Server-zu-Server-Schnittstelle direct.aspx


Konfiguration für PayU CEE GECAD

Zur Konfiguration von PayU CEE GECAD sind im Backend von PayU ein paar Einstellungen vorzunehmen. Der Aufruf des Backends erfolgt in jedem Land zunächst über die entsprechende URL:

Rumänien: https://secure.payu.ro/cpanel/

Russland: https://secure.payu.ru/cpanel/

Ungarn: https://secure.payu.hu/cpanel/

Türkei: https://secure.payu.com.tr/cpanel/

Aktivieren Sie bei System settings das Register Account settings. Im Abschnitt der Notifications muss IPN oder Email Text & IPN ausgewählt werden. Zudem müssen die Optionen Canceled and returned orders sowie Complete orders aktiviert werden.

Wechseln Sie nun zum Register IPN settings. Im Feld URL tragen Sie den angepassten Link in der Form https://www.computop-paygate.com/payuceecomplete.aspx?merchantid=MID ein, wobei Sie die eigene MID verwenden müssen.

Weiterhin müssen die Parameter REFNO, REFNOEXT, ORDERSTATUS, IPN_TOTALGENERAL und CURRENCY aktiviert sein.

Im Backend von PayU CEE GECAD können zusätzliche Parameter angelegt werden. Diese werden auf der Bezahlseite angezeigt und können/müssen vom Kunden ausgefüllt werden.

Wenn in den IPN Settings Customfields ausgewählt ist, werden diese Parameter durch das Paygate an Händler weitergegeben.


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

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

Um eine Zahlung mit PayU CEE GECAD abzuwickeln, 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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

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.

Key

Format

CND

Description

Beschreibung

Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only TRY, RON, EUR and USD permitted. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur TRY, RON, EUR und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
URLSuccess

ans..256

M

Complete URL which calls up Paygate if payment has been successful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData.

(info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

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.

(info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von 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 senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

KeyFormatCNDDescriptionBeschreibung
URLFailure

ans..256

M

Complete URL which calls up Paygate if payment has been unsuccessful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData.

(info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

Vollständige URL, die das Paygateaufruft, 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.

(info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von 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.

KeyFormatCNDDescriptionBeschreibung
Response

a7

O

Status response sent by Paygate to URLSuccess and URLFailure, should be encrypted. For this purpose, transmit Response=encrypt parameter.

Die Status-Rückmeldung, die das Paygate an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt.

KeyFormatCNDDescriptionBeschreibung
URLNotify

ans..256

M

Complete URL which Paygate calls up in order to notify the shop about the payment result. The URL may be called up only via port 443. It may not contain parameters: Use the UserData parameter instead.

(info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

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.

(info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von 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.

KeyFormatCNDDescriptionBeschreibung
UserData

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

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

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

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.

KeyFormatCNDDescriptionBeschreibung
Capture

an..6

OM

Determines the type and time of capture.

Capture ModeDescription
AUTOCapturing immediately after authorisation (default value).
MANUALCapturing made by the merchant. Capture is normally initiated at time of delivery.
<Number>Delay in hours until the capture (whole number; 1 to 696).

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

BuchungsartBeschreibung
AUTOBuchung sofort nach Autorisierung (Standardwert).
MANUALBuchung erfolgt durch den Händler - in der Regel die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.
<Zahl>Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

Key

Format

CND

Description

Beschreibung

OrderDesc

ans..768

M

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise usw.

ArticleList(n)

ans..2048

M

Customer’s article list in the form:

Articlelist(n)= ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+…

Articlelist1 to max. Articlelist10 permissible

The ArticleCode hast to be one-to-one because otherwise identical article numbers will be overwritten by PayU and not added. Thereby the total amount of trasaction could be changed by mistake.

Example:

Articlelist1=article1,123456,100,1,16,GROSS+article2,321654,200,2,16,NET

Articlelist2=article3,987654,100,2,16,GROSS+article4,654231,150,1,16,NET

The amount must be equal to the sum of the amounts in ArticleList, i.e. in the sample above: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 1 x 150)

Artikelliste des Kunden in der Form:

Articlelist(n)= Artikelname,ArtikelCode,Einzelpreis,Anzahl,Umsatzsteuersatz,Typ+Artikelname,ArtikelCode,Einzelpreis, Anzahl,Umsatzsteuersatz,Typ+…

Articlelist1 bis max. Articlelist10 zulässig

Der ArtikelCode muss eineindeutig sein, da ansonsten identische Artikelnummern seitens PayU überschrieben und nicht addiert werden. Dadurch könnte sich fälschlicherweise der Gesamtbetrag der Transaktion ändern.

Beispiel:

Articlelist1=artikel1,123456,100,1,16,GROSS+artikel2,321654,200,2,16,NET

Articlelist2=artikel3,987654,100,2,16,GROSS+artikel4,654231,150,1,16,NET

Der Amount muss mit der Summe der Artikelbeträge übereinstimmen, d.h. im obigen Beispiel: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 150)

Discount

n..10

O

Discount in the smallest currency unit

Nachlass in der kleinsten Währungseinheit

ChargeAmount

n..10

O

Shipping costs. Amount in the smallest currency unit (e.g. EUR Cent)

Versandkosten. Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).

AutoStart

bool

O

If you transfer the value 1 here you bypass the first page in the PayU-process. Important: This is possible only, if all necessary parameters are transferred.

Wenn Sie hier den Wert 1 übergeben, überspringen Sie die erste Seite im PayU-Prozess. Wichtig: Das ist nur möglich, wenn alle nötigen Parameter übergeben werden.

Language

a2

O

Language:

RO – Romanian

EN – English

HU – Hungarian

DE – German

FR – French

IT – Italian

ES – Spanish

BG – Bulgarian

PL – Polish

RU – Russian

Sprache

RO – Rumänisch

EN – Englisch

HU – Ungarisch

DE – Deutsch

FR – Französisch

IT – Italienisch

ES – Spanisch

BG – Bulgarisch

PL – Polnisch

RU – Russisch

PayType

ans..25

M

Name of payment method to be executed

Possible values for Romania:

<Card> - VISA/MasterCard

Installment payments:

<BRDF> – BRDFinance Installment
<STAR_BT> – Banca Transilvania’s StarBT
<CARD_AVANTAJ> – Credit Europe’s CardAvantaj
<ALPHABANK> – Alpha Bank

Online bank transfers:

<TRANSFER_ING> – Internet banking with ING Home Bank
<ITRANSFER_BCR> – Internet banking with Click24 Banking BCR
<ITRANSFER_BT> – Internet banking with BT24

Other:

<ZEBRA> – cash deposit with ZebraPay Self Service
<PAYPAL> – PayPal payments
<WIRE> – Bank Wire


Possible values for Turkey:

<Card> - VISA/MasterCard

Other:

<WEBMONEY>
<QIWI>
<MAILRU>
<YANDEX> (not valid for new customers)
<EUROSET_SVYAZNOI>
<ALFACLICK>
<BKM>

Value for merchants which have activated this method:

<MASTERPASS>

Note: If PayType is used, then parameter bdCountryCode becomes mandatory.

Name der auszuführenden Zahlungsart

Mögliche Werte für Rumänien:

<Card> - VISA/MasterCard

Ratenzahlungen:

<BRDF> – BRDFinance Installment
<STAR_BT> – Banca Transilvania’s StarBT
<CARD_AVANTAJ> – Credit Europe’s CardAvantaj
<ALPHABANK> – Alpha Bank

Online-Überweisungen:

<TRANSFER_ING> – Internet banking with ING Home Bank
<ITRANSFER_BCR> – Internet banking with Click24 Banking BCR
<ITRANSFER_BT> – Internet banking with BT24

Sonstige:

<ZEBRA> – Bareinzahlung bei ZebraPay Self Service
<PAYPAL> – PayPal-Zahlungen
<WIRE> – Bank Wire


Mögliche Werte für Türkei:

<Card> - VISA/MasterCard

Sonstige:

<WEBMONEY>
<QIWI>
<MAILRU>
<YANDEX> (Gilt nicht für neue Kunden)
<EUROSET_SVYAZNOI>
<ALFACLICK>
<BKM>

Wert für Händler, die diese Methode aktiviert haben:

<MASTERPASS>

Hinweis: Wenn PayType verwendet wird, ist der Parameter bdCountryCode Pflicht.

InstallmentData

ans..24

OC

Only for Channel=RO: Preconfiguration of possible number of rates

Default value is the configuration from the PayU system

„2,3,4,5,6,7,8,9,10,11,12“ –

All are displayed for choosing

„2,3,7,10,12“ – 2,3,7,10,12 are displayed for choosing

„2“– only 2 is displayed as an option

„1„ – no installments possible

Nur bei Channel=RO: Vorbelegung der möglichen Ratenanzahl

Standard ist die Konfiguration aus dem PayU System

„2,3,4,5,6,7,8,9,10,11,12“ –

Alle werden als Option zur Auswahl angezeigt

„2,3,7,10,12“ – 2,3,7,10,12 werden als Option zur Auswahl angezeigt

„2“– nur 2 wird als Option zur Auswahl angezeigt

„1„ – keine Ratenzahlung möglich

InstallmentNumber

n..2

OC

Only for Channel=TR: Number of months of the payment by instalments (1-12)

Nur bei Channel=TR: Anzahl Monate der Ratenzahlung (1-12)

Timeout

n..3

O

Validity of transaction in seconds

Gültigkeit der Transaktion in Sekunden

Channel

a2

O

Channel (country) of payment (the default channel will be configured by Computop Helpdesk):

RO = Romania

TR = Turkey

RU = Russian Federation

HU = Hungary

UA = Ukraine

Kanal (Land) der auszuführenden Zahlung (der Standardkanal wird vom Computop konfiguriert):

RO = Rumänien

TR = Türkei

RU = Russland

HU = Ungarn

UA = Ukraine

KeyFormatCNDDescriptionBeschreibung
Plain

ans..50

O

A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. 

"Plain"-parameter is part of encrypted "Data" in Computop Paygate and therefore protected against manipulation. 

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. 

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the Computop Paygate response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

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

Key

Format

CND

Description

Beschreibung




Billing address (PayU)Rechnungsadresse (PayU)

bdFirstName

ans..128

M

First name of the customer

Vorname des Kunden

bdLastName

ans..128

M

Last name of the customer

Nachname des Kunden

bdStreet

ans..46

O

Street name in the invoicing address

Straßenname der Rechnungsadresse

bdAddressAddition

ans..60

O

Address addition in the billing address

Adresszusatz der Rechnungsadresse

bdCity

ans..40

O

Name of town/city in the billing address

Ortsname der Rechnungsadresse

bdZip

ans..8

O

Postcode in the invoicing address

Postleitzahl der Rechnungsadresse

bdState

ans..50

O

Federal state in the invoicing address

Bundesland der Rechnungsadresse

bdCountryCode

a2

OC

Country code in the invoicing address according to ISO 3166. Mandatory if PayType is submitted.

Ländercode der Rechnungsadresse gemäß ISO 3166. Pflicht, wenn PayType angegeben ist.

bdFax

ans..20

O

Customer’s fax number

Faxnummer des Kunden

bdeMail

ans..128

M

Email address of the customer

E-Mail-Adresse des Kunden

bdPhone

ans..40

O

Customer’s phone number

Telefonnummer des Kunden

IdCardSeries

ans..3

O

Series of ID card

Serie des Personalausweises

IdCardNumber

ans..20

O

Serial number of ID card

Seriennummer des Personalausweises

IdCardIssuer

ans..128

O

Issuer of ID card

Aussteller des Personalausweises

NatIdentNr

ans..20

O

CNP of the customer

CNP des Kunden

CompanyName

ans..200

O

Name of company

Firmenname

TaxNumber

ans..20

O

VAT Reg. No.

Umsatzsteueridentifikationsnummer

RegisterNumber

ans..20

O

Register of Companies number/commercial register

Handelsregisternummer/Firmenbuch

AccBank

ans..20

O

Bank name of the company

Bankname der Firma

AccNr

ans..20

O

Account number of the company

Kontonummer der Firma




Delivery addressLieferadresse

sdFirstName

ans..128

O

First name in the delivery address

Vorname in der Lieferanschrift

sdLastName

ans..128

O

Surname in the delivery address

Nachname in der Lieferanschrift

sdStreet

ans..46

O

Street name in the delivery address

Straßenname in der Lieferanschrift

sdAddressAddition

ans..60

O

Address addition in the delivery address

Adresszusatz der Lieferanschrift

sdCity

ans..40

O

Town/city in the delivery address

Ortsname in der Lieferanschrift

sdZip

ans..8

O

Postcode in the delivery address

Postleitzahl in der Lieferanschrift

sdState

ans..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

sdCountryCode

a2

O

Country code in the delivery address according to ISO 3166

Ländercode in der Lieferadresse gemäß ISO 3166

sdeMail

ans..128

O

Email address in the delivery address

E-Mail-Adresse in der Lieferanschrift

sdPhone

ans..40

O

Phone number in the delivery address

Telefonnummer in der Lieferanschrift

Parameter für Zahlungen mit PayU CEE GECAD


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:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

Key

Format

CND

Description

Beschreibung

Statusa..30M

OK, FAILED or AUTHORIZE_REQUEST.

If 25 seconds after the redirect to CallBack page no notify is received from PayU, the status “AUTHORIZE_REQUEST”, Code “00000000” and Description ”REQUEST” is submitted to the URLSuccess.

Please note, the status “AUTHORIZE_REQUEST” will be sent only to URLSuccess and there is no call of URLNotify.

Should Computop Paygate receive a further final PayU status for this open payment, it will be sent separately via URLNotify. If you don't want to process a separate final status via URLNotify this open payment can be cancelled via calling reverse.aspx and should PayU nevertheless receive a revenue this will automatically be refunded to the customer.

OK, FAILED oder AUTHORIZE_REQUEST.

Sollte 25 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.

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

CodeExtn..10O

Error code from PayU, if agreed with Computop Helpdesk

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..256O

Error text from PayU, if agreed with Computop Helpdesk

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

KeyFormatCNDDescriptionBeschreibung
UserData

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

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

KeyFormatCNDDescriptionBeschreibung
Plain

ans..50

O

A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. 

"Plain"-parameter is part of encrypted "Data" in Computop Paygate and therefore protected against manipulation. 

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. 

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the Computop Paygate response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

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

Ergebnis-Parameter für URLSuccess und URLFailure bei PayU CEE GECAD


Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate an URLNotify übergibt:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

CodeExtn..10O

Error code from PayU, if agreed with Computop Helpdesk

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..256O

Error text from PayU, if agreed with Computop Helpdesk

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

KeyFormatCNDDescriptionBeschreibung
UserData

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

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

KeyFormatCNDDescriptionBeschreibung
Plain

ans..50

O

A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. 

"Plain"-parameter is part of encrypted "Data" in Computop Paygate and therefore protected against manipulation. 

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. 

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the Computop Paygate response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

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

Key

Format

CND

Description

Beschreibung

AmountAuth

n..10

M

Actually authorized amount in the smallest currency unit

Tatsächlich autorisierter Betrag in der kleinsten Währungseinheit

Currency

a3

M

Currency, three digits DIN / ISO 4217

Währung, drei Zeichen DIN / ISO 4217

TransactionID

ans..25

O

RefNr from PayU system

RefNr des PayU-Systems

PayType

ans..25

M

Name of used payment method (see above for possible values)

Name der genutzten Zahlungsart (Für mögliche Werte siehe oben)

bdFirstName

ans..128

O

First name of the customer

Vorname des Kunden

bdLastName

ans..128

O

Last name of the customer

Nachname des Kunden

bdStreet

ans..46

O

Street name in the invoicing address

Straßenname der Rechnungsadresse

bdAddressAddition

ans..60

O

Address addition in the billing address

Adresszusatz der Rechnungsadresse

bdCity

ans..40

O

Name of town/city in the billing address

Ortsname der Rechnungsadresse

bdZip

ans..8

O

Postcode in the invoicing address

Postleitzahl der Rechnungsadresse

bdState

ans..50

O

Federal state in the invoicing address

Bundesland der Rechnungsadresse

bdCountryCode

a2

OC

Country code in the invoicing address according to ISO 3166. Mandatory if PayType is submitted.

Ländercode der Rechnungsadresse gemäß ISO 3166. Pflicht, wenn PayType angegeben ist.

bdFax

ans..20

O

Customer’s fax number

Faxnummer des Kunden

bdeMail

ans..128

M

Email address of the customer

E-Mail-Adresse des Kunden

bdPhone

ans..40

O

Customer’s phone number

Telefonnummer des Kunden

IdCardSeries

ans..3

O

Series of ID card

Serie des Personalausweises

IdCardNumber

ans..20

O

Serial number of ID card

Seriennummer des Personalausweises

IdCardIssuer

ans..128

O

Issuer of ID card

Aussteller des Personalausweises

NatIdentNr

ans..20

O

CNP of the customer

CNP des Kunden

CompanyName

ans..200

O

Name of company

Firmenname

TaxNumber

ans..20

O

VAT Reg. No.

Umsatzsteueridentifikationsnummer

RegisterNumber

ans..20

O

Register of Companies number/commercial register

Handelsregisternummer/Firmenbuch

AccBank

ans..20

O

Bank name of the company

Bankname der Firma

AccNr

ans..20

O

Account number of the company

Kontonummer der Firma

sdFirstName

ans..128

O

First name in the delivery address

Vorname in der Lieferanschrift

sdLastName

ans..128

O

Surname in the delivery address

Nachname in der Lieferanschrift

sdStreet

ans..46

O

Street name in the delivery address

Straßenname in der Lieferanschrift

sdAddressAddition

ans..60

O

Address addition in the delivery address

Adresszusatz der Lieferanschrift

sdCity

ans..40

O

Town/city in the delivery address

Ortsname in der Lieferanschrift

sdZip

ans..8

O

Postcode in the delivery address

Postleitzahl in der Lieferanschrift

sdState

ans..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

sdCountryCode

a2

O

Country code in the delivery address according to ISO 3166

Ländercode in der Lieferadresse gemäß ISO 3166

sdeMail

ans..128

O

Email address in the delivery address

E-Mail-Adresse in der Lieferanschrift

sdPhone

ans..40

O

Phone number in the delivery address

Telefonnummer in der Lieferanschrift

CustomParameter

ans..

O

If additional parameters are configured in the PayU backend these are returned with the prefix “custom_”; e.g. PayU Parameter = age = custom_age

Wenn im BackEnd von PayU zusätzliche Parameter konfiguriert wurden, werden diese mit dem Zusatz „custom_“ zurückgegeben; z.B. PayU Parameter = age = custom_age

InstallmentNumber

n..2

O

Number of months of the payment by instalments (1-12), default=1

Anzahl Monate der Ratenzahlung (1-12), Standard=1

CardProgram

ans..25

O

Name of the card programme which allows the instalment payment (see table of card programmes)

Name des Kartenprogramms, das die Ratenzahlung erlaubt (siehe Tabelle der Kartenprogramme)

Ergebnis-Parameter für URLNotify bei PayU CEE GECAD


Folgende Tabelle gibt eine Übersicht unterstützter Kartenprogramme für Ratenzahlungen. Beachten Sie bitte, dass neue Programme hinzukommen und die teilnehmenden Banken sich ändern können.

Kartenprogramm

Aussteller

Advantage

T. İŞ BANKASI A.Ş.

AsyaCard

ASYA KATILIM BANKASI A.Ş.

Axess

AKBANK T.A.Ş.
CITIBANK A.Ş.
ODEA BANK A.Ş.

Bonus

TÜRK EKONOMİ BANKASI A.Ş.
ŞEKERBANK T.A.Ş.
T.GARANTİ BANKASI A.Ş.
ING BANK A.Ş.
DENİZBANK A.Ş.
TÜRKİYE FİNANS

Cardfinans

FİNANS BANK A.Ş.

Maximum

T.C.ZİRAAT BANKASI A.Ş.
T. İŞ BANKASI A.Ş.

Paraf

T.HALK BANKASI A.Ş.

World

T.VAKIFLAR BANKASI T.A.O.
YAPI VE KREDİ BANKASI A.Ş.
ANADOLUBANK A.Ş.
ALBARAKA TÜRK

Unterstützte Kartenprogramme für Ratenzahlungen



Kreditkartenzahlung mit PayU CEE GECAD via Formular-Schnittstelle

Um eine SSL-Kreditkartenzahlung mit PayU CEE GECAD über ein Formular 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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key

Format

CND

Description

Beschreibung

RefNr

ans..30

M

Unique reference number which appears on your printed card account or in the EPA-file (Electronic Payment Advice). Format must be mutually agreed beforehand with Computop!

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

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

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.

Key

Format

CND

Description

Beschreibung

Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only TRY, RON, EUR and USD permitted. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur TRY, RON, EUR und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
URLSuccess

ans..256

M

Complete URL which calls up Paygate if payment has been successful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData.

(info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

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.

(info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von 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 senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

KeyFormatCNDDescriptionBeschreibung
URLFailure

ans..256

M

Complete URL which calls up Paygate if payment has been unsuccessful. The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values between Paygate and shop, please use the parameter UserData.

(info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

Vollständige URL, die das Paygateaufruft, 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.

(info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von 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.

KeyFormatCNDDescriptionBeschreibung
Response

a7

O

Status response sent by Paygate to URLSuccess and URLFailure, should be encrypted. For this purpose, transmit Response=encrypt parameter.

Die Status-Rückmeldung, die das Paygate an URLSuccess und URLFailure sendet, sollte verschlüsselt werden. Dazu übergeben Sie den Parameter Response=encrypt.

KeyFormatCNDDescriptionBeschreibung
URLNotify

ans..256

M

Complete URL which Paygate calls up in order to notify the shop about the payment result. The URL may be called up only via port 443. It may not contain parameters: Use the UserData parameter instead.

(info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

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.

(info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von 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.

KeyFormatCNDDescriptionBeschreibung
UserData

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

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

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

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.

KeyFormatCNDDescriptionBeschreibung
Capture

an..6

OM

Determines the type and time of capture.

Capture ModeDescription
AUTOCapturing immediately after authorisation (default value).
MANUALCapturing made by the merchant. Capture is normally initiated at time of delivery.
<Number>Delay in hours until the capture (whole number; 1 to 696).

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

BuchungsartBeschreibung
AUTOBuchung sofort nach Autorisierung (Standardwert).
MANUALBuchung erfolgt durch den Händler - in der Regel die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.
<Zahl>Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

Key

Format

CND

Description

Beschreibung

OrderDesc

ans..768

M

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise usw.

ArticleList(n)

ans..2048

M

Customer’s article list in the form:

Articlelist(n)= ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+…

Articlelist1 to max. Articlelist10 permissible

The ArticleCode hast to be one-to-one because otherwise identical article numbers will be overwritten by PayU and not added. Thereby the total amount of trasaction could be changed by mistake.

Example:

Articlelist1=article1,123456,100,1,16,GROSS+article2,321654,200,2,16,NET

Articlelist2=article3,987654,100,2,16,GROSS+article4,654231,150,1,16,NET

The amount must be equal to the sum of the amounts in ArticleList, i.e. in the sample above: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 1 x 150)

Artikelliste des Kunden in der Form:

Articlelist(n)= Artikelname,ArtikelCode,Einzelpreis,Anzahl,Umsatzsteuersatz,Typ+Artikelname,ArtikelCode,Einzelpreis, Anzahl,Umsatzsteuersatz,Typ+…

Articlelist1 bis max. Articlelist10 zulässig

Der ArtikelCode muss eineindeutig sein, da ansonsten identische Artikelnummern seitens PayU überschrieben und nicht addiert werden. Dadurch könnte sich fälschlicherweise der Gesamtbetrag der Transaktion ändern.

Beispiel:

Articlelist1=artikel1,123456,100,1,16,GROSS+artikel2,321654,200,2,16,NET

Articlelist2=artikel3,987654,100,2,16,GROSS+artikel4,654231,150,1,16,NET

Der Amount muss mit der Summe der Artikelbeträge übereinstimmen, d.h. im obigen Beispiel: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 150)

ChargeAmount

n..10

O

Shipping costs. Amount in the smallest currency unit (e.g. EUR Cent).

Versandkosten. Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).

Channel

a2

O

Channel (country) of payment (the default channel will be configured by Computop):

RO = Romania

TR = Turkey

RU = Russian Federation

HU = Hungary

UA = Ukraine

Kanal (Land) der auszuführenden Zahlung (der Standardkanal wird vom Computop konfiguriert):

RO = Rumänien

TR = Türkei

RU = Russland

HU = Ungarn

UA = Ukraine

KeyFormatCNDDescriptionBeschreibung
Plain

ans..50

O

A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. 

"Plain"-parameter is part of encrypted "Data" in Computop Paygate and therefore protected against manipulation. 

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. 

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the Computop Paygate response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

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

Key

Format

CND

Description

Beschreibung




Installments (PayU)Ratenzahlung (PayU)

InstallmentNumber

n..2

O

Number of months of the payment by instalments (1-12), default=1

Anzahl Monate der Ratenzahlung (1-12), Standard=1

CardProgram

ans..25

O

Name of the card programme which allows the instalment payment (see table of card programmes)

Name der Kartenprogramms, welches die Ratenzahlung erlaubt (siehe Tabelle der Kartenprogramme)

Campaign

a5

O

Defines the campaign to be used for the instalments.

Extra=EXTRA_INSTALLMENTS

Delay=DELAY_INSTALLMENTS

Legt die zu verwendende Kampagne für Ratenzahlung fest.

Extra=EXTRA_INSTALLMENTS

Delay=DELAY_INSTALLMENTS




Loyalty points (PayU)Loyalty points (PayU)
PointAmountn..10OAmount of the Loyalty points to be used in the smallest currency unitAnzahl der zu nutzenden Loyalty-Punkte in der kleinsten Währungseinheit



Billing address (PayU)Rechnungsadresse (PayU)

bdFirstName

ans..128

M

First name of the customer

Vorname des Kunden

bdLastName

ans..128

M

Last name of the customer

Nachname des Kunden

bdStreet

ans..46

O

Street name in the invoicing address

Straßenname der Rechnungsadresse

bdAddressAddition

ans..60

O

Address addition in the billing address

Adresszusatz der Rechnungsadresse

bdCity

ans..40

O

Name of town/city in the billing address

Ortsname der Rechnungsadresse

bdZip

ans..8

O

Postcode in the invoicing address

Postleitzahl der Rechnungsadresse

bdState

ans..50

O

Federal state in the invoicing address

Bundesland der Rechnungsadresse

bdCountryCode

a2

M

Country code in the invoicing address according to ISO 3166

Ländercode der Rechnungsadresse gemäß ISO 3166

bdFax

ans..20

O

Customer’s fax number

Faxnummer des Kunden

bdeMail

ans..128

M

Email address of the customer

E-Mail-Adresse des Kunden

bdPhone

ans..40

O

Customer’s phone number

Telefonnummer des Kunden




Delivery addressLieferadresse

sdFirstName

ans..128

O

First name in the delivery address

Vorname in der Lieferanschrift

sdLastName

ans..128

O

Surname in the delivery address

Nachname in der Lieferanschrift

sdStreet

ans..46

O

Street name in the delivery address

Straßenname in der Lieferanschrift

sdAddressAddition

ans..60

O

Address addition in the delivery address

Adresszusatz der Lieferanschrift

sdCity

ans..40

O

Town/city in the delivery address

Ortsname in der Lieferanschrift

sdZip

ans..8

O

Postcode in the delivery address

Postleitzahl in der Lieferanschrift

sdState

ans..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

sdCountryCode

a2

O

Country code in the delivery address according to ISO 3166

Ländercode in der Lieferadresse gemäß ISO 3166

sdeMail

ans..128

O

Email address in the delivery address

E-Mail-Adresse in der Lieferanschrift

sdPhone

ans..40

O

Phone number in the delivery address

Telefonnummer in der Lieferanschrift

Parameter für Kreditkartenzahlungen mit PayU CEE GECAD


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

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung
Template

ans..20

O

Name of XSLT-file with your own layout for the pay form. If you want to use the redesigned and downwards compatible Computop template, please transfer the template name “ct_compatible”. If you want to use the responsive Computop template for mobile devices, please transfer the template name “ct_responsive”.

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

KeyFormatCNDDescriptionBeschreibung
Background

ans..256

O

Background ambiance of form:

URL for a background image

- HTML-colour value for background colour as HEX value or

- HTML-colour name

Formular Hintergrundumgebung:

- URL für ein Hintergrundbild

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

- HTML-Farbname

KeyFormatCNDDescriptionBeschreibung
BGColor

ans..7

O

Form background colour:

- HTML-colour value for background colour as HEX value or

- HTML-colour name

Formular Hintergrundfarbe:

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

- HTML-Farbname

KeyFormatCNDDescriptionBeschreibung
BGImage

ans..256

O

Form background image:

URL for a background image

Please note that this value supersedes “BGColor”.

Formular Hintergrundbild:

URL für ein Hintergrundbild

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

KeyFormatCNDDescriptionBeschreibung
FColor
ans..7
O

Text colour:

- HTML-colour value as HEX value or

- HTML-colour name

Textfarbe:

- HTML-Farbwert als HEX-Wert oder

- HTML-Farbname

KeyFormatCNDDescriptionBeschreibung
FFace
a..10
O
HTML-name for the font

HTML-Name der Schriftart

KeyFormatCNDDescriptionBeschreibung
FSize
n2
O
Number for font size

Zahl für die Schriftgröße

Key

Format

CND

Description

Beschreibung

Language

a2

(enum)

M

Language code: <de> German, <al> Albanian, <at> Austrian, <cz/cs> Czech, <dk> Danish, <en> English, <fi> Finish, <fr> French, <gr> Greek, <hu> Hungarian, <it> Italian, <jp> Japanese,  <nl> Dutch, <no> Norwegian, <pl> Polish, <pt> Portuguese, <ro> Romanian, <ru> Russian, <sp> Spanish, <se> Swedish, <sk> Slovakian, <sl> Slovenian, <tr> Turkey, <zh> Simplified Chinese.

No details means the language is German.

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, <tr> türkisch, <sp> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> türkisch, <zh> Simplified Chinese

Ohne Angabe ist die Sprache Deutsch.

CCSelecta..10MDetermines preselected card type in the form: VISA, MasterCardBestimmt die vorausgewählte Kartenmarke im Formular: VISA, MasterCard

KeyFormatCNDDescriptionBeschreibung
URLBack

ans..256

O

Complete URL which Paygate calls in case that Cancel is clicked by the customer.

The parameter "URLBack" can be sent

  • either as plain parameter (unencrypted) (compatibility mode)
  • or be part of encrypted payment request parameters (preferred mode)

In order to exchange values between Paygate and shop you may use something like this:

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

When user cancels payment this URL is called exactly like this and you may use URL Decode to extract parameter and values.

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:

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.

KeyFormatCNDDescriptionBeschreibung
Center

n1

O
By default the form is centered vertically and horizontally. The value <1> centres the form at the top.

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

KeyFormatCNDDescriptionBeschreibung
tWidth

ans..4

O
Width of table for input in the form as percent- (50%) or pixel values (320).

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

KeyFormatCNDDescriptionBeschreibung
tHeight

ans..4

O
Height of table for input of the payment data in the form as percent- (70%) or pixel values (480).

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 GECAD


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:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

Key

Format

CND

Description

Beschreibung

Statusa..30M

OK, FAILED or AUTHORIZE_REQUEST.

If 25 seconds after the redirect to CallBack page no notify is received from PayU, the status “AUTHORIZE_REQUEST”, Code “00000000” and Description ”REQUEST” is submitted to the URLSuccess.

Please note, the status “AUTHORIZE_REQUEST” will be sent only to URLSuccess and there is no call of URLNotify.

Should Computop Paygate receive a further final PayU status for this open payment, it will be sent separately via URLNotify. If you don't want to process a separate final status via URLNotify this open payment can be cancelled via calling reverse.aspx and should PayU nevertheless receive a revenue this will automatically be refunded to the customer.

OK, FAILED oder AUTHORIZE_REQUEST.

Sollte 25 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.

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung

CodeExtans..10O

Error code from PayU, if agreed with Computop Helpdesk

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..256O

Error text from PayU, if agreed with Computop Helpdesk

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

KeyFormatCNDDescriptionBeschreibung
UserData

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

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

KeyFormatCNDDescriptionBeschreibung
PCNr

n16

O

Pseudo Card Number: Random number generated by Computop Paygate which represents a genuine credit card number. The pseudo card number (PCN) starts with 0 and the last 3 digits correspond to those of the real card number. The PCN can be used like a genuine card number for authorisation, capture and credits.

PCNr is a response value from Computop Paygate and is sent as CCNr in Request or part of card-JSON

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 von Computop Paygate und kann ebenfalls als CCNr im Request oder als Teil von card-JSON verwendet werden.

Key

Format

CND

Description

Beschreibung

CCBrand

a..22

O

In combination with PCNr: Name of credit card brand like Visa, MasterCard

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

CCExpiry

n6

O

In combination with PCNr: Expiry date of the credit card in the format YYYYMM.

In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM

AmountAuth

n..10

MC

Only to URLNotify: Actually authorized amount in the smallest currency unit. For installment payments the charges are added automatically to the initial amount.

Nur an URLNotify: Tatsächlich autorisierter Betrag in der kleinsten Währungseinheit. Bei Ratenzahlungen werden automatisch die Gebühren zum ursprünglichen Betrag addiert.

Currency

a3

MC

Only to URLNotify: Currency, three digits DIN / ISO 4217

Nur an URLNotify: Währung, drei Zeichen DIN / ISO 4217

InstallmentNumber

n..2

OC

Only to URLNotify: Number of months of the payment by instalments (1-12), default=1

Nur an URLNotify: Anzahl Monate der Ratenzahlung (1-12), Standard=1

CardProgram

ans..25

OC

Only to URLNotify: Name of the card programme which allows the instalment payment (see table of card programmes)

Nur an URLNotify: Name des Kartenprogramms, welches die Ratenzahlung erlaubt (siehe Tabelle der Kartenprogramme)

PayType

ans..25

MC

Only to URLNotify: Name of used payment method (see above for possible values)

Nur an URLNotify: Name der genutzten Zahlungsart (Für mögliche Werte siehe oben)

KeyFormatCNDDescriptionBeschreibung
Plain

ans..50

O

A single value to be set by the merchant to return some information unencrypted in response/notify, e.g. the MID. 

"Plain"-parameter is part of encrypted "Data" in Computop Paygate and therefore protected against manipulation. 

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. 

KeyFormatCND

Description

Beschreibung
Custom

ans..1024

O

"Custom"-parameter is added to the request data before encryption and is part of encrypted "Data" in Computop Paygate request. By this they are protected against manipulation by a consumer. 

The Custom-value is added to the Computop Paygate response in plain text and the "|" is replaced by a "&". By this you can put a single value into Custom-parameter and get multiple key-value-pairs back in response for your own purpose. 

Please find a samples here: Custom

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

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



Kreditkartenzahlung per Server-zu-Server-Verbindung

Um eine SSL-Kreditkartenzahlung mit PayU CEE GECAD ü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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

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.

Key

Format

CND

Description

Beschreibung

Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only TRY, RON, EUR and USD permitted. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur TRY, RON, EUR und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
UserData

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

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

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

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.

KeyFormatCNDDescriptionBeschreibung
Capture

an..6

OM

Determines the type and time of capture.

Capture ModeDescription
AUTOCapturing immediately after authorisation (default value).
MANUALCapturing made by the merchant. Capture is normally initiated at time of delivery.
<Number>Delay in hours until the capture (whole number; 1 to 696).

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

BuchungsartBeschreibung
AUTOBuchung sofort nach Autorisierung (Standardwert).
MANUALBuchung erfolgt durch den Händler - in der Regel die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.
<Zahl>Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

Key

Format

CND

Description

Beschreibung

CCNr

n..19

M

Credit card number at least 12-digit, numerical without spaces. You can optionally transmit also a pseudo card number (PCN)

Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer übergeben.

CCCVC

n..4

O

Card verification number: The last 3 digits on the signature strip of the credit card. 4 characters in the case of AMEX.

Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei AMEX 4 Ziffern.

CCExpiry

n6

M

Credit card expiry date (YYYYMM), e.g. 202607

Ablaufdatum der Kreditkarte (JJJJMM), z.B. 202607

CCBrand

a..22

M

Card type: VISA, MasterCard.

Please note the spelling!

Kartenmarke: VISA, MasterCard.

Bitte beachten Sie die Schreibweise!

CreditCardHolder

ans..60

O

Name of the card holder

Name des Karteninhabers

OrderDesc

ans..768

M

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise usw.

ArticleList(n)

ans..2048

M

Customer’s article list in the form:

Articlelist(n)= ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+…

Articlelist1 to max. Articlelist10 permissible

The ArticleCode hast to be one-to-one because otherwise identical article numbers will be overwritten by PayU and not added. Thereby the total amount of trasaction could be changed by mistake.

Example:

Articlelist1=article1,123456,100,1,16,GROSS+article2,321654,200,2,16,NET

Articlelist2=article3,987654,100,2,16,GROSS+article4,654231,150,1,16,NET

The amount must be equal to the sum of the amounts in ArticleList, i.e. in the sample above: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 1 x 150)

Artikelliste des Kunden in der Form:

Articlelist(n)= Artikelname,ArtikelCode,Einzelpreis,Anzahl,Umsatzsteuersatz,Typ+Artikelname,ArtikelCode,Einzelpreis, Anzahl,Umsatzsteuersatz,Typ+…

Articlelist1 bis max. Articlelist10 zulässig

Der ArtikelCode muss eineindeutig sein, da ansonsten identische Artikelnummern seitens PayU überschrieben und nicht addiert werden. Dadurch könnte sich fälschlicherweise der Gesamtbetrag der Transaktion ändern.

Beispiel:

Articlelist1=artikel1,123456,100,1,16,GROSS+artikel2,321654,200,2,16,NET

Articlelist2=artikel3,987654,100,2,16,GROSS+artikel4,654231,150,1,16,NET

Der Amount muss mit der Summe der Artikelbeträge übereinstimmen, d.h. im obigen Beispiel: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 150)

ChargeAmount

n..10

M

Shipping costs. Amount in the smallest currency unit (e.g. EUR Cent).

Versandkosten. Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).

Channel

a2

O

Channel (country) of payment (the default channel will be configured by Computop):

RO = Romania

TR = Turkey

RU = Russian Federation

HU = Hungary

UA = Ukraine

Kanal (Land) der auszuführenden Zahlung (der Standardkanal wird vom Computop konfiguriert):

RO = Rumänien

TR = Türkei

RU = Russland

HU = Ungarn

UA = Ukraine

Key

Format

CND

Description

Beschreibung




Installments (PayU)Ratenzahlung (PayU)

InstallmentNumber

n..2

O

Number of months of the payment by instalments (1-12), default=1

Anzahl Monate der Ratenzahlung (1-12), Standard=1

CardProgram

ans..25

O

Name of the card programme which allows the instalment payment (see table of card programmes)

Name der Kartenprogramms, welches die Ratenzahlung erlaubt (siehe Tabelle der Kartenprogramme)

Campaign

a5

O

Defines the campaign to be used for the instalments.

Extra=EXTRA_INSTALLMENTS

Delay=DELAY_INSTALLMENTS

Legt die zu verwendende Kampagne für Ratenzahlung fest.

Extra=EXTRA_INSTALLMENTS

Delay=DELAY_INSTALLMENTS




Loyalty points (PayU)Loyalty points (PayU)
PointAmountn..10OAmount of the Loyalty points to be used in the smallest currency unitAnzahl der zu nutzenden Loyalty-Punkte in der kleinsten Währungseinheit



Billing address (PayU)Rechnungsadresse (PayU)

bdFirstName

ans..128

M

First name of the customer

Vorname des Kunden

bdLastName

ans..128

M

Last name of the customer

Nachname des Kunden

bdStreet

ans..46

O

Street name in the invoicing address

Straßenname der Rechnungsadresse

bdAddressAddition

ans..60

O

Address addition in the billing address

Adresszusatz der Rechnungsadresse

bdCity

ans..40

O

Name of town/city in the billing address

Ortsname der Rechnungsadresse

bdZip

ans..8

O

Postcode in the invoicing address

Postleitzahl der Rechnungsadresse

bdState

ans..50

O

Federal state in the invoicing address

Bundesland der Rechnungsadresse

bdCountryCode

a2

M

Country code in the invoicing address according to ISO 3166

Ländercode der Rechnungsadresse gemäß ISO 3166

bdFax

ans..20

O

Customer’s fax number

Faxnummer des Kunden

bdeMail

ans..128

M

Email address of the customer

E-Mail-Adresse des Kunden

bdPhone

ans..40

O

Customer’s phone number

Telefonnummer des Kunden




Delivery addressLieferadresse

sdFirstName

ans..128

O

First name in the delivery address

Vorname in der Lieferanschrift

sdLastName

ans..128

O

Surname in the delivery address

Nachname in der Lieferanschrift

sdStreet

ans..46

O

Street name in the delivery address

Straßenname in der Lieferanschrift

sdAddressAddition

ans..60

O

Address addition in the delivery address

Adresszusatz der Lieferanschrift

sdCity

ans..40

O

Town/city in the delivery address

Ortsname in der Lieferanschrift

sdZip

ans..8

O

Postcode in the delivery address

Postleitzahl in der Lieferanschrift

sdState

ans..50

O

Federal state of the delivery address

Bundesland der Lieferadresse

sdCountryCode

a2

O

Country code in the delivery address according to ISO 3166

Ländercode in der Lieferadresse gemäß ISO 3166

sdeMail

ans..128

O

Email address in the delivery address

E-Mail-Adresse in der Lieferanschrift

sdPhone

ans..40

O

Phone number in the delivery address

Telefonnummer in der Lieferanschrift

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


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

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

Key

Format

CND

Description

Beschreibung

CodeExtans..10O

Error code from PayU, if agreed with Computop Helpdesk

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..256O

Error text from PayU, if agreed with Computop Helpdesk

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

KeyFormatCNDDescriptionBeschreibung
UserData

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

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

KeyFormatCNDDescriptionBeschreibung
PCNr

n16

O

Pseudo Card Number: Random number generated by Computop Paygate which represents a genuine credit card number. The pseudo card number (PCN) starts with 0 and the last 3 digits correspond to those of the real card number. The PCN can be used like a genuine card number for authorisation, capture and credits.

PCNr is a response value from Computop Paygate and is sent as CCNr in Request or part of card-JSON

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 von Computop Paygate und kann ebenfalls als CCNr im Request oder als Teil von card-JSON verwendet werden.

Key

Format

CND

Description

Beschreibung

CCBrand

a..22

O

In combination with PCNr: Description of the credit card brand including VISA, MasterCard, AMEX, DINERS, Elo, Aura or Hipercard

In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard, AMEX, DINERS, Elo, Aura oder Hipercard

CCExpiry

n6

O

In combination with PCNr: Expiry date of the credit card in the format YYYYMM

In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM

InstallmentNumber

n..2

O

Number of months of the payment by instalments (1-12), default=1

Anzahl Monate der Ratenzahlung (1-12), Standard=1

CardProgram

ans..25

O

Name of the card programme which allows the instalment payment (see table of card programmes)

Name des Kartenprogramms, welches die Ratenzahlung erlaubt (siehe Tabelle der Kartenprogramme)

PayType

ans..25

M

Name of used payment method (see above for possible values)

Name der genutzten Zahlungsart (Für mögliche Werte siehe oben)

Ergebnis-Parameter der Socket-Verbindung für PayU CEE GECAD



Buchung einer Kreditkartenzahlung mit PayU CEE GECAD

Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Buchung (Capture) für eine Kreditkartenzahlung mit PayU CEE GECAD ü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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

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

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment to be captured

Vom Paygate vergebene ID für die zu buchende Zahlung

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

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

Key

Format

CND

Description

Beschreibung

RefNrans..30O

Unique reference number which appears on your printed card account or in the EPA-file (Electronic Payment Advice). Format must be mutually agreed beforehand with Computop!

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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

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 GECAD über Socket-Verbindungen


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

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

Key

Format

CND

Description

Beschreibung

CodeExtn..10O

Error code from PayU, if agreed with Computop Helpdesk

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..256O

Error text from PayU, if agreed with Computop Helpdesk

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

Ergebnis-Parameter für Buchungen von PayU CEE GECAD ü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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

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

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment to be credited

Vom Paygate vergebene ID für die gutzuschreibende Zahlung

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

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

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

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.

Key

Format

CND

Description

Beschreibung

OrderDescans..768ODescription of refunded goods, unit prices, merchant’s comment etc.Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.

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


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

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

Key

Format

CND

Description

Beschreibung

CodeExtn..10O

Error code from PayU, if agreed with Computop Helpdesk

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..256O

Error text from PayU, if agreed with Computop Helpdesk

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

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



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

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Action

Version

Description

Beschreibung
Capture

1.0 / 2.0

Standard version without return of parameter Code

Standardversion ohne Rückgabe von Parameter Code

1.x / 2.x

with RefNr (valid for all versions other than 1.0)

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

Credit

1.0 / 2.0

Standard version without return of parameter Code

Standardversion ohne Rückgabe von Parameter Code


1.x / 2.x

with RefNr (valid for all versions other than 1.0)

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 CEE in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

HEAD,<MerchantID>,<Date>,<Version>
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
CC,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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

Beschreibung

Type

a..11

M

HEAD for Header, FOOT for Footer, CC for credit card

HEAD für Header, FOOT für Footer, CC für Kreditkarte

Action

a..20

M

The parameter Action defines the type of transaction:

Capture

Credit

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

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.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for this transaction

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>
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
CC,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):

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

Key

Format

CND

Description

Beschreibung

Action

a..20

M

The parameter Action defines the type of transaction:

Capture

Credit

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for this transaction

Vom Paygate vergebene ID für diese Transaktion

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien