Terms and Definitions

Terms

Schematic overview

The following block diagram provides a high level process overview.

Process narrative

(1) ECR submits estimated amount and a Reference Number via OPI message protocol to the POI device

(2) POI device performs cardholder authentication, encrypts the PIN block and the PAN with the Computop

(3) CCV acCEPT routes the transaction to Computop Paygate

(4) Paygate  

(5) Authorization result are transferred via notification request

Please note that authorization and notification are two distinct asynchronous processes.

Notification request

Multiexcerpt include
SpaceWithExcerpt EN MultiExcerptName Platform-Name PageWithExcerpt Wording

Computop Paygate will submit a notification request via HTTP POST in order to transfer the authorization status and transaction details to the server URL as stored in the merchant configuration.

The request will be sent in real-time. If no response Paygate

Multiexcerpt include
SpaceWithExcerpt EN MultiExcerptName Platform-Kurz PageWithExcerpt Wording

will retry the notification once after 2 seconds of the first submission. In case that the retry fails Merchant System may actively request the status of the transaction once the system is available again.

Parameter

FormatConditionConfig

Description

MID

ans..30M

MerchantID, assigned by Computop

PayID

an32M

ID assigned by Paygate for the payment, e.g. for referencing in batch files

XID

an32M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Table Filter
default Beschreibung isFirstTimeEnter false hideColumns true sparkName Sparkline hidePane true datepattern dd M yy id 1623403576706_1705504988 worklog 365|5|8|y w d h m|y w d h m isOR AND separator Point (.) order 0
Multiexcerpt MultiExcerptName notification_request Table Transformer dateFormat dd M yy export-word false show-source false export-csv false id 1623403576718_-976239833 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 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 Key Format CND Description Beschreibung

TransIDans..64MUnique transaction identifier supplied by CCV acCEPT

RefNr ans..30 M Unique reference number Eindeutige Referenznummer Table Excerpt Include static true name Status

a..50M

Payment status which can be either of the following:

•       AUTHORIZED

•       FAILED

•       OK (= Captured)

Descriptionans..1024MFurther details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis! For automated payment processing please always use the code parameter.

page Status type page Table Excerpt Include static true name Description page Description type page Table Excerpt Include static true name Code page Code type page Table Excerpt Include static true name MAC page MAC type page Key Format CND Description Beschreibung Config

Coden8MError code according to Paygate Response Codes (A4 Error codes)MACan64MHash Message Authentication Code (HMAC) with SHA-256 algorithm

POSTerminalID an..20 M Terminal Identification Number assigned and linked to a specific point-of-sale (POS) terminal Terminal-Identifikationsnummer, die einem bestimmten POS-Terminal zugeordnet und damit verknüpft ist MessageType n2 M Message Type describing the performed action: 01=Sale, 02=Reversal, 03=Credit, 05=Authorisation/Reservation, 06=Incremental Authorisation, F0=Autoreversal Der Message Type beschreibt die ausgeführte Aktion: 01=Verkauf, 02=Storno, 03=Gutschrift, 05=Autorisierung/Reservierung, 06=Inkrementelle Autorisierung, F0=Autostorno DMACKSN an..20 M Serial Number of the key (DUKPT) that was used to generate the DMAC Seriennummer des Schlüssels (DUKPT), der zum Erzeugen des DMAC verwendet wurde DMAC an16 M Message Authentication Code Nachrichten-Authentisierungscode CodeExt an..10 O

X

Original code from external payment system Originaler Code vom externen Zahlungssystem AQ a..5 O

X

Acquirer Acquirer X EMVData an..2028 O

X

EMV Data EMV

Data

Daten X CCNr n12..19 O

X

Credit card number at least 12-digit, numerical without spaces Kreditkartennummer, mindestens 12 Ziffern ohne Leerzeichen X PCNr n16 O

XPaygate card token

Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Platform-Kurz PageWithExcerpt Wording card token Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt DE:Wording -Kartentoken X CCBrand a..22 O

X

Credit card brand (e.g. Visa, MasterCard, Maestro etc.) Kreditkartenmarke (z.B. Visa, MasterCard, Maestro usw.) X CCExpiry n6 O

X

Card expiry date Ablaufdatum der Karte X MaskedPan an12..19 M Masked card number (6X4) Maskierte Kartennummer (6X4) IBANEMVfield an..64 C IBAN, hex-coded, only available with Girocard HEX-kodierte IBAN, nur für Girocard baseAmount n..10 M Amount in its smallest currency unit of merchant’s local currency at the Point of Sale (POS) Betrag in der kleinsten Währungseinheit der lokalen Währung des Händlers am Point of Sale (POS) baseCurrency a3 M Merchant’s local currency at the Point of Sale (POS) Lokale Währung des Händlers am Point of Sale (POS) Amount n..10 C Amount in its smallest currency unit of card currency Betrag in der kleinsten Währungseinheit der Kartenwährung Currency a3 C Cardholder’s currency Währung des Karteninhabers dccRateValue ans13 C Applicable FX rate with 4 decimal places (e.g. ‘3.0245’) Anwendbarer Wechselkurs mit 4 Dezimalstellen (z.B. ‘3.0245’) schemeReferenceID ans..64 C Card 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. FormFactor ans..64 O Defines the form / device which has been used for payment. Currently possible values: Card Mobile Device Watch / Wristband Definiert das Gerät, das zur Zahlung verwendet wurde. Derzeit mögliche Werte: Card Mobile Device Watch / Wristband Device an..20 O Serial number of POS device Seriennummer des POS-Terminals Table Excerpt Include static true name TransactionId page TransactionId type page Key Format CND Description Beschreibung VUNr an..12 O Contract partner number Vertragspartnernummer ApprovalCode an..6 O Authorising code of transaction Autorisierungscode der Transaktion additionalresponsedata an..128 O Additional text which the operator’s processing system can send optionally in replies to payment/cutover requests. Zusätzlicher Text, den das Verarbeitungssystem des Betreibers optional als Antwort auf Zahlungs-/Umstellungsanforderungen senden kann. TerminalID a..20 O ID of the terminal ID des Terminals IBAN an..34 O International Bank Account Number International Bank Account Number TrxTime ans21 O Time stamp of transaction in the format dd.MM.yyyy HH:mm:ssff Zeitstempel der Transaktion im Format TT.MM.JJJJ HH:mm:ssff

Notice: The parameters baseAmount, baseCurrency, and dccRateValue will be only present when DCC was used. In this case the Amount and the Currency parameter correspond to the foreign values. For transaction that have been carried out without DCC the parameter Amount will refer to the amount in the merchant's local currency as given in the parameter Currency.

References

For reconciliation purposes, Computop

Merchant may transfer his Reference Number in the OPI protocol to the acCEPT server. CCV will map this element against the Paygate

Please note that acquirers do have different size limits for references that can be submitted depending on the message protocol and host capabilities.

Status inquiry

In order to inquire about the status of a payment via a Server-to-Server connection, please use the following URL:

https://www.computop-paygate.com/getStatus.aspx

Notice: For security reasons, Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter.

The following table describes the encrypted request parameters:

Parameter

Format

CND

Description

MerchantID

ans..30

M

Parameters for status inquiries via socket connections

The following table describes the Paygate response parameters:

Parameter

Description

MID

MerchantID, assigned by Computop

PayID

ID assigned by Paygate for the payment, e.g. for referencing in batch files

Notice: The parameter baseAmount, baseCurrency and dccRateValue will be only present when DCC was used. In this case AmountAuth, AmountCap and AmountCred are given in the cardholder's currency. For transaction that have been carried out without DCC all Amounts refer the merchant's local currency.

Code Listings

Brands

Acquirer