Versions Compared

Key

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

Include Page
Credit Card Form (paySSL)
Credit Card Form (paySSL)

Credit card - interface via form

Chart of process flow via form interface

Multiexcerpt
MultiExcerptNameSequenceDiagram_CT
shouldDisplayInlineCommentsInIncludesfalse

draw.io Diagram
bordertrue
diagramNameProcess Flow CT
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth1109

...

MultiExcerptNameSequenceDiagram_Partner
shouldDisplayInlineCommentsInIncludesfalse
draw.io Diagram
bordertrue
diagramNameProcess Flow Partner
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth1109

Process flow of Credit card payment via form interface

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameLink_CookieSessionHandling
DisableCachingtrue
PageWithExcerptReuse API

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameLink_EMV3DS
DisableCachingtrue
PageWithExcerptReuse API

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameLink_APIPlayground
DisableCachingtrue
PageWithExcerptReuse API

General parameters of the interface

The interface of the

Multiexcerpt include
SpaceWithExcerptENWORK
MultiExcerptNamePlatform-Name
PageWithExcerptWording
form is consistently payssl.aspx for all connections. In order to make a credit card payment via
Multiexcerpt include
SpaceWithExcerptENWORK
MultiExcerptNamePlatform-Name
PageWithExcerptWording
form, go to the following URL:

...

Multiexcerpt include
SpaceWithExcerptENWORK
MultiExcerptNameBaseURL
PageWithExcerptWording
payssl.aspx

This section explains the parameters which are the same for each connection. These values are always required, along with the special parameters explained in the following sections for each individual connection, e.g. GICC. The second table explains all response parameters which are also the same for all credit card connections. There are separate handbooks for credit card transactions via PagBrasil, PayU CEE and PayU LatAm connections.

Multiexcerpt include
SpaceWithExcerptENWORK
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

...

defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1624301226733_-997933319
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

...

MultiExcerptNamepayssl_request

...

dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1624301226737_19272612
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

...

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.

Table Excerpt Include
statictrue
nameURLSuccess
pageURLSuccess
typepage

Table Excerpt Include
statictrue
nameURLFailure
pageURLFailure
typepage

Table Excerpt Include
statictrue
nameURLBack
pageURLBack
typepage

Table Excerpt Include
statictrue
nameResponse
pageResponse
typepage

Table Excerpt Include
statictrue
nameURLNotify
pageURLNotify
typepage

Table Excerpt Include
statictrue
nameUserData
pageUserData
typepage

Table Excerpt Include
statictrue
nameCapture
pageCapture
typepage

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

Table Excerpt Include
statictrue
namePlain
pagePlain
typepage

Table Excerpt Include
statictrue
nameCustom
pageCustom
typepage

Table Excerpt Include
statictrue
nameexpirationTime
pageexpirationTime
typepage

General parameters for credit card payments via form

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

To adapt the layout of the SSL-page to your shop you can use the following unencrypted parameters to configure colours, fonts and images:

...

inversefalse
sparkNameSparkline
hidePanetrue
separatorPoint (.)
ddSeparatorstrue
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
datepatterndd M yy
id1624993909750_1536881410
worklog365|5|8|y w d h m|y w d h m
isORAND
order0

...

MultiExcerptNamepayssl_layout

...

dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1624993302461_78269259
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameTemplate
pageTemplate
typepage

Table Excerpt Include
statictrue
nameBackground
pageBackground
typepage

Table Excerpt Include
statictrue
nameBGColor
pageBGColor
typepage

Table Excerpt Include
statictrue
nameBGImage
pageBGImage
typepage

Table Excerpt Include
statictrue
nameFColor
pageFColor
typepage

Table Excerpt Include
statictrue
nameFFace
pageFFace
typepage

Table Excerpt Include
statictrue
nameFSize
pageFSize
typepage

Table Excerpt Include
statictrue
nameBackground
pageBackground
typepage

Table Excerpt Include
statictrue
nameBackground
pageBackground
typepage

Table Excerpt Include
statictrue
nameBackground
pageBackground
typepage

...

Key

...

Format

...

CND

...

Description

...

Language

...

a2

...

O

...

Language code: <de> German, <al> Albanian, <at> Austrian, <cz/cs> Czech, <dk> Danish, <en> English, <fi> Finish, <fr> French, <gr> Greek, <hu> Hungarian, <it> Italian, <jp> Japanese,  <nl> Dutch, <no> Norwegian, <pl> Polish, <pt> Portuguese, <ro> Romanian, <ru> Russian, <es> Spanish, <se> Swedish, <sk> Slovakian, <sl> Slovenian, <tr> Turkey, <zh> Simplified Chinese.

No details means the language is German.

...

Sprachcode: <de> deutsch, <al> albanisch, <at> österreichisch, <cz/cs> tschechisch, <dk> dänisch, <en> englisch, <fi> finnisch, <fr> französisch, <gr> griechisch, <hu> ungarisch, <it> italienisch, <jp> japanisch, <nl> holländisch, <no> norwegisch, <pl> polnisch, <pt> portugiesisch, <ro> rumänisch, <ru> russisch, <es> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> türkisch, <zh> Simplified Chinese

Ohne Angabe ist die Sprache Deutsch.

...

Table Excerpt Include
statictrue
nameURLBack
pageURLBack
typepage

Table Excerpt Include
statictrue
nameCenter
pageCenter
typepage

Table Excerpt Include
statictrue
nametWidth
pagetWidth
typepage

Table Excerpt Include
statictrue
nametHeight
pagetHeight
typepage

Table Excerpt Include
statictrue
nameCustomField[n]
pageCustomField[n]
typepage

...

Multiexcerpt include
SpaceWithExcerptENWORK
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording

...

Info

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

Details are available here: Corporate PayPage and templates

Multiexcerpt include
MultiExcerptNameResponse_IntroURL
PageWithExcerptReuse API

...

defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1624995124168_1500609408
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

...

MultiExcerptNamepayssl_response

...

dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1624995124170_78269259
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

...

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.

...

Status

...

a..50

...

M

...

OK or AUTHORIZED (URLSuccess) as well as FAILED (URLFailure)

...

OK oder AUTHORIZED (URLSuccess) sowie FAILED (URLFailure)

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Table Excerpt Include
statictrue
nameUserData
pageUserData
typepage

Table Excerpt Include
statictrue
namePCNr
pagePCNr
typepage

Table Excerpt Include
statictrue
nameCCExpiry_Response
pageCCExpiry
typepage

...

Key

...

Format

...

CND

...

Description

...

CCBrand

...

a..22

...

OC

...

In combination with PCNr: Designation of credit card brand

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

...

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 Support unter

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

...

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.

...

CAVV

...

ans..40

...

OC

...

In the case of 3-D Secure with Authentication Hosting (only 3-D request without authorisation): Cardholder Authentication Validation Value: Contains the digital signature for authentication with the ACS of the card issuing bank.

...

Bei 3-D Secure bei Authentication Hosting (nur 3-D-Abfrage ohne Autorisierung): Cardholder Authentication Validation Value: Enthält die digitale Signatur der Authentisierung am ACS der kartenausgebenden Bank.

...

ECI

...

n2

...

OC

...

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:

ValueMeaning
Yfully authenticated (complete authentication done)
Nnot enrolled (checked, but Issuer does not participate)
Uuneledgeble (technical error)
Aattempt (card does not participate)
Bbypass (bypass, only for Cardinal Commerce)

...

bei 3-D Secure Authentication Hosting:

WertBedeutung
Yfully authenticated (vollständige Authentisierung durch-geführt)
Nnot enrolled (geprüft, Issuer nimmt aber nicht teil)
Uuneledgeble (technischer Fehler)
Aattempt (Karte nimmt nicht teil)
Bbypass (Umgehen, nur für Cardinal Commerce)

...

Type

...

ans..20

...

C

...

For 3-D Secure in the response to URLSuccess and URLNotify: Abbreviation of payment type, e.g. SSL

...

Bei 3-D Secure in der Antwort an URLSuccess und URLNotify: Kürzel zur Typisierung der Zahlung, z.B. SSL

Table Excerpt Include
statictrue
namePlain
pagePlain
typepage

Table Excerpt Include
statictrue
nameCustom
pageCustom
typepage

Table Excerpt Include
statictrue
nameCustomField[n]
pageCustomField[n]
typepage

General results parameters for URLNotify, URLSuccess and URLFailure

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

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
SpaceWithExcerptENWORK
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
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
SpaceWithExcerptENWORK
MultiExcerptNameBaseURL
PageWithExcerptWording
payssl.aspx

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

...

Multiexcerpt include
SpaceWithExcerptENWORK
MultiExcerptNameBaseURL
PageWithExcerptWording
direct.aspx

Multiexcerpt include
MultiExcerptNameRequest_Intro_Short
PageWithExcerptReuse API

...

defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1624301287289_727117424
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

...

MultiExcerptNamedirect_request

...

dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1624301287291_2052109502
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

...

Key

...

Format

...

CND

...

Description

...

TxType

...

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
SpaceWithExcerptEN
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording
.

...

Ü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
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptDE: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 visit the following URL:

...

Multiexcerpt include
SpaceWithExcerptENWORK
MultiExcerptNameBaseURL
PageWithExcerptWording
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
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

...

defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1624301287293_-952105928
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

...

MultiExcerptNameauthorize_request

...

dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1624301287295_-1422498650
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
statictrue
namePayID
pagePayID
typepage

Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage

Table Excerpt Include
statictrue
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

...

Key

...

Format

...

CND

...

Description

...

OrderDesc

...

ans..768

...

Description of purchased goods, unit prices etc.

...

Beschreibung der gekauften Waren, Einzelpreise etc.

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Table Excerpt Include
statictrue
nameCapture
pageCapture
typepage

Parameters for credit card payments via authorize.aspx

Multiexcerpt include
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

...

defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1625000153670_225057595
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

...

MultiExcerptNameauthorize_response

...

dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1625000153671_-574866161
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

Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage

...

Key

...

Format

...

CND

...

Description

...

Status

...

a..50

...

OK or FAILED

...

OK oder FAILED

...

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
SpaceWithExcerptEN
MultiExcerptNamePartner-Name
PageWithExcerptWording
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
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptDE:Wording
Settlement File (CTSF) auch nicht zusätzlich angereichert werden.