Über PayU Hub

Allgemeines zu Zahlungsmethoden via PayU Hub


Logo

Info

Mit PayU Hub können alle Aspekte des Zahlungsstapels in einer anpassbaren Zahlungsplattform rationalisiert und konsolidiert werden. Die neue Plattform integriert lokale und globale Zahlungen und ermöglicht es, neue Märkte mit minimalen Schwierigkeiten zu erschließen.

PayU Hub ermöglicht eine einheitliche und direkte Verbindung zu beliebten globalen und lokalen Zahlungsmethoden auf der ganzen Welt. Mit Hunderten verfügbaren Zahlungsmethoden können Händler effektiv lokalisieren und Kunden dort treffen, wo sie sich befinden.

TypGemischte Zahlarten

Card Scheme

MasterCard

VISA

AMEX

DINERS

RuPay


Diagramme zum Prozessablauf

Prozessablauf PayU Hub WebCheckout


Prozessablauf für PayU Hub Gutschrift ‒ asynchron


Konfiguration

Credentials

Zur Einrichtung des Händlers für PayU Hub benötigt der Computop Helpdesk einige Informationen. Diese finden Sie im Backend-System von PayU ( https://control.paymentsos.com ) für Ihren eigenen Händlerzugang unter Account / Business Units.

Von den Systemeinstellungen benötigen Sie App ID, Public API Key and Private API Key.

Übermitteln Sie die Werte auf einem sicheren Weg an den Computop Helpdesk.

Webhook setup

Unter Account / Webhooks sollten Sie Webhooks wie folgt einrichten.


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

Um eine Zahlung mit PayU Hub 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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key

Format

CND

Beschreibung

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD zulässig. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDBeschreibung

MAC

an64

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

KeyFormatCNDBeschreibung
URLSuccess

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData.

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

KeyFormatCNDBeschreibung
URLFailure

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData.

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

KeyFormatCNDBeschreibung
Response

a7

O

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

KeyFormatCNDBeschreibung
URLNotify

ans..256

M

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData.

(info) Allgemeine Hinweise:

  • Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.
  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

KeyFormatCNDBeschreibung
UserData

ans..1024

O

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

KeyFormatCNDBeschreibung
ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key

Format

CND

Beschreibung

OrderDesc

ans..100

M

Beschreibung der gekauften Waren, Einzelpreise usw.

PayTypeans..25O

Name der auszuführenden Zahlungsmethode.

Falls der Parameter leer ist, wird der Kunde zur Zahlungsseite von PayU Hub weitergeleitet. Auf der Zahlungsseite von PayU Hub kann der Kunde eine Zahlungsmethode aus der Liste der verfügbaren Zahlungsmethoden auswählen.

Mögliche Werte für den Parameter bei PayU India als Provider:

  • Challan
  • Dynamic_QR
  • Netbanking   
  • UPI
  • Airtel Money   
  • Amazon pay
  • FreeCharge
  • JioMoney    
  • Ola Money   
  • Paytm
  • Pay Zapp
  • Phonepe

Mögliche Werte für den Parameter bei PayU lyzico als Provider:

  • Pay_with_iyzico
BankCodeans..25CPflicht bei PayType=Netbanking

KeyFormatCNDBeschreibung
Plain

ans..50

O

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

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

KeyFormatCNDBeschreibung
Custom

ans..1024

O

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

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

Key

Format

CND

Beschreibung




Kundendaten

bdFirstName

ans..60

C

Vorname des Kunden

bdLastName

ans..20

C

Nachname des Kunden

bdStreet

ans..100

O

Straßenname des Kunden

bdStreet2

ans..100

O

Adresszusatz des Kunden

bdCity

ans..50

O

Ort des Kunden

bdZIP

ans..20

O

Postleitzahl des Kunden

bdState

ans..50

O

Bundesstaat des Kunden

bdCountryCode

a..3

O

Ländercode des Kunden gemäß ISO 3166; alphanumerisch 2 oder 3 Zeichen

CustomerID

ans..128

O

Kundennummer.

Wird die Kundennummer nicht angegeben, wird stattdessen die E-Mail-Adresse an PayU übermittelt.

Die Kundennummer dient der Identifizierung des Kunden, um ggf. bei PayU hinterlegte Kreditkartendaten auswählen zu können.

bdEmail

ans..128

C

E-Mail-Adresse des Kunden

Obligatorisch falls Provider=PayU India

bdPhone

ans..40

C

Telefonnummer des Kunden

Obligatorisch falls Provider=PayU India




Kreditkartenzahlung (bei Kreditkartenzahlung sind die folgenden Parameter obligatorisch)

CCNr

n..19

C

Kreditkartennummer mindestens 12-stellig, numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer (PCN) übermitteln.

CCCVC

n..4

C

Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsstreifen der Kreditkarte. 4 Ziffern bei American Express.

CCExpiry

n6

C

Ablaufdatum der Kreditkarte im Format JJJJMM, z.B. 202807

CCBrand

a..22

C

Kartenmarke: nur VISA, MasterCard, AMEX, Diners, RuPay erlaubt.

Bitte beachten Sie die Schreibweise!

CreditCardHolder

ans..60

C

Name des Kreditkarteninhabers

Parameter für Zahlungen mit PayU Hub WebCheckout


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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Status

a..50

M

OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure)

KeyFormatCNDBeschreibung
Description

ans..1024

M
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDBeschreibung
Code

an8

M

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

KeyFormatCNDBeschreibung

MAC

an64

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

Key

Format

CND

Beschreibung

CodeExtn..10O

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..256O

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

KeyFormatCNDBeschreibung
UserData

ans..1024

O

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

Key

Format

CND

Beschreibung

TransactionID

ans..64

O

Transaktions-ID von PayU
Channela..5MName der zu verwendenden Zahlungskategorie mit den folgenden möglichen Werten: 'NB' für Net Banking, 'CC' für Kreditkarte, 'DC' für Debitkarte, 'CASH' für Geldkarte, 'EMI' für EMI, 'Wallet' für PayUMoney, 'IVR' für IVR, 'COD' für Nachnahme
BankCodea..5MIdentifizierung der für die Transaktion verwendeten Zahlungsoption: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR
Branda..5CSpezifischer Kartentyp: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR

KeyFormatCNDBeschreibung
Plain

ans..50

O

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

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

KeyFormatCNDBeschreibung
Custom

ans..1024

O

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

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

Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify bei PayU Hub WebCheckout


Kreditkartenzahlung mit PayU Hub via Formular-Schnittstelle

Um eine Kreditkartenzahlung mit PayU Hub über ein Paygate-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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key

Format

CND

Beschreibung

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD zulässig. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDBeschreibung

MAC

an64

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

KeyFormatCNDBeschreibung
URLSuccess

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung erfolgreich war. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData.

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

KeyFormatCNDBeschreibung
URLFailure

ans..256

M

Vollständige URL, die das Paygate aufruft, wenn die Zahlung gescheitert ist. Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen nutzen Sie stattdessen den Parameter UserData.

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

KeyFormatCNDBeschreibung
Response

a7

O

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

KeyFormatCNDBeschreibung
URLNotify

ans..256

M

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData.

(info) Allgemeine Hinweise:

  • Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.
  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

KeyFormatCNDBeschreibung
UserData

ans..1024

O

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

KeyFormatCNDBeschreibung
ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key

Format

CND

Beschreibung

OrderDesc

ans..100

M

Beschreibung der gekauften Waren, Einzelpreise usw.

RTFa1O„I“ zum Initialisieren wiederkehrender Zahlungen

KeyFormatCNDBeschreibung
Plain

ans..50

O

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

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

KeyFormatCNDBeschreibung
Custom

ans..1024

O

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

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

Key

Format

CND

Beschreibung




Kundendaten

bdFirstName

ans..60

C

Vorname des Kunden

bdLastName

ans..20

C

Nachname des Kunden

bdStreet

ans..100

O

Straßenname des Kunden

bdStreet2

ans..100

O

Adresszusatz des Kunden

bdCity

ans..50

O

Ort des Kunden

bdZIP

ans..20

O

Postleitzahl des Kunden

bdState

ans..50

O

Bundesstaat des Kunden

bdCountryCode

a..3

O

Ländercode des Kunden gemäß ISO 3166; alphanumerisch 2 oder 3 Zeichen

CustomerID

ans..128

O

Kundennummer.

Die Kundennummer dient der Identifizierung des Kunden bei PayU. Wird diese übermittelt, speichert PayU die Kartennummer.

Wird die CustomerID für Folgezahlungen an PayUHub.aspx übermittelt, muss der Kunde lediglich den CVC innerhalb des Formulars eingeben.

bdEmail

ans..128

C

E-Mail-Adresse des Kunden

Obligatorisch falls Provider=PayU India

bdPhone

ans..40

C

Telefonnummer des Kunden

Obligatorisch falls Provider=PayU India

Parameter für Kreditkartenzahlungen mit PayU Hub


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

KeyFormatCNDBeschreibung
Template

ans..20

O

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

KeyFormatCNDBeschreibung
Background

ans..256

O

Formular Hintergrundumgebung:

- URL für ein Hintergrundbild

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

- HTML-Farbname

KeyFormatCNDBeschreibung
BGColor

ans..7

O

Formular Hintergrundfarbe:

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

- HTML-Farbname

KeyFormatCNDBeschreibung
BGImage

ans..256

O

Formular Hintergrundbild:

URL für ein Hintergrundbild

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

KeyFormatCNDBeschreibung
FColor
ans..7
O

Textfarbe:

- HTML-Farbwert als HEX-Wert oder

- HTML-Farbname

KeyFormatCNDBeschreibung
FFace
a..10
O

HTML-Name der Schriftart

KeyFormatCNDBeschreibung
FSize
n2
O

Zahl für die Schriftgröße

Key

Format

CND

Beschreibung

Language

a2

(enum)

M

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

Ohne Angabe ist die Sprache Deutsch.

CCSelecta..10MBestimmt die vorausgewählte Kartenmarke im Formular: VISA, MasterCard, AMEX, Diners, RuPay

KeyFormatCNDBeschreibung
URLBack

ans..256

O

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

Der Parameter "URLBack" kann

  • sowohl unverschlüsselt ans Paygate übermittelt werden (Kompabilitätsmodus)
  • als auch in den verschlüsselten Übergabeparametern (bevorzugte Variante)

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

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.

KeyFormatCNDBeschreibung
Center

n1

O

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

KeyFormatCNDBeschreibung
tWidth

ans..4

O

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

KeyFormatCNDBeschreibung
tHeight

ans..4

O

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

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


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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Status

a..50

M

OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure)

KeyFormatCNDBeschreibung
Description

ans..1024

M
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDBeschreibung
Code

an8

M

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

KeyFormatCNDBeschreibung

MAC

an64

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

Key

Format

CND

Beschreibung

CodeExtans..10O

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..256O

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

KeyFormatCNDBeschreibung
UserData

ans..1024

O

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

KeyFormatCNDBeschreibung
PCNr

n16

O

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

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

Key

Format

CND

Beschreibung

CCBrand

a..22

O

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

CCExpiry

n6

O

In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM

MaskedPan

an..19

OC

Maskierte Kartennummer 6x4

TransactionID

ans..64

C

Transaktions-ID von PayU

TokenExt

an..64

C

Für wiederkehrende Zahlungen (RTF=I) wird das Token als Referenz auf die Kreditkartendaten übertragen
Channela..5MName der zu verwendenden Zahlungskategorie mit den folgenden möglichen Werten: 'NB' für Net Banking, 'CC' für Kreditkarte, 'DC' für Debitkarte, 'CASH' für Geldkarte, 'EMI' für EMI, 'Wallet' für PayUMoney, 'IVR' für IVR, 'COD' für Nachnahme
BankCodea..5MIdentifizierung der für die Transaktion verwendeten Zahlungsoption: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR
Branda..5CSpezifischer Kartentyp: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR

KeyFormatCNDBeschreibung
Plain

ans..50

O

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

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

KeyFormatCNDBeschreibung
Custom

ans..1024

O

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

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

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


Kreditkartenzahlung per Server-zu-Server-Verbindung

Um eine wiederkehrende Kreditkartenzahlung mit PayU Hub ü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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

Key

Format

CND

Beschreibung

refnr

ns..30

C

Eindeutige Referenznummer des Händlers. Obligatorisch für die Erstzahlung eines neuen Abos (RTF=I).

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key

Format

CND

Beschreibung

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD zulässig. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDBeschreibung

MAC

an64

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

KeyFormatCNDBeschreibung
UserData

ans..1024

O

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

KeyFormatCNDBeschreibung
ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

KeyFormatCNDBeschreibung
Capture

an..6

OM

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

Beschreibung

OrderDesc

ans..100

M

Beschreibung der gekauften Waren, Einzelpreise usw.

RTFa1O„I“ zum Initialisieren wiederkehrender Zahlungen

CCNr

n..19

M

Pseudokartennummer

CCExpiry

n6

M

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

CCBrand

a..22

M

Kartenmarke: nur VISA, MasterCard, AMEX, Diners, RuPay.

Bitte beachten Sie die Schreibweise!

TokenExt

an..64

M

Token zum Referenzieren der Kreditkartendaten bei PayU

TransactionID

ans..64

M

Transaktions-ID von PayU, die mit der ursprünglichen Zahlung zurückgegeben wird (RTF=I)

CustomerID

ans..128

O

Kundennummer.

Wird die Kundennummer nicht angegeben, wird stattdessen die E-Mail-Adresse an PayU übermittelt.

Die Kundennummer dient der Identifizierung des Kunden, um ggf. bei PayU hinterlegte Kreditkartendaten auswählen zu können.

eMail

ans..128

C

E-Mail-Adresse des Kunden

Obligatorisch falls Provider=PayU India

Phone

ans..40

C

Telefonnummer des Kunden

Obligatorisch falls Provider=PayU India

Parameter für Kreditkartenzahlungen mit PayU Hub ü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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
refnr

ans..30

O

Eindeutige Referenznummer des Händlers

KeyFormatCNDBeschreibung
Status

a..50

M

OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure)

KeyFormatCNDBeschreibung
Description

ans..1024

M
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

CodeExtans..10O

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..256O

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

KeyFormatCNDBeschreibung
UserData

ans..1024

O

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

Key

Format

CND

Beschreibung

Channela..5MName der zu verwendenden Zahlungskategorie mit den folgenden möglichen Werten: 'NB' für Net Banking, 'CC' für Kreditkarte, 'DC' für Debitkarte, 'CASH' für Geldkarte, 'EMI' für EMI, 'Wallet' für PayUMoney, 'IVR' für IVR, 'COD' für Nachnahme
BankCodea..5MIdentifizierung der für die Transaktion verwendeten Zahlungsoption: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR
Branda..5CSpezifischer Kartentyp: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR

Ergebnis-Parameter der Socket-Verbindung für PayU Hub


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:

 

Bei PayUIndia als Provider erfolgen Gutschriften (Rückerstattungen) asynchron. Daher kann PayU Hub mit dem Status "Refund Request Queued" auf eine Anfrage zur Gutschrift (Rückerstattung) antworten. Nach der Bearbeitung der Gutschrift (Rückerstattung) sendet PayU Hub eine zusätzliche Benachrichtigung mit den Ergebnissen der Bearbeitung. Das Paygate leitet die zusätzliche Benachrichtigung an den Händler weiter.


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:

KeyFormatCNDBeschreibung

MerchantID

ans..30

M

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

KeyFormatCNDBeschreibung
PayID

an32

M

Vom Paygate vergebene ID für die gutzuschreibende Zahlung

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
Amount

n..10

M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key

Format

CND

Beschreibung

Currency

a3

M

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD zulässig. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDBeschreibung

MAC

an64

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

KeyFormatCNDBeschreibung
ReqId

ans..32

O

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Key

Format

CND

Beschreibung

OrderDescans..100OBeschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.

Parameter für Gutschrift von Kreditkartenzahlungen mit PayU Hub ü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. mid, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

KeyFormatCNDBeschreibung

mid

ans..30

M

HändlerID, die von Computop vergeben wird

KeyFormatCNDBeschreibung
PayID

an32

M

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

KeyFormatCNDBeschreibung
XID

an32

M

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

KeyFormatCNDBeschreibung
TransID

ans..64

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

KeyFormatCNDBeschreibung
Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDBeschreibung
Description

ans..1024

M
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDBeschreibung
Code

an8

M

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

Key

Format

CND

Beschreibung

CodeExtn..10O

Fehlercode von PayU, wenn mit Computop Helpdesk abgesprochen

ErrorTextans..256O

Fehlertext von PayU, wenn mit Computop Helpdesk abgesprochen

Antwort-Parameter für Gutschrift von Kreditkartenzahlungen mit PayU Hub über Socket-Verbindungen