Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEWORK and version Dokumentation

Table of Contents


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


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
-Schnittstelle: Server-zu-Server

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameDefinition
PageWithExcerptDefinition DE


Anfrage-Elemente

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

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording
girocard.aspx


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

table-filterjoiner
0
inversedateFormatfalse
defaultDescription
dd M yy
export-wordfalse
show-sourceisFirstTimeEnterfalse
hideColumnsexport-csvtruefalse
sparkNameidSparkline1772533700436_1949248916
hidePanetrue
datepatterndd M yy
transposefalseid1629202486283_968057699
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMsgVer
pagemsgver
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Key

Format

CND

Beschreibung

RefNr

ans..30

O

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 

Multiexcerpt include
SpaceWithExcerpt

EN

DE
MultiExcerptName

Request

Partner-Name
PageWithExcerpt

EN:girocard e-commerce

Wording
Settlement File (CTSF) auch nicht zusätzlich angereichert werden.

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameAmount
pageAmount
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCurrency
pageCurrency
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameUserData
pageUserData
typepage

Key

Format

CND

Beschreibung

OrderDesc

ans..768

M

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

Kartendaten, Karten-Scheme=girocard

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCapture
pageCapture
typepage

Key

Format

CND

Beschreibung

channel

a..20

O

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

  • WEBSITE

  • MOBILE_APP

credentialOnFileJSONCObjekt, 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.
tokenDataJSONMToken Daten, Struktur: siehe unten
MerchantIDExtans..128MApple Händler-Kennung 

Parameter für Girocard E-Commerce-Zahlung


Antwort-Elemente

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

table-filterjoiner
inversedateFormatfalse
defaultDescription
dd M yy
export-wordfalse
show-sourceisFirstTimeEnterfalse
hideColumnsexport-csvtruefalse
sparkNameidSparkline1772533717346_1111137981
hidePanetransposetrue
datepatterndd M yy
id1642991068409_1677583451
false
worklog365|5|8|y w d h m|y w d h m
isORseparatorAND.
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse
PageWithExcerptEN:girocard e-commerce

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

JSON-Objekt tokenData

Table Filter
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Key

Format

CND

Beschreibung

Status

a..20

M

Status der Transaktion.

Zulässige Werte:

  • AUTHORIZED

  • FAILED

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameUserData
pageUserData
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

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


JSON-Objekt tokenData

Key

Format

CND

Beschreibung

tokenCryptogram

string

M

Cryptogram wie vom Tokenization Service empfangen.
ecistringM

Zahlsystem-spezifischer Wert für Electronic Commerce Indicator.

Bei MasterCard wird "2" verwendet, wenn nicht anders erhalten.

tokenRequestorstringM

Token Requestor. Zulässige Werte:

  • applePay
  • googlePay
  • merchantTokenization

tokenRequestorID

string

C

Token Requestor ID wie vom Karten-Scheme zugewiesen.

Erforderlich bei MasterCard Merchant Tokenization.

inversefalse
sparkNameSparkline
hidePanetrue
isNewfalse
separatorPoint (.)
ddSeparatorstrue
defaultDescription
hideColumnstrue
datepatterndd M yy
id1642991170567_-1797899411
worklog365|5|8|y w d h m|y w d h m
isORAND
order0
Multiexcerpt includeSpaceWithExcerptENMultiExcerptNametokenDataPageWithExcerptEN:girocard e-commerce


Schema

(info) BASEURL=

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording
schemas

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameSchema
PageWithExcerptEN:girocard e-commerce

Beispiel

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameSample
PageWithExcerptEN:girocard e-commerce


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:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptEN:Wording
girocard.aspx


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptEN:Reuse API

table-filterjoiner
0
inversedateFormatfalse
sparkNameSparkline
hidePanetrue
dd M yy
export-wordfalse
show-sourcefalse
export-csvisNewfalse
separatorPoint (.)
ddSeparatorstrue
defaultDescription
hideColumnstrue
datepatterndd M yy
id1680179222166_-43318950
id1772533764548_684035548
transposefalse
worklog365|5|8|y w d h m|y w d h m
isORAND
order
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMsgVer
pagemsgver
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Key

Format

CND

Beschreibung

RefNr

ans..30

O

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 

Multiexcerpt include
SpaceWithExcerpt

EN

DE
MultiExcerptName

Recurring_request

Partner-Name
PageWithExcerptWording
Settlement File (CTSF) auch nicht zusätzlich angereichert werden.

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameAmount
pageAmount
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCurrency
pageCurrency
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameUserData
pageUserData
typepage

Key

Format

CND

Beschreibung

OrderDesc

ans..768

M

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

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCapture
pageCapture
typepage

Key

Format

CND

Beschreibung

credentialOnFileJSONM

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.

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

InitialPayIDan32M

PayID, die in der

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
-Antwort von der ersten Girocard Apple-Pay-Zahlung erhalten wurde.

PageWithExcerptEN:girocard e-commerce

Parameter für wiederkehrende Zahlungen


Antwort-Elemente

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_Intro
PageWithExcerptEN:Reuse API

EN:girocard e-commerce
table-filterjoiner
inversedateFormatfalse
sparkNameSparkline
hidePanetrue
isNewfalse
separatorPoint (.)
ddSeparatorstrue
defaultDescription
hideColumnstrue
datepatterndd M yy
dd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772533779768_-2076852911
transposefalseid1680179277217_-1106027551
worklog365|5|8|y w d h m|y w d h m
isORAND
order0
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Key

Format

CND

Beschreibung

Status

a..20

M

Status der Transaktion.

Zulässige Werte:

  • AUTHORIZED

  • FAILED

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameUserData
pageUserData
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRecurring_response
PageWithExcerpt

Antwort-Parameter für wiederkehrende Zahlungen