Card processing - Credit Card Form

900px

Multiexcerpt

MultiExcerptName	3DS2Short1

Section

Column

width

When requesting card payments via

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

hosted forms the complexity of 3-D Secure is completely removed from the merchant implementation.

From a merchant point of view the sequence itself does not differ between 3DS authenticated and non-authenticated payments though 3DS requires consideration of additional data elements in the request and response.

Note

title	Notice about Cookie-/Session Handling

Please note that some browsers might block necessary cookies when returning to Your shop. Here you will find

additial

additional information and different solution approaches.

Simplified Sequence Diagram

Image Removed

Payment Request

To retrieve a

Multiexcerpt

MultiExcerptName	3DS2Short2

-includeSpaceWithExcerptENMultiExcerptNamePartner-Name card form please submit the following data elements via HTTP POST request method to

Multiexcerpt

MultiExcerptName

Simplified Sequence Diagram

shouldDisplayInlineCommentsInIncludes

false

PageWithExcerptImage Added

Wording

When requesting card payments via

Multiexcerpt include

MultiExcerptName
SpaceWithExcerpt	EN

BaseURL

Partner-Name
PageWithExcerpt	Wording

payssl.aspx.

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1624351119375_1056203061
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	payment_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1624351119379_-1881547046
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key Format CND Description Beschreibung

1

MerchantID

ans..30

M

Merchant identifier assigned by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

HändlerID, die von

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

vergeben wird

2

MsgVer

ans..5

M

Message version.

Values accepted

2.0

Message-Version.

Zulässiger Wert:

2.0

3

TransID

ans..64

M

Transaction identifier supplied by the merchant. Shall be unique for each payment

Transaktions-ID des Händlers, die für jede Zahlung eindeutig sein muss

4

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

settlement file (CTSF) we cannot add the additional payment data.

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	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

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

5

Amount

n..10

M

Transaction amount in it smallest unit of the submission currency

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent)

6

Currency

a3

M

ISO 4217 three-letter currency code

Währungskürzel, drei Zeichen DIN / ISO 4217

7

Capture

ans..6

O

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

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 die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.
<Zahl>	Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

8

billingDescriptor

ans..22

O

A descriptor to be printed on a cardholder’s statement. Please also refer to the additional comments made elswhere for more information about rules and regulations.

Eine Bezeichnung, die auf dem Kontoauszug des Karteninhbaers gedruckt wird. Beachten Sie bitte auch die zusätzliche Hinweise an anderer Stelle für weitere Informationen über Regeln und Vorschriften.

9

OrderDesc

ans..768

O

Order description

Beschreibung der gekauften Waren, Einzelpreise etc.

10

AccVerify

a3

O

Indicator to request an account verification (aka zero value authorization). If an account verification is requested the submitted amount will be optional and ignored for the actual payment transaction (e.g. authorization).

Values accepted

Yes

Indikator für Anforderung einer Kontoverifizierung (alias Nullwert-Authorisierung). Bei einer angeforderten Kontoverifizierung ist der übermittelte Betrag optional und wird für die tatsächliche Zahlungstransaktion ignoriert (z.B. Autorisierung).

Zulässiger Wert:

Yes

11

threeDSPolicy

JSON

O

Object specifying authentication policies and excemption handling strategies

Objekt, das Authentisierungs-Richtlinien und Vorgaben für die Ausnahmenbehandlung festlegt

12

priorAuthenticationInfo

JSON

O

Prior Transaction Authentication Information contains optional information about a 3DS cardholder authentication that occurred prior to the current transaction

Das Objekt Prior Transaction Authentication Information enthält optionale Informationen über eine Authentisierung eines 3DS-Karteninhabers, die vor der aktuellen Transaktion erfolgt ist

13

accountInfo

JSON

O

The account information contains optional information about the customer account with the merchant

Das Objekt Kontoinformationen enthält optionale Informationen über das Kundenkonto beim Händler

14

billToCustomer

JSON

C

The customer that is getting billed for the goods and / or services. Required for EMV 3DS unless market or regional mandate restricts sending this information.

Der Kunde, dem die Waren und / oder Dienstleistungen in Rechnung gestellt werden. Für EMV 3DS erforderlich, sofern nicht Markt- oder Regionalmandate die Übermittlung dieser Informationen beschränken.

15

shipToCustomer

JSON

C

The customer that the goods and / or services are sent to. Required if different from billToCustomer.

Der Kunde, an den die Waren und / oder Dienstleistungen gesendet werden. Erforderlich, falls von billToCustomer abweichend.

16

billingAddress

JSON

C

Billing address. Required for EMV 3DS (if available) unless market or regional mandate restricts sending this information.

Rechnungsadresse. For EMV 3DS erforderlich (falls verfügbar), sofern nicht Markt- oder Regionalmandate die Übermittlung dieser Informationen beschränken.

17

shippingAddress

JSON

C

Shipping address. If different from billingAddress, required for EMV 3DS (if available) unless market or regional mandate restricts sending this information.

Lieferadresse. Falls von billingAddress abweichend; für EMV 3DS erforderlich (falls verfügbar), sofern nicht Markt- oder Regionalmandate die Übermittlung dieser Informationen beschränken.

18

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.

Objekt, das Art und Reihe von Transaktionen mittels Zahlungskonto-Zugangsdaten festlegt (z.B. Kontonummer oder Zahlungs-Token), die bei einem Händler für die Verarbeitung zukünftiger Einkäufe für einen Kunden gespeichert sind. Erforderlich, falls zutreffend.

19

merchantRiskIndicator

JSON

O

The Merchant Risk Indicator contains optional information about the specific purchase by the customer.

If no shippingAddress is present it is strongly recommended to populate the shippingAddressIndicator property with an appropriate value such as shipToBillingAddress, digitalGoods or noShipment.

Der Händler-Risikoindikator enthält optionale Informationen über den bestimmten Einkauf des Kunden.

Falls shippingAddress nicht vorhanden ist, ist es dringend empfohlen, das Merkmal shippingAddressIndicator mit einem entsprechenden Wert wie shipToBillingAddress, digitalGoods oder noShipment auszufüllen.

20 subMerchantPF JSON O Object specifying SubMerchant (Payment Facilitator) details. Objekt, das die Details des SubMerchant (Payment Facilitator) angibt

21

URLNotify

an..256

M

A FQDN URL to submit the final payment result (HTTP POST). The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values please use the parameter UserData.

Eine FQDN URL zur Übermittlung des finalen Zahlungsergebnisses (HTTP POST). Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

22

URLSuccess

an..256

M

A FQDN URL for redirection of the client in case the payment was processed succefully (HTTP POST). The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values please use the parameter UserData.

Eine FQDN URL zur Weiterleitung des Kunden für den Fall, dass die Zahlung erfolgreich war (HTTP POST). Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

23

URLFailure

an..256

M

A FQDN URL for redirection of the client in case the payment could not be processed succefully (HTTP POST). The URL may be called up only via port 443. This URL may not contain parameters: In order to exchange values please use the parameter UserData.

Eine FQDN URL zur Weiterleitung des Kunden für den Fall, dass die Zahlung nicht erfolgreich war (HTTP POST). Die URL darf nur über Port 443 aufgerufen werden. Diese URL darf keine Parameter enthalten: Um Parameter durchzureichen, nutzen Sie stattdessen den Parameter UserData.

24

UserData

ans..1024

O

If specified at request,

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

forwards the parameter with the payment result to the shop

Wenn beim Aufruf angegeben, übergibt das

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	DE:Wording

den Parameter mit dem Zahlungsergebnis an den Shop

25

MAC

an64

M

Hash Message Authentication Code (HMAC) with SHA-256 algorithm

Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

will return an HTML document in the response body representing the requested card form. The form may be included in the merchant checkout page or used as a standalone page to redirect the cardholder to.

Image Removed

Cardholder authentication and payment authorization will take place once the the cardholder entered all required card details and submitted the form data to

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

.

Note: In case you are using your own templates (Corporate Payment Page), please make sure you include Cardholder name on your custom template. Cardholder name is mapped to

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

API parameter "CreditCardHolder". Cardholder name field must not contain any special characters and must have minimal length of 2 characters and maximum length of 45 characters.

When the payment is completed

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

will send a notification to the merchant server (i.e. URLNotify) and redirect the browser to the URLSuccess resepctively to the URLFailure.

The blowfish encrypted data elements as listed in the following table are transferred via HTTP POST request method to the URLNotify and URLSuccess/URLFailure.

Note
Notice: Please note that the call of URLSuccess or URLFailure takes place with a GET in case of fallback to 3-D Secure 1.0. Therefore your systems should be able to receiver parameters both via GET and via POST.

HTTP POST to URLSuccess / URLFailure / URLNotify

hosted forms the complexity of 3-D Secure is completely removed from the merchant implementation.

From a merchant point of view the sequence itself does not differ between 3DS authenticated and non-authenticated payments though 3DS requires consideration of additional data elements in the request and response.

Note

title	Notice about Cookie-/Session Handling

Please note that some browsers might block necessary cookies when returning to Your shop. Here you will find additional information and different solution approaches.

Table of Contents

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Link_CookieSessionHandling
DisableCaching	true
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Link_EMV3DS
DisableCaching	true
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Link_APIPlayground
DisableCaching	true
PageWithExcerpt	Reuse API

Payment Request

To retrieve a

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

card form please submit the following data elements via HTTP POST request method to

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

payssl.aspx.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1625489336430_-2082385216
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	payment_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1625489336432_-1792890293
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MerchantID_REST
page	MerchantID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MsgVer_REST
page	msgver
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	ReqId-ans..32_REST
page	ReqId
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	TransID_REST
page	TransID
type	page

Key

REST

Format

CND

Description

Beschreibung

RefNr

"referenceNumber": "..."

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

settlement file (CTSF) we cannot add the additional payment data.

Details on supported format can be found below in payment specific section.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

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	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

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

Informationen zum unterstützten Format finden Sie weiter unten in der zahlartspezifischen Beschreibung.

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MAC_REST
page	MAC
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Amount_REST
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency_REST
page	Currency
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Capture_REST
page	Capture
type	page

Key	REST	Format	CND	Description	Beschreibung
PayTypes	"payment": {"cardForm": { "payTypes": "..." }}	ans..256	O	With this parameter you can override the accepted schemes, i.e. you can decide within this parameter separated by pipe which of the available credit card schemes are displayed. The template must support this function like for example the "Cards_v1". Example: PayTypes=VISA\|MasterCard	Mit diesem Parameter können Sie die akzeptierten Schemes übersteuern, d.h. Sie können innerhalb dieses Parameters durch Pipe getrennt entscheiden, welche der verfügbaren Kreditkartenschemes angezeigt werden. Das Template muss diese Funktion unterstützen wie zum Beispiel das "Cards_v1". Beispiel: PayTypes=VISA\|MasterCard
billingDescriptor	"billing": {"addressInfo": { "descriptor": "..." }}	ans..22	O	A descriptor to be printed on a card holder’s statement. Please also refer to the additional comments made elsewhere for more information about rules and regulations.	Eine Bezeichnung, die auf dem Kontoauszug des Karteninhbaers gedruckt wird. Beachten Sie bitte auch die zusätzliche Hinweise an anderer Stelle für weitere Informationen über Regeln und Vorschriften.
OrderDesc	"order": {"description": "..."}	ans..768	O	Order description	Beschreibung der gekauften Waren, Einzelpreise etc.
AccVerify	"payment": {"card": { "accountVerification": "..." }}	a3	O	Indicator to request an account verification (aka zero value authorization). If an account verification is requested the submitted amount will be optional and ignored for the actual payment transaction (e.g. authorization). Values accepted `Yes`	Indikator für Anforderung einer Kontoverifizierung (alias Nullwert-Authorisierung). Bei einer angeforderten Kontoverifizierung ist der übermittelte Betrag optional und wird für die tatsächliche Zahlungstransaktion ignoriert (z.B. Autorisierung). Zulässiger Wert: `Yes`
threeDSPolicy	"payment": {"card": { "threeDsPolicy": JSON }}	JSON	O	Object specifying authentication policies and exemption handling strategies	Objekt, das Authentisierungs-Richtlinien und Vorgaben für die Ausnahmenbehandlung festlegt
priorAuthenticationInfo	"payment": {"card": { "priorAuthenticationInfo": JSON }}	JSON	O	Prior Transaction Authentication Information contains optional information about a 3DS cardholder authentication that occurred prior to the current transaction	Das Objekt Prior Transaction Authentication Information enthält optionale Informationen über eine Authentisierung eines 3DS-Karteninhabers, die vor der aktuellen Transaktion erfolgt ist
accountInfo	"accountInfo": JSON	JSON	O	The account information contains optional information about the customer account with the merchant	Das Objekt Kontoinformationen enthält optionale Informationen über das Kundenkonto beim Händler
billToCustomer	"billing": JSON	JSON	C	The customer that is getting billed for the goods and / or services. Required for EMV 3DS unless market or regional mandate restricts sending this information.	Der Kunde, dem die Waren und / oder Dienstleistungen in Rechnung gestellt werden. Für EMV 3DS erforderlich, sofern nicht Markt- oder Regionalmandate die Übermittlung dieser Informationen beschränken.
shipToCustomer	"shipping": JSON	JSON	C	The customer that the goods and / or services are sent to. Required if different from billToCustomer.	Der Kunde, an den die Waren und / oder Dienstleistungen gesendet werden. Erforderlich, falls von billToCustomer abweichend.
billingAddress	"billing": {"addressInfo": JSON}	JSON	C	Billing address. Required for EMV 3DS (if available) unless market or regional mandate restricts sending this information.	Rechnungsadresse. For EMV 3DS erforderlich (falls verfügbar), sofern nicht Markt- oder Regionalmandate die Übermittlung dieser Informationen beschränken.
shippingAddress	"shipping": {"addressInfo": JSON}	JSON	C	Shipping address. If different from billingAddress, required for EMV 3DS (if available) unless market or regional mandate restricts sending this information.	Lieferadresse. Falls von billingAddress abweichend; für EMV 3DS erforderlich (falls verfügbar), sofern nicht Markt- oder Regionalmandate die Übermittlung dieser Informationen beschränken.
credentialOnFile	"credentialOnFile": JSON	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.	Objekt, das Art und Reihe von Transaktionen mittels Zahlungskonto-Zugangsdaten festlegt (z.B. Kontonummer oder Zahlungs-Token), die bei einem Händler für die Verarbeitung zukünftiger Einkäufe für einen Kunden gespeichert sind. Erforderlich, falls zutreffend.
merchantRiskIndicator	"riskIndicator": JSON	JSON	O	The Merchant Risk Indicator contains optional information about the specific purchase by the customer. If no `shippingAddress` is present it is strongly recommended to populate the `shippingAddressIndicator` property with an appropriate value such as `shipToBillingAddress`, `digitalGoods` or `noShipment`.	Der Händler-Risikoindikator enthält optionale Informationen über den bestimmten Einkauf des Kunden. Falls `shippingAddress` nicht vorhanden ist, ist es dringend empfohlen, das Merkmal `shippingAddressIndicator` mit einem entsprechenden Wert wie `shipToBillingAddress`, `digitalGoods` oder `noShipment` auszufüllen.
subMerchantPF	"subMerchantPaymentFacilitator": JSON	JSON	O	Object specifying SubMerchant (Payment Facilitator) details. Only supported by SafeCharge	Objekt, das die Details des SubMerchant (Payment Facilitator) angibt. Wird ausschließlich von SafeCharge unterstützt.

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	URLSuccess_REST
page	URLSuccess
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	URLFailure_REST
page	URLFailure
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	URLBack_REST
page	URLBack
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Response_REST
page	Response
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	URLNotify_REST
page	URLNotify
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	UserData_REST
page	UserData
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Plain_REST
page	Plain
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Custom_REST
page	Custom
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	expirationTime_REST
page	expirationTime
type	page

Multiexcerpt

MultiExcerptName	3DS2Short3

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

will return an HTML document in the response body representing the requested card form. The form may be included in the merchant checkout page or used as a standalone page to redirect the card holder to.

Multiexcerpt

MultiExcerptName	paysslForm
shouldDisplayInlineCommentsInIncludes	false

Image Added

Card holder authentication and payment authorization will take place once the the cardholder entered all required card details and submitted the form data to

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

.

Note: In case you are using your own templates (Corporate Payment Page), please make sure you include Cardholder name on your custom template. Cardholder name is mapped to

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

API parameter "CreditCardHolder". Cardholder name field must not contain any special characters and must have minimal length of 2 characters and maximum length of 45 characters.

When the payment is completed

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

will send a notification to the merchant server (i.e. URLNotify) and redirect the browser to the URLSuccess respectively to the URLFailure.

The blowfish encrypted data elements as listed in the following table are transferred via HTTP POST request method to the URLNotify and URLSuccess/URLFailure.

Note
Notice: Please note that the call of URLSuccess or URLFailure takes place with a GET in case of fallback to 3-D Secure 1.0. Therefore your systems should be able to receive parameters both via GET and via POST.

Info

The credit card form can be highly customized by using your own template.

Details are available here: Corporate PayPage and templates

HTTP POST to URLSuccess / URLFailure / URLNotify

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RestResponse_IntroURL
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_IntroURL
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1625489403900_-1676195126
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	http_post

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1625489403902_195677908
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	MsgVer
page	msgver
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	schemeReferenceID
page	schemeReferenceID
type	page

Key Format CND Description Beschreibung

refnr O Reference number taken from request Referenznummer vom Request

Status

a..20

M

Status of the transaction.

Values accepted:

Authorized
OK (Sale)
FAILED

In case of Authentication-only the Status will be either OK or FAILED.

Status der Transaction.

Zulässige Werte:

Authorized
OK (Sale)
FAILED

Im Fall von nur-Authentisierung ist der Status entweder OK oder FAILED.

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Key

Format

CND

Description

Beschreibung

card

JSON

M

Card data

Kartendaten

ipinfo

JSON

O

Object containing IP information

Objekt mit IP-Informationen

threedsdata

JSON

M

Authentication data

Authentisierungsdaten

resultsresponse

JSON

C

In case the authentication process included a cardholder challenge additional information about the challenge result will be provided.

Falls der Authentisierungsprozess eine Challenge des Karteninhabers enthalten hat, werden zusätzliche Informationen über das Ergebnis der Challenge bereitgestellt

externalPaymentData

JSON

O

Optional additional data from acquirer/issuer/3rd party for authorization.

Optionale Daten des Acquirers/Issuers/externen Dienstleisters für eine Autorisierung

TimeStamp

Date/Time

O

Timestamp of this action if activated by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, e.g. 30.05.2023 08:47:57 or 30.05.2023 10:03:01.633

Zeitstempel dieser Aktion, wenn vom

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

aktiviert, z.B. 30.05.2023 08:47:57 oder 30.05.2023 10:03:01.633

CardHolder

ans..50

O

Card holder name if activated by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, e.g. John Doe

Name des Karteninhabers, wenn vom

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

aktiviert, z.B. Max Mustermann

bin

n..6

O

BIN of credit card if activated by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, e.g. 40001

BIN der Kreditkarte, wenn vom

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

aktiviert, z.B. 40001

maskedpan

an..19

O

Masked number of credit card if activated by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, e.g. 400001XXXXXX8323

Maskierte Kreditkartennummer, wenn vom

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

aktiviert, z.B. 400001XXXXXX8323

cardinfo

JSON

O

JSON containing data of credit card type and issuer if activated by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

, e.g. {"BIN":"400001","Brand":"VISA","Product":"","Source":"CREDIT","Type":"","Country":{"A3":"USA","N3":"840"},"Issuer":""}

JSON-Struktur, welche Informationen zur Kreditkarte bzw. dem Issuer enthält, wenn vom

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

aktiviert, z.B. {"BIN":"400001","Brand":"VISA","Product":"","Source":"CREDIT","Type":"","Country":{"A3":"USA","N3":"840"},"Issuer":""}

CCBrand

an..20

O

Brand / card scheme of credit card, e.g. VISA

Brand / Karten-Scheme der Kreditkarte, z.B. VISA

Table Excerpt Include

static	true
name	PCNr
page	PCNr
type	page

Table Excerpt Include

static	true
name	CCExpiry_Response
page	CCExpiry
type	page

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Credit card payments with separate authorisation

For credit card payments the ORDER can be separated from the subsequent authorisation and the following steps. Therefore initially the SSL credit card payment is initiated via

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

form or via Server-to-Server-connection like in the chapters above with an additional parameter. Later it is authorised using the interface authorize.aspx via server-to-server connection. For initialising visit the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

payssl.aspx

For Server-to-Server-connection it is the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

direct.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro_Short
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1640873520780_-476628106
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	direct_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1640873520782_-679184001
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key

REST

Format

CND

Description

Beschreibung

TxType

"payment": {"card": { "transactionType": "..." }}

ans..20

M

Submit “Order” to initialize a payment which later will be authorised via interface authorize.aspx. Please note that in combination with the used 3-D Secure method a separate setting is necessary. Please contact directly

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

.

Übergeben Sie „Order“, um eine Zahlung zu initialisieren und diese später über die Schnittstelle authorize.aspx zu autorisieren. Bitte beachten Sie, dass in Verbindung mit dem genutzten 3-D Secure-Verfahren eine separate Einstellung notwendig ist. Bitte wenden Sie sich hierzu direkt an

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

.

Additional parameters for credit card payments with separate authorisation

In order to authorise a previously with TxType=Order initiated SSL credit card payment, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

authorize.aspx

Notice: Please note, that for an initial order KPN/CVC/CVV-check is not possible. For the subsequent reservation request this ID also cannot be passed on.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1640873520784_594379795
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	authorize_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1640873520785_254446021
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MerchantID_REST
page	MerchantID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID_REST
page	PayID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	TransID_REST
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Amount_REST
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency_REST
page	Currency
type	page

Key	REST	Format	CND	Description	Beschreibung
OrderDesc	"order": {"description": "..."}	ans..768	O	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise etc.

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MAC_REST
page	MAC
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Capture_REST
page	Capture
type	page

Parameters for credit card payments via authorize.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

id
default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy

1624351939582

1640873542767_

1056203061

366982690
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName

http

authorize_

post

response

Table Transformer

id
dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false

1624351939584

1640873542769_-

1881547046

705906438
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

isFirstTimeEnter	true
static	true

name

v

MID

2

pageMIDtypepageKeyFormatCNDDescriptionBeschreibung

MsgVer

ans..5

M

Message version.

Accepted values:

2.0

name	MID_REST
page	mid
type	page

Message-Version.

Zulässiger Wert:

2.0

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID_REST
page	PayID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	XID_REST
page	XID
type	page

Table Excerpt Include

type
isFirstTimeEnter	true
static	true
v	2
name	TransID_REST
page	TransID

pageKeyFormatCNDDescriptionBeschreibung

schemeReferenceID

ans..64CCard scheme specific transaction ID required for subsequent credential-on-file payments, delayed authorizations and resubmssions.Spezifische Transaktions-ID des Kartenschemas, die für nachfolgende Zahlungen mit gespeicherten Zugangsdaten, verzögerte Autorisierungen und Wiedereinreichungen erforderlich ist.Statusa..20M

Staus of the transaction.

Values accepted:

Authorized
OK (Sale)
FAILED

In case of Authentication-only the Status will be either OK or FAILED.

Status der Transaction.

Zulässige Werte:

Authorized
OK (Sale)
FAILED

Im Fall von nur-Authentisierung ist der Status entweder OK oder FAILED.

	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED_REST
page	Status
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Description_REST

Table Excerpt IncludestatictruenameDescription


page	Description
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Code_REST
page	Code
type	page

Key	Format	CND	Description	Beschreibung

cardJSONMCard response dataObjekt der KartendatenipInfoJSONCObject containing IP information. Presence depends on the configuration for the merchant.Objekt mit IP-Informationen. Das Vorhandensein hängt von der Konfiguration des Händlers ab.threeDSDataJSONMAuthentication dataObjekt der AuthentisierungsdatenresultsResponseJSONCIn case the authentication process included a cardholder challenge additional information about the challenge result will be providedFalls der Authentisierungsprozess eine Aufforderung für den Karteninhaber enthalten hat, werden zusätzliche Informationen über das Ergebnis der Aufforderung bereitgestellt

RefNr

"referenceNumber": "..."

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

settlement file (CTSF) we cannot add the additional payment data.

Details on supported format can be found below in payment specific section.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	Reuse API

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	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

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

Informationen zum unterstützten Format finden Sie weiter unten in der zahlartspezifischen Beschreibung.

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	RefNr_Ascii
PageWithExcerpt	DE:Reuse API

Extended Sequence Diagram

Multiexcerpt

MultiExcerptName	Extended Sequence Diagram
shouldDisplayInlineCommentsInIncludes	false

Image Added

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Extended Sequence Diagram

Image Removed

Column

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Link_CookieSessionHandling
PageWithExcerpt	Reuse API

toc

Space shortcuts

Page tree

Versions Compared

Old Version 7

New Version Current

Key

Card processing - Credit Card Form

Simplified Sequence Diagram

Payment Request

Payment Request

HTTP POST to URLSuccess / URLFailure / URLNotify

Credit card payments with separate authorisation

Extended Sequence Diagram

Extended Sequence Diagram

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 7

New Version Current

Key

Card processing - Credit Card Form

Simplified Sequence Diagram

Payment Request

Payment Request

HTTP POST to URLSuccess / URLFailure / URLNotify

Credit card payments with separate authorisation

Extended Sequence Diagram

Extended Sequence Diagram