PAYBACK PAY

Logo

Info

tbd

Typ

Zahlungen per eWallet

Unterstützte Anwendungsfälle

Unterstützte Schnittstellen

Anwendungsfall

Beschreibung

Einfacher Prozess

S-2-S

APP

Batch

Autorisierung + Buchung

Der Händler möchte die Zahlung autorisieren und bei Lieferung buchen

• nicht unterstützt

• verwenden Sie stattdessen "Sale", um eine Zahlung in einem Schritt zu autorisieren und zu buchen

Sale

Händler möchte per Payback Geld vom Kunden einziehen

• Der Shop des Händlers startet eine Payback-Zahlungsanfrage

• Der Kunde bestätigt die Zahlung in der Payback-App

• Der Shop des Händlers erhält eine Benachrichtigung über die erfolgreiche Zahlung

• Die Händler-App fragt den Server des Händlers, bis die Zahlung abgeschlossen ist

Voll- oder Teilgutschrift

Der Händler möchte dem Kunden nach einer erfolgreichen Zahlung etwas Geld zurückerstatten

• Der Händler startet eine Gutschrifts-Anfrage

• Computop erfasst die Payback-Details der betreffebden Zahlung und veranlasst die Payback-Gutschrift

• Der Shop des Händlers erhält eine Rückmeldung über die erfolgreiche Gutschrift

Format

Beschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

ISODateTime (JJJJ-MM-TTThh:mm:ss)

Abkürzung

Beschreibung

Kommentar

CND

Bedingung (condition)

M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich

C

bedingt (conditional)

Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist

MerchantID

ans..30

M

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

TransID

ans..64

M

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

Amount

n..10

M

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

Currency

a3

M

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

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

Language

a2

O

Sprache: de - deutsch, en – Englisch

URLSuccess

ans..256

M

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

Allgemeine Hinweise:

• Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

• Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

URLFailure

ans..256

M

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

Allgemeine Hinweise:

• Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort vom Paygate zu erhalten

• Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Response

a7

O

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

URLNotify

ans..256

M

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

Allgemeine Hinweise:

• Bevor Folgeaktionen (Buchung / Gutschrift / Storno) auf eine bestehende Transaktion ausgeführt werden, muss zuvor das erste Notify durch den Shop beantwortet worden sein.

• Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

UserData

ans..1024

O

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

ReqId

ans..32

O

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

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

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

Plain

ans..50

O

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

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

Custom

ans..1024

O

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

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

Hier finden Sie ein Beispiel: Custom

PointAmount

n..10

O

Der PAYBACK-Punktebetrag der PAY-Transaktion

VatList

String

M

Base64-codierter Wert

items.rate

n..10

M

Der Prozentsatz des Mehrwertsteuerartikels

ArticleList

String

M

Base64-codierter Wert

items

array

M

Array von Elementen, z. B.: {"items": [{items1 ...}{item2...}]}

items.itemReference

ans..30

M

Position des Einzelpostens in der Bestellung

items.id

ans..30

M

Artikelnummer

items.name

ans..30

M

Name/Titel des Artikels

items.quantity

ans..30

M

Gesamtzahl der Artikel

items.amount

n..10

M

Brutto-Stückpreis (inkl. MwSt.) in Cent

items.vatAmount

n..10

M

Steuerbetrag in Cent

items.vatPercent

n..10

M

Steuersatz der Landessteuer in % als Zahl 19 % = 19

items.type

an..20

M

GOODS = Zu versendender Artikel

VOUCHER = Gutschein, der verwendet werden soll

SHIPPING = Versandkosten

PAYMENT_FEE = Zahlungsgebühr

DeviceID

ans..50

O

Geräte-ID, die vom Händler beim Bezahlvorgang festgelegt und mit dem Gerätecheck-Pixel übermittelt wird.

Für E-Com ist es obligatorisch.Der Wert muss derselbe sein, der mit dem DevicePixel übergeben wurde.

AccountId

n10

M

Das ist die vom Händler übergebene 10-stellige PAYBACK-Benutzerkennung des Kunden, mit der überprüft wird, ob der richtige Benutzer die Zahlung ausführt

CustomerID

ans..30

M

Die PAYBACK-Mitgliedskennung steht nur bei aktiver Kontobindung zur Verfügung und dient dazu, Nutzer zur Erfüllung von Transaktionen zu bewegen

IsBound

bool

M

Information, ob das PAYBACK-Konto händlerseitig gebunden ist.Nur in diesem Fall können Benutzer gepusht werden: True |False

CustomerGroup

enum

M

Informationen des Händlers über den Kunden, die von Verifone Payments zur Risikobewertung verwendet werden: KNOWN | UNKNOWN

sdAdditionalInfo

ans..50

O

Versanddetails, Zusatzinfo, z.B.Informationen zur Versandart (z.B. „Click++Collect“)

sdCompany

ans..50

O

Versanddetails, Firma

sdFirstName

ans..50

O

Versanddetails, Vorname

sdLastName

ans..50

O

Versanddetails, Nachname

sdStreet

ans..50

O

Versanddetails, Straße

sdStreetNr

an..10

O

Versanddetails, Hausnummer

sdZIP

an..20

O

Versanddetails, Postleitzahl

sdCity

ans..50

O

Versanddetails, Ort

sdCountryCode

an2

M

Versanddetails, Ländercode

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

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

XID

an32

M

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

TransID

ans..30

M

Eindeutige Referenznummer für Ihre Buchhaltung – sie ist auch die eindeutige Referenz für Payback.

Status

a..50

M

OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure)

Description

ans..1024

M

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

Code

an8

M

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

UserData

ans..1024

O

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

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

Plain

ans..50

O

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

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

Custom

ans..1024

O

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

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

Hier finden Sie ein Beispiel: Custom

TransactionID

ans..64

M

Eindeutige von Payback zurückgegebene Transaktionsnummer

redemptionfactor

an..5

O

Mit dem Einlösefaktor lässt sich der Gegenwert der eingelösten Punkte in Euro berechnen. Da 100 Punkte 1 EUR entsprechen, beträgt der Faktor in Deutschland 0.01

pointsredeemed

n..10

O

Der Betrag der Punkte in einer PAY-Einlösungstransaktion.Er existiert nur bei mobiler Einlösung. Falls vorhanden, muss es eine natürliche Zahl sein.

payamount

n..10

O

Der PAY-Betrag der PAY-Transaktion inklusive Mehrwertsteuer.Er existiert nur bei mobiler Einlösung.Wenn die Einlösungstransaktion vollständig mit Punkten bezahlt wird, beträgt dieser 0.

ApprovalCode

an..10

O

Optionale externe Autorisierungskennung für die PAY-Transaktion.Wird von Verifone Payments als eindeutige Autorisierungskennung der Zahlungstransaktion ausgefüllt.

paymentmethod

enum

O

Dieses Feld gibt die detaillierte Zahlungsmethode an, die zur Zahlung des PAY-Betrags verwendet wird: Sepa, VISA, MasterCard

PointAmount

n..10

O

Der PAYBACK-Punktebetrag der PAY-Transaktion

AccountId

n10

M

Das ist die vom Händler übergebene 10-stellige PAYBACK-Benutzerkennung des Kunden, mit der überprüft wird, ob der richtige Benutzer die Zahlung ausführt

CustomerID

ans..30

M

Die PAYBACK-Mitgliedskennung steht nur bei aktiver Kontobindung zur Verfügung und dient dazu, Nutzer zur Erfüllung von Transaktionen zu bewegen

IsBound

bool

M

Information, ob das PAYBACK-Konto händlerseitig gebunden ist.Nur in diesem Fall können Benutzer gepusht werden: True |False

CustomerGroup

enum

M

Informationen des Händlers über den Kunden, die von Verifone Payments zur Risikobewertung verwendet werden: KNOWN | UNKNOWN

MerchantID

ans..30

M

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

PayID

an32

M

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

TransID

ans..64

M

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

Amount

n..10

M

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

Currency

a3

M

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

refnr

ans..30

O

Eindeutige Referenznummer des Händlers

MAC

an64

M

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

• HMAC-Authentisierung (Anfrage)

• HMAC-Authentisierung (Notify)

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.

mid

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

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

XID

an32

M

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

TransID

ans..64

M

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

Status

a..50

M

OK (URLSuccess) oder FAILED (URLFailure)

Description

ans..1024

M

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

Code

an8

M

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

Amount

n..10

M

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

Currency

a3

M

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

paymentmethod

enum

O

Dieses Feld gibt die detaillierte Zahlungsmethode an, die zur Zahlung des PAY-Betrags verwendet wird: Sepa, VISA, MasterCard

payamount

n..10

O

Der PAY-Betrag der PAY-Transaktion inklusive Mehrwertsteuer.Er existiert nur bei mobiler Einlösung.Wenn die Einlösungstransaktion vollständig mit Punkten bezahlt wird, beträgt dieser 0.

pointamount

n..10

M

Der PAYBACK-Punktebetrag der PAY-Transaktion

pointsredeemed

n..10

M

Der Betrag der Punkte in einer PAY-Einlösungstransaktion.Er existiert nur bei mobiler Einlösung.Wenn vorhanden, muss er eine natürliche Zahl sein.

RedemptionFactor

an..5

M

Mit dem RedemptionFactor lässt sich der Gegenwert der eingelösten Punkte in Euro berechnen. Da 100 Punkte 1 EUR entsprechen, beträgt der Faktor in Deutschland 0.01.

• 55,00 EUR to pay

• can be paid with PAYBACK Points or direct debit or card

• 200 points have been selected for payment

• 53,00 EUR will be paid via direct debit

• Payment was successful