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
Section
Column
width900px

Überblick

Eine Stille Auftragserteilung oder Direkte Erteilung ist eine Übertragungsmethode, bei der Formulardaten von einer Händler-Webseite direkt an einen Server eines Dritten abgeschickt werden. Das wird üblicherweise durch das Attribut form action erreicht, welches die URL angibt, wohin die Daten zu senden sind.


Info

Sensible Daten wie Kartendetails können innerhalb der Händler-Webseite erfasst werden, ohne dass diese vom Server des Händlers verarbeitet werden, da der POST still übermittelt wird. Die URL

...

im 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Name
PageWithExcerptWording
für den Empfang von Anfragen der Stillen Auftragserteilung wird als PayNow bezeichnet.

<form action="../payNow.aspx" method="post">


Dieser Ansatz ist sehr ähnlich zu den

...

bei 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording
gehosteteten Zahlungsformularen und lässt dem Händler die volle Kontrolle über den Bezahlvorgang, da alle Elemente der Webseite vom Server des Händlers bereitgestellt werden.


Note
titlePCI-DSS Betrachtungen

Händler, die Kartentransaktionen mit dem Modell der Stillen Erteilung verarbeiten, müssen den Fragebogen PCI DSS Self-Assessment Questionnaire (SAQ) A-EP einreichen. Dieser SAQ ist umfangreicher und kann daher mehr Zeit und Ressourcen erfordern als der SAQ A für Händler, die gehostete Zahlungsseiten verwenden. Händler sollten sich jedoch immer mit ihrem Acquirer beraten, um das Maß der erforderlichen Compliance zu beurteilen und dabei die PCI DSS Richtlinien beachten. Das wirkt sich nicht auf die Verwendung von Pseudokartennummern aus, was ohne Einreichung des SAQ-Fragebogens möglich ist.

Note
titleHinweis zum Cookie-/Session Handling

Bitte beachten Sie, dass einige Browser beim Rücksprung zu Ihrem Shop erforderliche Cookies blockieren könnten. Hier finden Sie weitere Informationen und verschiedene Lösungsansätze.

Sequenzdiagramm

Image Modified

Zahlungsanfrage

Bitte übermitteln Sie die Formulardaten per POST wie in der nachstehenden Tabelle dargestellt an

...

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording
payNow.aspx.

Formularelemente

...

MerchantID

...

--

...

HändlerID, die von Computop vergeben wird

...

Len

...

--

...

Die Länge des Originals verschlüsselt mit Blowfish

...

Data

...

--

...

Per Blowfish verschlüsselte Daten

...

number

...

CCNr

...

Kartennummer

...

securityCode

...

CCCVC

...

Kartenprüfnummer

...

expiryDate

...

CCExpiry

...

Kartenablaufdatum im Format JJJJMM

...

brand

...

CCBrand

...

Kartensystem

...

cardholder

...

CreditCardHolder

...

Name des Karteninhabers, wie er auf der Karte gedruckt ist

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1625057164744_-1463149623
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameform_elements
PageWithExcerptEN:Silent Order Post (PayNow)

(- 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording

...

wird weiterhin die alten Formulardatenfelder unterstützen, die derzeit verwendet werden. -)

Daten

...

Table Filter

...

inverse

...

false

...

default

...

Description

...

MerchantID

...

ans..30

...

M

...

HändlerID, die von Computop vergeben wird

...

MsgVer

...

ans..5

...

M

...

Message-Version.

Zulässige Werte:

  • 2.0

...

TransID

...

ans..64

...

M

...

Transaktionsnummer des Händlers, die eindeutig sein muss

...

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 Computop Settlement File (CTSF) auch nicht zusätzlich angereichert werden.

...

Amount

...

n..10

...

M

...

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

...

Currency

...

a3

...

M

...

Währung, drei Zeichen DIN / ISO 4217

...

Capture

...

ans..6

...

O

...

Bestimmt Art und Zeitpunkt des Zahlungsabschlusses (d.h. Dual-Nachrichtensysteme).

Zulässige Werte:

  • AUTO = Abschluss sofort nach der Autorisierung (Standardwert)

  • MANUAL = Abschluss erfolgt durch den Händler

  • <Number> = Verzögerung in Stunden bis zum Abschluss (ganze Zahl; 1 bis 696)

...

billingDescriptor

...

ans..22

...

O

...

Ein auf dem Kontoauszug des Karteninhabers zu druckender Beschreiber. Beachten Sie bitte auch die andernorts gemachten zusätzlichen Hinweise für weitere Informationen über Regeln und Vorschriften.

...

OrderDesc

...

ans..768

...

O

...

Beschreibung der Bestellung

...

AccVerify

...

a3

...

O

...

Indikator zur Anforderung einer Konto-Verifizierung (alias Nullwert-Autorisierung). Wenn eine Konto-Verifizierung angefordert wird, ist der übermittelte Betrag optional und wird für die tatsächliche Zahlungstransaktion (d.h. Autorisierung) ignoriert.

Zulässige Werte:

  • Yes

...

threeDSPolicy

...

JSON

...

O

...

Objekt, dass die Authentisierungs-Richtlinien und Strategien zur Behandlung von Ausnahmen angibt.

...

priorAuthenticationInfo

...

JSON

...

O

...

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

...

browserInfo

...

JSON

...

M

...

Exakte Browserinformationen sind nötig, um eine optimierte Nutzererfahrung zu liefern. Erforderlich für 3DS 2.0 Transaktionen.

...

accountInfo

...

JSON

...

O

...

Die Kontoinformationen enthalten optionale Informationen über das Kundenkonto beim Händler

...

billToCustomer

...

JSON

...

C

...

Der Kunde, dem die Waren und / oder Dienstleistungen in Rechnung gestellt werden. Erforderlich, sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken.

...

shipToCustomer

...

JSON

...

C

...

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

...

billingAddress

...

JSON

...

C

...

Rechnungsadresse. Erforderlich (falls verfügbar), sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken.

...

shippingAddress

...

JSON

...

C

...

Lieferadresse. Falls abweichend von billingAddress, erforderlich (falls verfügbar), sofern nicht Markt- oder regionale Mandate das Senden dieser Informationen beschränken.

...

credentialOnFile

...

JSON

...

C

...

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.

...

merchantRiskIndicator

...

JSON

...

O

...

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

Falls keine shippingAddress vorhanden ist, ist es dringend empfohlen, die Eigenschaft shippingAddressIndicator mit einem entsprechenden Wert wie shipToBillingAddress, digitalGoods oder noShipment auszufüllen.

...

URLNotify

...

an..256

...

M

...

Eine FQDN URL zur Übermittlung des endgültigen Zahlungsergebnisses (HTTP POST)

...

URLSuccess

...

an..256

...

M

...

Eine FQDN URL zur Weiterleitung des Kunden, falls die Zahlung erfolgreich verarbeitet werden konnte (HTTP POST)

...

URLFailure

...

an..256

...

M

...

Eine FQDN URL zur Weiterleitung des Kunden, falls die Zahlung nicht erfolgreich verarbeitet werden konnte (HTTP POST)

...

userData

...

ans..1024

...

O

...

Wenn beim Aufruf angegeben, übergibt das Paygate den Parameter mit dem Zahlungsergebnis an den Shop

...

MAC

...

an64

...

M

...

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

Beispiel HTML-Formular

Code Block
languagexml
linenumberstrue
<!DOCTYPE html>
<html>
	<head>
		<title>Merchant Checkout</title>
	</head>
	<body>
		<form name="card form" action="https://www.computop-paygate.com/payNow.aspx" method="post">
			<input type="hidden" name="MerchantID" value="MerchantID">
			<input type="hidden" name="Len" value="Length of the Blowfish encrypted data">
			<input type="hidden" name="Data" value="Blowfish encrypted data">
			Cardholder:
			<input type="text" name="cardholder"><br> 
			Card number:
			<input type="text" name="number"><br>
			Expiry date:
			<input type="text" name="expiryDate"><br>
			CVV2:
			<input type="text" name="securityCode"><br>
			Card brand:
			<input type="text" name="brand"><br>
			<input type="submit" value="Submit">
		</form>
	</body>
</html>

...

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

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamedata
PageWithExcerptEN:Silent Order Post (PayNow)

Beispiel HTML-Formular

(info) BASEURL=

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording
schemas

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamesample
PageWithExcerptEN:Silent Order Post (PayNow)


Wenn die Zahlung abgeschlossen ist, sendet das 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Name
PageWithExcerptWording
eine Benachrichtigung an den Händler-Server (d.h. URLNotify) und leitet den Browser dementsprechend an URLSuccess oder URLFailure weiter.


Die in der folgenden Tabelle genannten per Blowfish evrschlüsselten Datenelemente werden per HTTP POST Anfragemethode an URLNotify und URLSuccess/URLFailure übertragen.

Note
Hinweis: Bitte beachten Sie, dass der Aufruf der URLSuccess oder URLFailure bei einem Fallback zu 3-D Secure 1.0 mit GET stattfindet. Ihre Systeme sollten daher Parameter sowohl per GET als auch per POST entgegennehmen können.

HTTP POST an URLSuccess / URLFailure / URLNotify

...

Table Filter

...

inverse

...

false

...

default

...

Description

...

MID

...

ans..30

...

M

...

HändlerID, die von Computop vergeben wird

...

MsgVer

...

ans..5

...

M

...

Message-Version.

Zulässige Werte:

  • 2.0

...

PayID

...

ans32

...

M

...

Von Computop vergebene ID für die Zahlung/Transaktion

...

XID

...

ans64

...

M

...

Vom Paygate vergebene ID für die zu einer Zahlung ausgeführte Operation

...

TransID

...

ans..64

...

M

...

Transaktionsnummer des Händlers, die für jede Zahlung eindeutig sein sollte

...

schemeReferenceID

...

ans..64

...

C

...

Kartensystemspezifische Transaktions-ID, die für nachfolgende Zahlungen mit hinterlegten Daten, verzögerte Autorisierungen und Wiedereinreichungen erforderlich ist

...

Status

...

a..20

...

M

...

Status der Transaktion.

Zulässige Werte:

  • Authorized

  • OK (Sale)

  • FAILED

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

...

Description

...

ans..1024

...

M

...

Textliche Beschreibung des Codes

...

Code

...

n8

...

M

...

Paygate-Antwortcode

...

card

...

JSON

...

M

...

Kartenantwortdaten

...

ipInfo

...

JSON

...

C

...

Objekt mit IP-Informationen. Das Vorhandensein hängt von der Konfiguration des Händlers ab.

...

threeDSData

...

JSON

...

M

...

Authentisierungsdaten

...

resultsResponse

...

JSON

...

C

...

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

...

userData

...

ans..1024

...

C

...

Wenn beim Aufruf angegeben, übergibt das Paygate den Parameter mit dem Zahlungsergebnis an den Shop

...

MAC

...

an64

...

M

...

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

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

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamehttp_post
PageWithExcerptEN:Silent Order Post (PayNow)

Column


Table of Contents

...