When requesting card payments via Computop 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 information and different solution approaches. |
![](/download/attachments/26247769/paySSL_merchant_view.png?version=1&modificationDate=1567693327606&api=v2)
To retrieve a Computop Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Partner-Name |
---|
PageWithExcerpt | Wording |
---|
| card form please submit the following data elements via HTTP POST request method to https://www.computop-paygate.com/payssl.aspx. Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | BaseURL |
---|
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* |
---|
| |
|
| ConditionCND | Description | Beschreibung |
---|
1 | MerchantID | ans..30 | M | Merchant identifier assigned by |
|
|
| Computop. 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 | Message-Version. Zulässiger Wert: | 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 |
|
|
| Computop 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 |
|
|
| payment completion (i.e. dual message systems).Values accepted: AUTO = completion capture. Capture Mode | Description |
---|
AUTO | Capturing immediately after authorisation (default value). | MANUAL |
|
|
|
| = completion | Capturing made by the merchant |
|
|
|
|
NUMBER = . Capture is normally initiated at time of delivery. | <Number> | Delay in hours until the |
|
|
|
| completion 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 | 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: | 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 |
|
|
| between Paygate and shop, 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 |
|
|
| between Paygate and shop, 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 between Paygate and shop, 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 | |
|
|
| Paygate 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 |
---|
| Computop Paygate 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.
![](/download/attachments/26247769/3DS_HPP_ct_paymentpage.jpg?version=1&modificationDate=1605264520721&api=v2)
Cardholder authentication and payment authorization will take place once the the cardholder entered all required card details and submitted the form data to Computop Paygate 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 Paygate 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 Computop Paygate 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 |