Versions Compared

Old Version 4

changes.mady.by.user Admin

Saved on

compared with

New Version 5

changes.mady.by.user Admin

Saved on

Key

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

Card processing - interface via Server-to-Server

Chart of process flow via Server-to-Server

For the server-to-server payment processes please refer to the programming basics manual.


Process flow of a payment via server-to-server interface


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameLink_EMV3DS
DisableCachingtrue
PageWithExcerptReuse API

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameLink_APIPlayground
DisableCachingtrue
PageWithExcerptReuse API


Call of interface: general parameters

Notice: For credit card payments with 3-D Secure, please note the different cases as explained separately in the chapter at the start of the handbook. If the credit card is registered for Verified or SecureCode or SafeKey, the next phase is divided into two steps of authentication and payment. However it always begins in the same way via the direct.aspx interface. The first response however is the receipt of Javascript code or other parameters in order to carry out a second call up of the direct3d.aspx interface. Only after that, do you receive the listed parameter as a response.

To carry out a TLS credit card payment via a Server-to-Server connection, call the following URL:

Multiexcerpt include
SpaceWithExcerptENWORK
MultiExcerptNameBaseURL
PageWithExcerptWording
direct.aspx


Multiexcerpt include
SpaceWithExcerptENWORK
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1624301432140_466032178
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamedirect_request
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1624301432143_-546010462
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_AmountMac
DisableCachingtrue
PageWithExcerptReuse API


Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

TransactionID which should be unique for each payment

Please note for some connections the different formats that are given within the specific parameters.

TransaktionsID, die für jede Zahlung eindeutig sein muss

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

Amount3D

n..10

C

Only for 3-D Secure: Amount for authentication with Verified, SecureCode and SafeKey if Amount deviates. E.g. Customer confirms flight costs of 120 Euros with 'Verified' but the travel agent captures only the booking fee of 20 Euros: Amount3D=12000; Amount=2000. Amount in the smallest currency unit (e.g. EUR Cent)

Please contact

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording
, if you want to capture amounts < 100 (smallest currency unit).

Nur bei 3-D Secure: Betrag für die Authentisierung mit Verified, Secure-Code und SafeKey, falls der Zahlbetrag (Amount) abweicht. Z.B. bestätigt der Kunde mit Verified Flugkosten von 120 Euro, aber sein Reisebüro bucht nur die Buchungsgebühr von 20 Euro: Amount3D=12000; Amount=2000. Betrag in kleinster Währungseinheit (z.B. EUR Cent)

Bitte wenden Sie sich an den 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptDE:Wording
, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

CCNr

n..19

M

Credit card number at least 12-digit, numerical without spaces. You can optionally transmit also a pseudo card number (PCN)

Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer übergeben

CCCVC

n..4

O

Optional, not with ATOS: Card verification number: The last 3 digits on the signature strip of the credit card. 4 numbers in the case of American Express.

Mandatory for Clearhaus

Optional, nicht bei ATOS: Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.

Pflicht bei Clearhaus

CCExpiry

n6

M

Expiry date of the credit card in the format YYYYMM, e.g. 201707.

Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 201707

CCBrand

a..22

M

Credit card brand.

Please note the spelling! According to table of credit card brands!

Kreditkartenmarke.

Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

Table Excerpt Include
statictrue
nameCapture
pageCapture
typepage

Key

Format

CND

Description

Beschreibung

OrderDesc

ans..768

M

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise etc.

TermURL

ans..256

C

Only for 3DSecure: URL of the shop which has been selected by the Access Control Server (ACS) of the bank to transmit the result of the authentication. The bank transmits the parameters PayID, TransID and MerchantID via GET and the PAResponse parameter via POST to the TermURL.

Nur bei 3DSecure: URL des Shops, die vom Access Control Server (ACS) der Bank aufgerufen wird, um das Ergebnis der Authentisierung zu übermitteln. Dabei übergibt die Bank per GET die Parameter PayID, TransID, MerchantID und per POST den Parameter PAResponse an die TermURL.

UserAgent

ans..128

C

Only for 3DSecure: Browser type of the purchaser who requests the page. For example: IE Mozilla/4. 0 (compatible; MSIE 6.0; Windows NT 5.0; NET CLR 1.0.3705)

Nur bei 3DSecure: Browsertyp des Käufers, der die Seite aufruft. Zum Beispiel: IE Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; .NET CLR 1.0.3705)

HTTPAccept

ans..128

C

Only for 3DSecure: MIME types that the customer's client accept. E.g. image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd. ms-powerpoint, application/vnd. ms-excel, application/msword, */*

Nur bei 3DSecure: Welche MIME-Typen der Client des Endkunden akzep-tiert. Z.B. image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-powerpoint, applica-tion/vnd.ms-excel, application/msword, */*

Table Excerpt Include
statictrue
nameReqId-ans..32
pageReqId
typepage

General parameters for credit card payments via socket connection

(info) Please note the additional parameter for a specific credit card integration in the section "Specific parameters"


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1624301443905_-1169025882
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamedirect_response
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1624301443907_-2061394066
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_MidPayIdXidCode
DisableCachingtrue
PageWithExcerptReuse API

Key

Format

CND

Description

Beschreibung

TransID

ans..64

M

Merchant’s transaction number

Please note for some connections the different formats that are given within the specific parameters.

Transaktionsnummer des Händlers

Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.

Status

a..50

M

OK or AUTHORIZED as well as FAILED

OK oder AUTHORIZED sowie FAILED

PCNr

n16

O

Pseudo Card Number: Random number generated by 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Name
PageWithExcerptWording
which represents a genuine credit card number. The pseudo card number (PCN) starts with 0 and the last 3 digits correspond to those of the real card number. You can use the PCN like a genuine card number for authorisation, capture and credits.

Pseudo Card Number: Vom

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Name
PageWithExcerptDE:Wording
generierte Zufallszahl, die eine reale Kreditkartennummer repräsentiert. Die Pseudokartennummer (PKN) beginnt mit 0, und die letzten 3 Stellen entsprechen denen der realen Kartennummer. Die PKN können Sie wie eine reale Kartennummer für Autorisierung, Buchung und Gutschriften verwenden.

CCExpiry

n6

OC

Optional in combination with PCNr: Expiry date of the credit card in the format YYYYMM (201706).

Optional in Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format YYYYMM (201706).

CCBrand

a..22

OC

Optional in combination with PCNr: Designation of credit card brand.

Please note the spelling! According to table of credit card brands!

Optional in Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke.

Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!

MaskedPan

an..19

OC

Masked card number 6X4. If you want to receive the parameter MaskedPan, please contact

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording
which can activate the return.

Maskierte Kartennummer 6X4. Wenn Sie den Parameter MaskedPan erhalten möchten, wenden Sie sich bitte an den

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptDE:Wording
, der die Rückgabe aktivieren kann.

CAVV

ans..40

O

In the case of authentication hosting: Cardholder Authentication Validation Value: Contains the digital signature for authentication with the ACS of the card issuing bank.

bei Authentication Hosting: Cardholder Authentication Validation Value: Enthält die digitale Signatur der Authentisierung am ACS der kartenausgebenden Bank.

ECI

n2

O

For 3-D Secure: ACS E-Commerce indicator: defines the security level of a credit card payment via different communication paths: MOTO, SSL, Verified by Visa etc.

Bei 3-D Secure: E-Commerce Indicator des ACS: Definiert die Sicherheitsstufe einer Kreditkartenzahlung über verschiedene Kommunikationswege: MOTO, SSL, Verified by Visa etc.

DDD

a1

C

for 3-D Secure Authentication Hosting:

Y -  fully authenticated (complete authentication done)

N -  not enrolled (checked, but Issuer does not participate)

U -  uneledgeble (technical error)

A – attempt (card does not participate)

B – bypass (bypass, only for Cardinal Commerce)

Bei 3-D Secure Authentication Hosting:

Y -  fully authenticated (vollständige Authentisierung durch-geführt)

N -  not enrolled (geprüft, Issuer nimmt aber nicht teil)

U -  uneledgeble (technischer Fehler)

A – attempt (Karte nimmt nicht teil)

B – bypass (Umgehen, nur für Cardinal Commerce)

ACSXID

ans..40

O

Only in the case of 2 / 3, with Authentication Hosting: ID for transaction identification. The ACSXID is transferred with the authorisation to the Acquiring Bank.

nur bei Fall 2 / 3, bei Authentication Hosting: ID zur Identifizierung der Transaktion. Die ACSXID wird mit der Autorisierung an den Acquirer übertragen.


General response parameters for credit card payments via socket connection

(info) Please note the additional parameter for a specific credit card integration in the section "Specific parameters"