Über Girocard E-Commerce

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

Paygate-Schnittstelle

Definitionen

Datenformate

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

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

Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.

Anfrage Elemente

Um eine Server-2-Server-Zahlung mit Girocard zu starten, nutzen Sie bitte folgende 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:

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

Key	Format	CND	Description
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

Key

Format

CND

Description

msgver

ans..5

M

Computop Paygate Message version. Valid values:

Value	Description
2.0	With 3-D Secure 2.x a lot of additional data were required (e.g. browser-information, billing/shipping-address, account-info, ...) to improve authentication processing. To handle these information the JSON-objects have been put in place to handle such data. To indicate that these data are used the MsgVer has been implemented.

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

Key	Format	CND	Description
RefNr	ans..30	O	Merchant’s unique reference number, which serves as payout reference in the acquirer EPA file. Please note, without the own shop reference delivery you cannot read out the EPA transaction and regarding the additional Computop settlement file (CTSF) we cannot add the additional payment data.

Key	Format	CND	Description
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).

Key	Format	CND	Description
Currency	a3	M	Currency, three letters DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Key	Format	CND	Description
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)

Key	Format	CND	Description
UserData	ans..1024	O	If specified at request, Paygate forwards the parameter with the payment result to the shop.

Key	Format	CND	Description
OrderDesc	ans..768	M	Description of goods and prices. Intended purpose on the statement of account
card	JSON	M	Card data, brand=girocard

Key

Format

CND

Description

Capture

an..6

OM

Determines the type and time of capture.

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

Key	Format	CND	Description
channel	a..20	O	Indicates the type of channel interface being used to initiate the transaction. Values accepted: `WEBSITE` `MOBILE_APP`
credentialOnFile	JSON	C	Object specifying type and series of transactions using payment account credentials (e.g. account number or payment token) that is stored by a merchant to process future purchases for a customer. Required if applicable.
tokenData	JSON	M	Token Data, structure: see below
MerchantIDExt	ans..128	M	Apple Merchant Identifier

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. mid, 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.

Key	Format	CND	Description
mid	ans..30	M	MerchantID, assigned by Computop

Key	Format	CND	Description
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.

Key	Format	CND	Description
XID	an32	M	ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Key	Format	CND	Description
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment

Key	Format	CND	Description
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)

Key	Format	CND	Description
Status	a..20	M	Status of the transaction. Values accepted: `AUTHORIZED` `FAILED`

Key	Format	CND	Description
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!

Key	Format	CND	Description
UserData	ans..1024	O	If specified at request, Paygate forwards the parameter with the payment result to the shop.

Key	Format	CND	Description
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)

JSON object tokenData

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

Key	Format	CND	Description
tokenCryptogram	string	M	Cryptogram as received from Tokenization Service.
eci	string	M	Payment system specific Electronic Commerce Indicator. For MasterCard, if not received in payload, use value "2".
tokenRequestor	string	M	Token Requestor. Possible values: applePay googlePay merchantTokenization
tokenRequestorID	string	C	Token Requestor ID assigned by the card scheme. Required for MasterCard merchant tokenization.

Schema

Schema

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "$id": "BASEURL/tokenData.json",
    "title": "tokenData",
    "description": "Token Data",
    "type": "object",
    "properties": {
        "tokenCryptogram": {
            "type": "string",
            "description": "Token cryptogram."
        },
        "eci": {
            "type": "string",
            "description": "Electronic Commerce Indicator."
        },
        "tokenRequestor": {
            "type": "string",
            "description": "Token requestor."
        },
        "tokenRequestorID": {
            "type": "string",
            "description": "Token requestor ID."
        }
    },
    "required": ["tokenCryptogram", "tokenRequestor, "eci"],
    "additionalProperties": false
}

Beispiel

Sample

{
    "tokenCryptogram": "YwAAErsAAcll8GEDuiS4gFlgAgA=",
    "eci": "7",
    "tokenRequestor": "merchantTokenization",
    "tokenRequestorID": "50129390584"
}

Space shortcuts

Page tree

Über Girocard E-Commerce

Paygate-Schnittstelle

Definitionen

Datenformate

Abkürzungen

Anfrage Elemente

Antwort Elemente

JSON object tokenData

Schema

Beispiel

Paygate

Computop

Help

Intranet Tools