Girocard E-Commerce | Computop Documents

Über Girocard E-Commerce

E-Commerce-Zahlungen mit Girocard sind aktuell nur mit Apple Pay möglich.

Diese Seite beschreibt die Lösung für die händlereigene Entschlüsselung der Apple-Pay-Nutzlast (Token) für wiederkehrende Zahlungen.

Informationen zur standardmäßigen Apple-Pay-Integration (einschließlich Girocard) finden Sie in der Dokumentation zu Apple Pay.

Paygate-Schnittstelle: Server-zu-Server

Definitionen

Datenformate

Format

Beschreibung

alphabetisch

alphabetisch mit Sonderzeichen

numerisch

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

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

Beschreibung

Kommentar

CND

Bedingung (condition)

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

optional

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

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.

Anfrage-Elemente

Um eine Server-zu-Server-Zahlung mit Girocard zu starten, verwenden Sie bitte folgende URL:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key

Format

CND

Description

MerchantID

ans..30

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

msgver

ans..5

Computop Paygate Message-Version. Zulässige Werte:

Wert

Beschreibung

2.0

Mit 3-D Secure 2.x wurde eine Vielzahl zusätzlicher Daten (Browser-Information, Rechnungs-/Versand-Adresse, ...) erforderlich, um den Authentifizierungs-Prozess zu optimieren. Um diese Informationen zu handhaben, wurden die JSON-Objekte eingeführt. Der Parameter MsgVer zeigt an, dass diese Daten verwendet werden.

TransID

ans..64

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

RefNr

ans..30

Eindeutige Referenznummer des Händlers, welche als Auszahlungsreferenz in der entsprechenden Acquirer EPA-Datei angegeben wird. Bitte beachten Sie, ohne die Übergabe einer eigenen Auszahlungsreferenz können Sie die EPA-Transaktionen nicht zuordnen, zusätzlich kann das Computop Settlement File (CTSF) auch nicht zusätzlich angereichert werden.

Amount

n..10

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

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

MAC

an64

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

UserData

ans..1024

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

OrderDesc

ans..768

Beschreibung der Waren, Einzelpreise usw., Verwendungszweck auf dem Kontoauszug

card

JSON

Kartendaten, Karten-Scheme=girocard

Capture

an..6

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

Buchungsart

Beschreibung

AUTO

Buchung sofort nach Autorisierung (Standardwert).

MANUAL

Buchung erfolgt durch den Händler – in der Regel erfolgt die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.

<Zahl>

Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

channel

a..20

Gibt die Art der verwendeten Schnittstelle zur Initiierung der Transaktion an. Zulässige Werte:

WEBSITE
MOBILE_APP

credentialOnFile

JSON

Objekt, dass Art und Reihe der Transaktionen angibt, die unter Verwendung von beim Händler hinterlegten Zahlungsdaten (z.B. Kontonummer oder Zahlungs-Token) zur Verarbeitung künftiger Käufe eines Kunden erfolgen. Erforderlich, falls zutreffend.

tokenData

JSON

Token Daten, Struktur: siehe unten

MerchantIDExt

ans..128

Apple Händler-Kennung

Parameter für Girocard E-Commerce-Zahlung

Response elements

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

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

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

Key	Format	CND	Description
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
Code	an8	M	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
Status	a..20	M	Status der Transaktion. Zulässige Werte: AUTHORIZED FAILED
Description	ans..1024	M	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!
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)

Key

Format

CND

Description

mid

ans..30

HändlerID, die von Computop vergeben wird

PayID

an32

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

XID

an32

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

TransID

ans..64

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

Code

an8

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

Status

a..20

Status der Transaktion.

Zulässige Werte:

AUTHORIZED
FAILED

Description

ans..1024

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

UserData

ans..1024

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

MAC

an64

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

Antwort-Parameter für Girocard E-Commerce-Zahlung

JSON object tokenData

Key

Format

CND

Beschreibung

tokenCryptogram

string

Cryptogram wie vom Tokenization Service empfangen.

eci

string

Zahlsystem-spezifischer Wert für Electronic Commerce Indicator.Bei MasterCard wird "2" verwendet, wenn nicht anders erhalten.

tokenRequestor

string

Token Requestor. Zulässige Werte:applePaygooglePaymerchantTokenization

tokenRequestorID

string

Token Requestor ID wie vom Karten-Scheme zugewiesen.Erforderlich bei MasterCard Merchant Tokenization.

Schema

BASEURL=https://www.computop-paygate.com/schemas

1
{
2
    "$schema": "http://json-schema.org/draft-07/schema#",
3
    "$id": "BASEURL/tokenData.json",
4
    "title": "tokenData",
5
    "description": "Token Data",
6
    "type": "object",
7
    "properties": {
8
        "tokenCryptogram": {
9
            "type": "string",
10
            "description": "Token cryptogram."
11
        },
12
        "eci": {
13
            "type": "string",
14
            "description": "Electronic Commerce Indicator."
15
        },
16
        "tokenRequestor": {
17
            "type": "string",
18
            "description": "Token requestor."
19
        },
20
        "tokenRequestorID": {
21
            "type": "string",
22
            "description": "Token requestor ID."
23
        }
24
    },
25
    "required": ["tokenCryptogram", "tokenRequestor, "eci"],
26
    "additionalProperties": false
27
}

Beispiel

1
{
2
    "tokenCryptogram": "YwAAErsAAcll8GEDuiS4gFlgAgA=",
3
    "eci": "7",
4
    "tokenRequestor": "merchantTokenization",
5
    "tokenRequestorID": "50129390584"
6
}

Wiederkehrende Zahlungen

Girocard E-Commerce bietet die Möglichkeit wiederkehrender Zahlungen, die sich immer auf die über Apple Pay getätigte Erstzahlung beziehen müssen.

Diese wiederkehrenden Zahlungen werden bei der ausgebenden Bank nicht online autorisiert, sondern nur in die Clearing-Datei aufgenommen.

Beachten Sie bitte, dass das Konto möglicherweise nicht über ausreichende Deckung verfügt oder nicht existiert, da zum Zeitpunkt der wiederkehrenden Zahlung keine Online-Autorisierung (Validierung) erfolgt.

Anfrage-Elemente

Um eine Server-zu-Server-Zahlung mit Girocard zu starten, verwenden Sie bitte folgende URL:

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

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

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key

Format

CND

Description

MerchantID

ans..30

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

msgver

ans..5

Computop Paygate Message-Version. Zulässige Werte:

Wert

Beschreibung

2.0

TransID

ans..64

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

RefNr

ans..30

Amount

n..10

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

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

MAC

an64

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

UserData

ans..1024

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

Capture

an..6

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

Buchungsart

Beschreibung

AUTO

Buchung sofort nach Autorisierung (Standardwert).

MANUAL

Buchung erfolgt durch den Händler – in der Regel erfolgt die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.

<Zahl>

Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

credentialOnFile

JSON

Bitte beachten Sie, dass nur der type : recurring, initial payment : false gesendet werden darf.

InitialPayID

an32

PayID, die in derPaygate -Antwort von der ersten Girocard Apple-Pay-Zahlung erhalten wurde

Parameter für wiederkehrende Zahlungen

Antwort-Elemente

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

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

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

Key	Format	CND	Description
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
Code	an8	M	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
Status	a..20	M	Status der Transaktion. Zulässige Werte: AUTHORIZED FAILED
Description	ans..1024	M	Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!
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)

Key

Format

CND

Description

mid

ans..30

HändlerID, die von Computop vergeben wird

PayID

an32

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

XID

an32

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

TransID

ans..64

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

Code

an8

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

Status

a..20

Status der Transaktion.

Zulässige Werte:

AUTHORIZED
FAILED

Description

ans..1024

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

UserData

ans..1024

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

MAC

an64

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

Antwort-Parameter für wiederkehrende Zahlungen