Multiexcerpt includeSpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
-Schnittstelle
SpaceWithExcerpt | DE |
---|---|
MultiExcerptName | Platform-Kurz |
PageWithExcerpt | Wording |
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
POS InitiateD
Transaction typesTransaktionstypen (
AggregatedAggregierte /
Deferred Authorizationsaufgeschobene Autorisierungen)
Below the interfaces description, relevant for submitting Mass Transportation transaction types.
Nachfolgend die Schnittstellenbeschreibung, die zur Übermittlung von Mass Transportation Transaktionstypen relevant ist.
Integrations-Integration System: https://dev.computop.de/Paygate/posPayment.aspx
Production Produktiv-System: …/posPayment.aspx
|
|
|
Multiexcerpt include SpaceWithExcerpt ENDE MultiExcerptName Request_Intro PageWithExcerpt EN:Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
Table Transformer | | |||||||||||||||||||||||
dateFormat | dd M yy | |||||||||||||||||||||||
export-word | false | |||||||||||||||||||||||
show-source | false | |||||||||||||||||||||||
export-csv | false | |||||||||||||||||||||||
id | 1674039108570_-2075559078 | |||||||||||||||||||||||
transpose | false |
|
Aufrufparameter für POS-Zahlungen
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| export-pdf
| false
| ||||||||||||||||||||||||
sql | SELECT * FROM T* | |||||||||||||||||||||||||
Key | Format | CND | Description | Beschreibung | ||||||||||||||||||||||
MessageType | an2 | M | Message type for the request. Allowed values: 01 Sale (two step transaction) 05 Pre-Authorization, Authorization | Nachrichtentyp für die Anfrage. Zulässige Werte: 01 Verkauf (zweistufige Transaktion) 05 Vorautorisierung, Autorisierung |
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
RefNr
ans..30
O
Merchant’s unique reference number
For DCC: dccReferenceData (reference of DCC request)
Eindeutige Referenznummer des Händlers
Für DCC: dccReferenceData (Referenz der DCC-Anfrage)
Amount
n..10
M
Amount in the smallest currency unit (e.g. EUR Cent).
For DCC: Amount in foreign currency
Betrag in der kleinsten Währungseinheit (z. B. EUR Cent).
Für DCC: Betrag in Fremdwährung
Currency
a3
M
Currency, three digits DIN / ISO 4217
For DCC: Foreign currency
Währung, drei Zeichen DIN / ISO 4217
Für DCC: Fremdwährung
POSTerminalID
an..20
M
TerminalID of the POS device
Device
an16
M
Serial number of POS device
CCNr
n8..19
C
PAN of the card. For credit cards only the number. For ELV the PAN consisting of country prefix, short sort code, account number and check digit
CCBrand
an..22
M
Brand: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP. Please note spelling!
For ELV always use SEPAELV!
Marke: VISA, MasterCard, Maestro, AMEX, DINERS, JCB, CUP. Bitte beachten Sie die richtige Schreibweise!
Für ELV verwenden Sie immer SEPAELV!
CCCVC
n..4
O
Card validation code: The last 3 digit next to the signature field on the card, 4 digits for AMEX
CCExpiry
n6
M
Mandatory for credit cards. Expiry date of the card (YYYYMM), e.g. 202207
CCSeqNr
n3
O
Card sequence number
Track2
an..224
C
Mandatory for magnet stripe read (MSR). Data of track2 for MSR or Track2Equivalent (Tag 57) (hex representation)
EMVData
an..2048
C
EMV data that is forwarded to the acquirer (BER TLV hex representation). Drop this parameter if there is no EMV data, e.g. MSR
EntryMode
n3
C
Mandatory for credit cards. POS Entry Mode (Tag 9F39)
OrderDesc
ans..200
O
Description of sold goods, unit price, etc.
AccVerify
a..3
O
Allowed value: YES
Used to initiate an account verification (zero value auth). Amount may be zero.
Zulässiger Wert: YES
Wird verwendet, um eine Kontoüberprüfung zu initiieren (Nullwert-Authentifizierung). Der Betrag kann Null sein.
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
ans..25
O
Text printed on the customer’s credit card bill alongside the payee.
Note: For MasterCard the length is limited to 22 while for VISA 25.
Text, der neben dem Zahlungsempfänger auf der Kreditkartenabrechnung des Kunden gedruckt wird.
Hinweis: Für MasterCard ist die Länge auf 22 Zeichen begrenzt, bei VISA hingegen auf 25.
This field is used to override the default Merchant Name in the Authorization request. (A PTO aggregator ID can be passed through)
DataEncrypted
an. 2048
O
Merchant can submit the Encrypted value of (PAN + Track 2 Equivalent Data in TLV format). If case this field is provided the CCNr is not required.
DataKSN
an. 20
C
KSN value generated from the terminal and required to Decrypt the Data present in 'DataEncrypted' parameter.
Request parameter for POS payments
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Response_Intro PageWithExcerpt EN:Reuse API
default | Beschreibung |
---|---|
isFirstTimeEnter | false |
hideColumns | true |
sparkName | Sparkline |
hidePane | true |
datepattern | dd M yy |
id | 1674039132622_450008748 |
worklog | 365|5|8|y w d h m|y w d h m |
isOR | AND |
separator | Point (.) |
order | 0 |
MultiExcerptName | POS_initiateD_response |
---|
dateFormat | dd M yy |
---|---|
export-word | false |
show-source | false |
export-csv | false |
id | 1674039132624_-559052784 |
transpose | false |
worklog | 365|5|8|y w d h m|y w d h m |
separator | . |
export-pdf | false |
sql | SELECT * FROM T* |
Key
Format
CND
Description
MessageType
an2
M
Message type for the request
Table Excerpt Include static true name MID page EN:mid type page
Table Excerpt Include static true name PayID page EN:PayID type page
Table Excerpt Include static true name XID page EN:XID type page
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include static true name Status_OK_FAILED page EN:Status type page
Table Excerpt Include static true name Description page EN:Description type page
Table Excerpt Include static true name Code page EN:Code type page
Key
Format
CND
Description
RefNr
ans..30
O
Merchant’s unique reference number
POSTerminalID
an..20
M
TerminalID of the pin entry device
CodeExt
an2
M
Acquirer response code
Approvalcode
n..6
C
Only for credit card, only if configured: Authorization code form the authorization response
EMVData
an..2048
C
For credit card: Acquirer response (hex representation). Consists of ‚Issuer Authorization Response Code‘ (Tag 8A), Issuer Scripts (Tag 71, 72), Issuer Authentication Data (Tag 91) etc.
For ELV: IBAN (Tag 5F53) and Creditor ID (Tag DF65), format see annex EMV Data elements
Bei Kreditkarte: Acquirer-Antwort (Hex-Darstellung). Besteht aus ‚Issuer Authorization Response Code‘ (Tag 8A), Issuer Scripts (Tag 71, 72), Issuer Authentication Data (Tag 91) usw.
Bei ELV: IBAN (Tag 5F53) und Gläubiger-ID (Tag DF65), Format siehe Anhang EMV-Datenelemente
VUNr
ans..20
O
Only for credit card: Contract partner number. Configured in merchant settings.
TerminalID
ans..20
O
Only for credit card: ID, used for data exchange between
and the acquirer. Configured in merchant settings. Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Partner-Name PageWithExcerpt EN:Wording
Nur bei Kreditkarte: ID für den Datenaustausch zwichen
und dem Acquirer. In den Händlereinstellungen konfiguriert. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Partner-Name PageWithExcerpt Wording
AQ
ans..30
O
Only if configured: Acquirer shortcut
TrxTime
ans21
O
Time stamp of transaction in the format dd.MM.yyyy HH:mm:ssff
AdditionalResponseData
ans..99
O
Only for credit card, only if configured: Additional Response Data taken from acquirer response
Table Excerpt Include static true name PCNr page EN:PCNr type page
Key
Format
CND
Description
Last4CardholderPAN
n..4
O
VISA last 4 digits of the embossed PAN when tokenised DPAN was used in the request
PAR
ans…999
O
Payment Account Reference data provided by VISA/MC used mainly by MTT merchants to identify a customer in their back-office system
EmbossedPANPCNr
n..19
O
(MC/Maestro only) Provided only for Mass Transit transaction types and is a second CT PKN that it refers to the Embossed PAN of the physical card. Received in Acquirer response when tokenised PAN was send in request.
EmbossedPANExpiryDate
n..4 (YYMM)
O
(MC/Maestro only) Provided only for Mass Transit transaction types and is the expiration date of the Embossed PAN received from the Acquirer in response.
OriginalCode
ans..3
O
Contains the original response code (BM 60.68 Scheme response code) from payment schemes authorization platforms.
schemeReferenceID
ans..64
O
Card scheme specific transaction ID required for subsequent credential-on-file payments, delayed authorizations and resubmissions.
|
Antwortparameter für POS-Zahlungen
POS Incremental (Maestro-Szenario)
Integrations-System: https://dev.computop.de/Paygate/posPayment.aspx
Produktiv-System: …/posPayment.aspx
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Incremental
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwortparameter für Incremental
Manuelle Stornierung (POS)
Integrations-System: https://dev.computop.de/Paygate/posPayment.aspx
Produktiv-System: …/posPayment.aspx
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Stornierung
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwortparameter für Stornierung
Automatisches Inkasso (MIT & VISA Resubmission)
Diagramm des Prozessablaufs über Server-zu-Server
Für die Server-zu-Server-Zahlungsvorgänge beachten Sie bitte das Handbuch Programmiergrundlagen.
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Prozessablauf einer Zahlung über Server-zu-Server-Schnittstelle
Aufruf der Schnittstelle: allgemeine Parameter
Um einen TLS-Notify über eine Server-zu-Server-Verbindung durchzuführen, verwenden Sie bitte folgende URL:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
ECOM Inkasso (ATB-Webportal) per Formular
Diagramm des Prozessablaufs über die Formularschnittstelle
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Prozessablauf der Kreditkartenzahlung über Formula-Schnittstelle
Für ECOM Inkasso sind die Aufruf- und Antwortparameter die gleichen wie bei der Übermittlung einer normalen E-Commerce-Transaktion.
Hinweis: Als Anforderung in MTT von VISA und MasterCard sollte diese Art von Transaktionen immer über den 3DS-Authentifizierungsprozess durchgeführt werden.
Es besteht die Möglichkeit, solche Transaktionen als 3DS 1.0 über unsere Legacy-API: Kreditkarten einzureichen.
Oder über den neuen Authentifizierungsablauf EMV 3DS 2.0 mit der folgenden Online-API: Kreditkartenformular (paySSL).
Integrationshandbuch und Tools
Nachfolgende Dokumente beschreiben ausführlicher, wie Nachrichten richtig programmiert und an die
API-Endpunkte gesendet werden. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Partner-Name PageWithExcerpt Wording
Um Programmierern die Integration des
zu erleichtern, gibt es einen hilfreichen ZIP-Ordner mit Code-Beispielen und Funktionen in verschiedenen Programmiersprachen. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
Response parameter for POS payments
POS Incremental (Maestro scenario)
Integration System: https://dev.computop.de/Paygate/posPayment.aspxProduction System: …/posPayment.aspx
posPayment.aspx Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName BaseURL PageWithExcerpt EN:Wording
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Request_Intro PageWithExcerpt EN:Reuse API
default | Beschreibung |
---|---|
isFirstTimeEnter | false |
hideColumns | true |
sparkName | Sparkline |
hidePane | true |
datepattern | dd M yy |
id | 1674039149057_911686471 |
worklog | 365|5|8|y w d h m|y w d h m |
isOR | AND |
separator | Point (.) |
order | 0 |
MultiExcerptName | POS_incremental_request |
---|
dateFormat | dd M yy |
---|---|
export-word | false |
show-source | false |
export-csv | false |
id | 1674039149058_-1649282945 |
transpose | false |
worklog | 365|5|8|y w d h m|y w d h m |
separator | . |
export-pdf | false |
sql | SELECT * FROM T* |
Key
Format
CND
Description
MessageType
an2
M
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include static true name PayID page EN:PayID type page
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
POSTerminalID
an..20
M
TerminalID of the pin entry device
Device
an16
M
Serial number of pin entry device
EntryMode
n3
M
Mandatory for credit cards. POS Entry Mode.
CCSeqNr
n3
C
Required in all transactions where chip-card is present and the chip card contains a Card Sequence Number, otherwise optional in requests.
Track2
an..224
C
Mandatory for Magnetic Stripe Read (MSR). Data of track 2 with MSR or Track2EquivalentData (tag 57) (in hex formatting).
EMVData
an..2048
C
EMV data as required for passing on to the acquirer (in hex formatting). The exact structure is determined by the protocol used, which is stored in the master data of the terminal. If no EMV data is available, e.g. for MSR, then omit this parameter completely.
DataEncrypted
an..2048
O
Merchant can submit the Encrypted value of (PAN + Track 2 Equivalent Data in TLV format). This only in case the Merchant cannot handle clear text data as a non-PCI DSS.
DataKSN
an. 20
C
KSN value generated from the terminal and required to Decrypt the Data present in 'DataEncrypted' parameter.
Parameter for Incremental
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Response_Intro PageWithExcerpt EN:Reuse API
default | Beschreibung |
---|---|
isFirstTimeEnter | false |
hideColumns | true |
sparkName | Sparkline |
hidePane | true |
datepattern | dd M yy |
id | 1674039162512_-761318645 |
worklog | 365|5|8|y w d h m|y w d h m |
isOR | AND |
separator | Point (.) |
order | 0 |
MultiExcerptName | POS_incremental_response |
---|
dateFormat | dd M yy |
---|---|
export-word | false |
show-source | false |
export-csv | false |
id | 1674039162515_1045971575 |
transpose | false |
worklog | 365|5|8|y w d h m|y w d h m |
separator | . |
export-pdf | false |
sql | SELECT * FROM T* |
Key
Format
CND
Description
MessageType
an2
M
Message type from request
Table Excerpt Include static true name MID page EN:mid type page
Table Excerpt Include static true name PayID page EN:PayID type page
Table Excerpt Include static true name XID page EN:XID type page
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include static true name Status_OK_FAILED page EN:Status type page
Table Excerpt Include static true name Description page EN:Description type page
Table Excerpt Include static true name Code page EN:Code type page
Key
Format
CND
Description
CodeExt
an2
M
Acquirer response code
POSTerminalID
an..20
M
TerminalID of the pin entry device
VUNr
ans..20
O
Only for credit card: Contract partner number
TerminalID
ans..20
O
Only for credit card: ID, used for data exchange between
and the acquirer. Configured in merchant settings. Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Partner-Name PageWithExcerpt EN:Wording
Nur bei Kreditkarte: ID für den Datenaustausch zwichen
und dem Acquirer. In den Händlereinstellungen konfiguriert. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Partner-Name PageWithExcerpt Wording
AQ
ans..30
O
Only if configured: Acquirer shortcut
TrxTime
ans21
O
Time stamp of transaction in the format dd.MM.yyyy HH:mm:ssff
OriginalCode
ans3
O
Card Scheme original response code
Response parameter for Incremental
Manual Reversal (POS)
Integration System: https://dev.computop.de/Paygate/posPayment.aspxProduction System: …/posPayment.aspx
posPayment.aspx Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName BaseURL PageWithExcerpt EN:Wording
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Request_Intro PageWithExcerpt EN:Reuse API
default | Beschreibung |
---|---|
isFirstTimeEnter | false |
hideColumns | true |
sparkName | Sparkline |
hidePane | true |
datepattern | dd M yy |
id | 1674039186076_1929892266 |
worklog | 365|5|8|y w d h m|y w d h m |
isOR | AND |
separator | Point (.) |
order | 0 |
MultiExcerptName | manual_reversal_request |
---|
dateFormat | dd M yy |
---|---|
export-word | false |
show-source | false |
export-csv | false |
id | 1674039186077_756338104 |
transpose | false |
worklog | 365|5|8|y w d h m|y w d h m |
separator | . |
export-pdf | false |
sql | SELECT * FROM T* |
Key
Format
CND
Description
MessageType
an2
M
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include static true name PayID page EN:PayID type page
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
POSTerminalID
an..20
M
TerminalID of the pin entry device
Device
an16
M
Serial number of pin entry device
Parameter for reversal
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Response_Intro PageWithExcerpt EN:Reuse API
default | Beschreibung |
---|---|
isFirstTimeEnter | false |
hideColumns | true |
sparkName | Sparkline |
hidePane | true |
datepattern | dd M yy |
id | 1674039197387_-1956152476 |
worklog | 365|5|8|y w d h m|y w d h m |
isOR | AND |
separator | Point (.) |
order | 0 |
MultiExcerptName | manual_reversal_response |
---|
dateFormat | dd M yy |
---|---|
export-word | false |
show-source | false |
export-csv | false |
id | 1674039197389_-1941373165 |
transpose | false |
worklog | 365|5|8|y w d h m|y w d h m |
separator | . |
export-pdf | false |
sql | SELECT * FROM T* |
Key
Format
CND
Description
MessageType
an2
M
Table Excerpt Include static true name MID page EN:mid type page
Table Excerpt Include static true name PayID page EN:PayID type page
Table Excerpt Include static true name XID page EN:XID type page
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include static true name Status_OK_FAILED page EN:Status type page
Table Excerpt Include static true name Description page EN:Description type page
Table Excerpt Include static true name Code page EN:Code type page
Key
Format
CND
Description
CodeExt
an2
M
Acquirer response code
POSTerminalID
an..20
M
TerminalID of the pin entry device
VUNr
ans..20
O
Only for credit card: Contract partner number
TerminalID
ans..20
O
Only for credit card: ID, used for data exchange between
and the acquirer. Configured in merchant settings. Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Partner-Name PageWithExcerpt EN:Wording
Nur bei Kreditkarte: ID für den Datenaustausch zwichen
und dem Acquirer. In den Händlereinstellungen konfiguriert. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Partner-Name PageWithExcerpt Wording
AQ
ans..30
O
Only if configured: Acquirer shortcut
TrxTime
ans21
O
Time stamp of transaction in the format dd.MM.yyyy HH:mm:ssff
OriginalCode
ans3
O
Card Scheme original response code
Response parameter for Reversal
Automatic Debt Recovery (MIT & VISA Resubmission)
Chart of process flow via Server-to-Server
For the server-to-server payment processes please refer to the programming basics manual.
Multiexcerpt | ||
---|---|---|
| ||
Process flow of a payment via server-to-server interface
Call of interface: general parameters
To carry out a TLS Notify via a Server-to-Server connection, please use the following URL:
direct.aspx Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName BaseURL PageWithExcerpt EN:Wording
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Request_Intro PageWithExcerpt EN:Reuse API
default | Beschreibung |
---|---|
isFirstTimeEnter | false |
hideColumns | true |
sparkName | Sparkline |
hidePane | true |
datepattern | dd M yy |
id | 1674039235110_-338700335 |
worklog | 365|5|8|y w d h m|y w d h m |
isOR | AND |
separator | Point (.) |
order | 0 |
MultiExcerptName | debt_recovery_request |
---|
dateFormat | dd M yy |
---|---|
export-word | false |
show-source | false |
export-csv | false |
id | 1674039235113_1545945358 |
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 | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
Amount3D
n..12
C
Only for 3DSecure: 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 the
, if you want to capture amounts < 100 (smallest currency unit). Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Helpdesk-Name PageWithExcerpt EN:Wording
Nur für 3DSecure: Betrag für die Authentifizierung mit Verified, SecureCode und SafeKey, falls der Amount abweicht. Z.B. Kunde bestätigt Flugkosten von 120 Euro mit „Verified“, aber das 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
, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Helpdesk-Name PageWithExcerpt Wording
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
CCNr
n..19
M
Credit card number at least 12-digit, numerical without spaces. You can optionally transmit also a pseudo card number (PCN).
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 für Clearhaus
CCExpiry
n6
M
Expiry date of the credit card in the format YYYYMM, e.g. 202707
CCBrand
a..22
M
Credit card brand.
Please note the spelling! According to table of credit card brands!
Kreditkartenmarke.
Bitte beachten Sie die richtige Schreibweise gemäß Tabelle der Kreditkartenmarken!
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Key
Format
CND
Description
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.
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)
HTTPAccept
ans..128
C
Only for 3DSecure: MIME types that the customer's client accepts. E.g. image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd. ms-powerpoint, ap-plication/vnd. ms-excel, application/msword, */*
RefNr
ns..15
O
Merchant’s unique reference number
OrderDesc
ans..768
O
Description of purchased goods, unit prices etc.
ChDesc
ans..25
O
Text printed on the customer’s credit card bill alongside the payee
This field is used to override the default Merchant Name in the Authorization request. (A PTO aggregator ID can be passed through)
AccVerify
a3
O
If AccVerify=YES, the card will be checked at the acquirer according to the Acquirer’s interface description. The merchant has to submit only this parameter, the parameter "Amount" is optional. If "Amount" is used, we replace the amount according to acquirer’s interface description. At payment always Amount=0 is stored.
Allowed value: yes
Bei AccVerify=YES wird die Karte beim Acquirer gemäß der Schnittstellenbeschreibung des Acquirers geprüft. Der Händler muss nur diesen Parameter übermitteln, der Parameter „Amount“ ist optional. Wenn „Amount“ verwendet wird, ersetzen wir den Betrag gemäß der Schnittstellenbeschreibung des Acquirers. Bei Zahlung wird immer Amount=0 gespeichert.
Zulässiger Wert: yes
schemeReferenceID
ans..64
C
Card scheme specific transaction ID required for subsequent credential-on-file payments, delayed authorizations and VISA resubmissions.
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Response_Intro PageWithExcerpt EN:Reuse API
default | Beschreibung |
---|---|
isFirstTimeEnter | false |
hideColumns | true |
sparkName | Sparkline |
hidePane | true |
datepattern | dd M yy |
id | 1674039247861_1992153579 |
worklog | 365|5|8|y w d h m|y w d h m |
isOR | AND |
separator | Point (.) |
order | 0 |
MultiExcerptName | debt_recovery_response |
---|
dateFormat | dd M yy |
---|---|
export-word | false |
show-source | false |
export-csv | false |
id | 1674039247863_1466002784 |
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 EN:mid type page
Table Excerpt Include static true name PayID page EN:PayID type page
Table Excerpt Include static true name XID page EN:XID type page
Table Excerpt Include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Table Excerpt Include static true name Status page EN:Status type page
Table Excerpt Include static true name Description page EN:Description type page
Table Excerpt Include static true name Code page EN:Code type page
Table Excerpt Include static true name PCNr page EN:PCNr type page
Key
Format
CND
Description
CCExpiry
n6
OC
Optional in combination with PCNr: Expiry date of the credit card in the format YYYYMM (202706)
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 Kombination mit PCNr: Bezeichnung der Kreditkartenmarke.
Bitte beachten Sie die richtige Schreibweise gemäß Tabelle der Kreditkartenmarken!
MaskedPan
an..19
OC
Masked card number 6X4
AboID
ans..32
O
For subscriptions: Unique ID assigned by
for the subscription. Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Platform-Kurz PageWithExcerpt EN:Wording
Für Abonnements: Eindeutige ID, die dem Abonnement vom
zugewiesen wurde. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
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.
ECI
n2
O
For 3D Secure: ACS E-Commerce indicator: defines the security level of a credit card payment via different communication paths: MOTO, SSL, Verified by Visa etc.
DDD
a1
C
for 3D Secure Authentication Hosting:
Y - fully authenticated (complete authentication done)
N - not enrolled (checked, but Issuer does not participate)
U – un-eligible (technical error)
A – attempt (card does not participate)
B – bypass (bypass, only for Cardinal Commerce)
for 3D Secure Authentication Hosting:
Y - vollständig authentifiziert (vollständige Authentifizierung erfolgt)
N - nicht angemeldet (geprüft, aber Issuer nimmt nicht teil)
U – nicht berechtigt (technischer Fehler)
A – Versuch (Karte nimmt nicht teil)
B – Bypass (Bypass, 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 authorization to the Acquiring Bank.
Last4CardholderPAN
N..4
O
VISA last 4 digits of the embossed PAN when tokenized DPAN was used in the request
PAR
ans…999
O
Payment Account Reference data provided by VISA/MC used mainly by MTT merchants to identify a customer in their back-office system
OriginalCode
ans3
O
Card Scheme original response code
ECOM Debt Recovery (ATB web Portal) via Form
Chart of process flow via form interface
Multiexcerpt | ||
---|---|---|
| ||
Process flow of Credit card payment via form interface
For ECOM Debt Recovery the parameter Request and Response are the same as of submitting a normal Ecommerce transaction.
Note: As a requirement in MTT from VISA and MasterCard this type of transactions should always be carried out through 3DS Authentication process.
There is a possibility to submit such transactions as 3DS 1.0 using our legacy API: Card processing.
Or through the new EMV 3DS 2.0 Authentication flow using the below online API: Credit Card Form (paySSL)
Integration Manual and Tools
Below documents describing in more details how to properly program and send messages towards
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
To make it easier for programmers who would like to integrate
there is also a helpful ZIP folder containing sample code snippet’s and functions in different programing languages. Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Platform-Kurz PageWithExcerpt EN:Wording