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 (veraltet)
-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 (veraltet)
girocard.aspx


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772533700436_1949248916
transposefalse
worklog365|5|8|y w d h m|y w d h m
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
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording (veraltet)
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 Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772533717346_1111137981
transposefalse
worklog365|5|8|y w d h m|y w d h m
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

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.


Schema

(info) BASEURL=

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
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 Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772533764548_684035548
transposefalse
worklog365|5|8|y w d h m|y w d h m
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
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording (veraltet)
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 (veraltet)
-Antwort von der ersten Girocard Apple-Pay-Zahlung erhalten wurde.

Parameter für wiederkehrende Zahlungen


Antwort-Elemente

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_Intro
PageWithExcerptEN:Reuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772533779768_-2076852911
transposefalse
worklog365|5|8|y w d h m|y w d h m
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

Antwort-Parameter für wiederkehrende Zahlungen