• DeutschEnglish

EVOxml

Logo

Info

EVOxml

Typ

Zahlungen per Kreditkarte

Einleitung

Weitere Informationen zu Acquirern und Anbindung, Integration mit dem Computop Paygate und Implementierung von 3-D Secure (2.x) finden Sie im Kapitel Kreditkarten - Allgemeine Einführung.

Spezifische Parameter für EVOxml

Für die Kreditkartenanbindung Credorax sind neben den oben beschriebenen allgemeinen Parametern noch nachstehende Parameter zusätzlich zu übergeben. Eine Autorisierung mittels 3-D Secure ist möglich.

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

 Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter, welche zusätzlich zu denen im Abschnitt "Allgemein per Formular" bzw. "Allgemein per Server-zu-Server" übergeben werden müssen:

Key

Format

CND

Beschreibung

MARP

a3

O

Nicht bei 3-D Secure: bei EVO Payments International das MARP (Maestro Advance Registration Program™) aktivieren: <yes> oder <no>

CustomerID

an..20

O

Kundennummer: Nummer zur Identifizierung des Kunden

RefNr

ans..20

M

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.

Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie ("Umlaute", ...) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, ...).

(nur Großbuchstaben erlaubt)

AccVerify

a3

O

Ist AccVerify=Yes wird die Karte beim Acquirer entsprechend der Schnittstellenbeschreibung des Acquirers geprüft. Der Händler muss nur diesen Parameter übergeben, der Parameter "Amount" ist optional. Wenn "Amount" verwendet wird, ersetzen wir den Betrag entsprechend der Schnittstellenbeschreibung des Acquirers. Am Payment wird immer Amount=0 gespeichert.Zulässiger Wert: yes

OrderDesc

an..30

O

Beschreibung der gekauften Waren, Einzelpreise etc.

RTF

a1

O

bei wiederkehrenden Zahlungen (Abos):

I: Initialzahlung eines neuen Abos

R: Wiederkehrende Zahlung (Recurring)

S: Wiederkehrende Zahlung (Installment/Ratenzahlung)

Für außerplanmäßige Zahlungen (z. B. UCOF oder per App):

E: Initialzahlung mit Speicherung der Zahlungsdaten

C: Vom Kunden initiierte Zahlung (CIT) mit hinterlegten Zahlungsdaten (1-Click-Shopping)

M: Vom Händler initiierte Zahlung (MIT) mithinterlegten Zahlungsdaten (UCOF)

ChDesc

an..30

O

Dynamischer Textbestandteil des Buchungstextes von Kreditkarteneinzügen

Kontaktdaten

FirstName

ans..30

O

Vorname des Kunden (für Fraud Screening optional)

LastName

ans..30

O

Nachname des Kunden (für Fraud Screening Pflicht)

AddrStreet

an..46

O

Straßenname des Kunden (für Fraud Screening Pflicht)

AddrStreetNr

an..35

O

Hausnummer des Kunden (für Fraud Screening optional)

AddressAddition

ans..6

O

Adresszusatz (für Fraud Screening optional)

AddrPOBox

n..35

O

Postfach (für Fraud Screening optional)

AddrZip

an..9

O

Postleitzahl des Kunden (für Fraud Screening Pflicht)

AddrCity

an..40

O

Ort des Kunden (für Fraud Screening Pflicht)

AddrDistrict

ans..40

O

Bezirk/Region (für Fraud Screening optional)

AddrState

a2

O

Code des Bundeslandes des Kunden (für Fraud Screening optional)

AddrCountryCode

a2

M

Ländercode im Format ISO-3166-1, alphanumerisch 2-stellig (für Fraud Screening optional)

eMail

an..80

O

E-Mail-Adresse des Kunden (für Fraud Screening Pflicht)

Phone

ans..20

O

Telefonnummer des Kunden (für Fraud Screening Pflicht)

MiddleName

ans..30

O

Zweiter Vorname

Salutation

ans..10

O

Anrede, z.B. Herr oder Frau, Pflichtfeld bei Fraud Screening

Title

ans..20

O

Titel, z.B. Dr. oder Prof.

CompanyOrPerson

a1

O

F=Firma, P=Person, Pflichtfeld bei Fraud Screening

DateOfBirth

n8

O

Geburtsdatum im Format YYYYMMDD

Gender

a1

O

Geschlecht: <m> männlich oder <w> weiblich

WorkPhone

ans..20

O

Telefonnummer am Arbeitsplatz

Fax

ans..20

O

Faxnummer

E-Mail

ans..80

O

E-Mail-Adresse

NewCustomer

ans..5

O

Neukunde: Yes oder No

DateOfRegistration

ans8

O

Datum der Registrierung (YYYYMMDD)

SocialSecurityNumber

ans..9

O

Sozialversicherungsnummer

DrivingLicenceNumber

ans..37

O

Führerscheinnummer

Lieferdaten

sdFirstName

an..30

O

Vorname in der Lieferadresse

sdLastName

ans..25

O

Nachname in der Lieferadresse

sdMiddleName

ans..30

O

Zweiter Vorname in der Lieferadresse

sdStreet

an..46

O

Straßenname in der Lieferadresse

sdStreet2

an..46

O

Adresszusatz in der Lieferadresse

sdZip

an..9

O

Postleitzahl in der Lieferadresse

sdZIPCode

an..9

O

Postleitzahl in der Lieferadresse

sdCity

an..40

O

Ort in der Lieferadresse

sdState

a2

O

Staat/Land in der Lieferadresse

sdCountryCode

a2

O

Ländercode der Lieferadresse im Format ISO-3166-1, alphanumerisch 2-stellig

sdeMail

an..80

O

E-Mail-Adresse in der Lieferadresse

sdPhone

ans..20

O

Telefonnummer in der Lieferadresse

sdWorkPhone

ans..20

O

Zweite Telefonnummer / Telefonnummer am Arbeitsplatz in der Lieferadresse

Parameter für AVS (Adressverifikation)

CreditCardHolder

ans..60

O

Name des Karteninhabers (für AVS Pflicht)

chStreet

an..46

C

Straßenname des Kreditkarteninhabers (für AVS Pflicht)

chHouseNumber

an..35

O

Hausnummer des Kreditkarteninhabers (für AVS optional)

chPOBox

an..9

O

Postfach des Kreditkarteninhabers (für AVS Pflicht)

chCoField

an..40

O

Großempfängername des Kreditkarteninhabers (für AVS optional)

chZipCode

an..9

O

Postleitzahl des Kreditkarteninhabers (für AVS Pflicht)

chCity

an..40

O

Ort des Kreditkarteninhabers (für AVS Pflicht)

chDistrict

an..40

O

Ortsteil des Kreditkarteninhabers (für AVS optional)

chState

an2

O

2-stelliger Code für den Bundesstaat des Kreditkarteninhabers (nur für USA) (für AVS optional)

chCountryCode

a2

O

Ländercode des Kreditkarteninhabers im Format ISO-3166-1, alphanumerisch 2-stellig (für AVS Pflicht)

Alle folgenden Parameter beziehen sich auf das gekaufte Flugticket

TicketNr

an..15

C

Referenz auf das gekaufte Flugticket

PassengerName

an..49

C

Name des Flugpassagiers

FlightDate

an..5

C

Flugdatum. Format: DDMMM (z. B. 15MAY, 01NOV, 30JUN)

Origin1

an..5

C

Internationaler Code für den Abflughafen

Origin2

an..5

C

Internationaler Code für den Abflughafen

Origin3

an..5

C

Internationaler Code für den Abflughafen

Origin4

an..5

C

Internationaler Code für den Abflughafen

Destination1

an..5

C

Internationaler Code für den Zielflughafen

Destination2

an..5

C

Internationaler Code für den Zielflughafen

Destination3

an..5

C

Internationaler Code für den Zielflughafen

Destination4

an..5

C

Internationaler Code für den Zielflughafen

Carrier1

an..4

C

Internationaler Code für die Fluggesellschaft

Carrier2

an..4

C

Internationaler Code für die Fluggesellschaft

Carrier3

an..4

C

Internationaler Code für die Fluggesellschaft

Carrier4

an..4

C

Internationaler Code für die Fluggesellschaft

fsSkip

an..4

O

„YES“ = Überspringen des Fraud Screening.Übersteuert Händlerkonfiguration

fsIgnore

an..6

O

„YES“ = Ignorieren des Fraud-Screening-Ergebnisses.Übersteuert Händlerkonfiguration

fsReject

a1

O

Aufruf zur Steuerung von Fraud ScreeningC: Transaktion akzeptieren bei CHALLENGEE: Transaktion akzeptieren bei ERROR

avsSkip

an..4

C

„YES“ = Überspringen des AVS

avsIgnore

an..6

C

„YES“ = Ignorieren des Ergebnisses des AVS

avsReject

a..7

C

Liste von Ergebnis-Codes, die die Transaktion abweisen

NI: Ablehnung nur, wenn Postleitzahl und Straße nicht stimmen

ABNI: Ablehnung: Straße stimmt nicht oder Straße und Postleitzahl stimmen nicht.

WZPNI: Ablehnung: Postleitzahl stimmt nicht oder Straße und Postleitzahl stimmen nicht.

ABWZPNI: Ablehnung: Mindestens eines der Elemente AddrStreet und AddrZipCode stimmt nicht.

Zusätzliche Parameter für Kreditkartenzahlungen

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

diese Antwort-Parameter kommen zusätzlich zu den Standard-Parametern aus den Abschnitten "Allgemein per Formular" bzw. "Allgemein per Server-zu-Server"

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Key

Format

CND

Beschreibung

RefNr

ans..20

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.

Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie ("Umlaute", ...) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, ...).

(nur Großbuchstaben erlaubt)

ErrorText

ans..128

O

Fehlertext von EVOxml, wenn mit Computop Helpdesk abgesprochen

FSMatch

an..9

O

ACCEPT: Transaktion annehmen, Risiko gering

DENY: Transaktion ablehnen, Risiko hoch

CHALLENGE: Transaktion zusätzlich prüfen, Risiko nicht ein-deutig

ERROR: Interner Fehler

AVMatch

a1

O

Ergebnis der Adressprüfung, siehe A3 AVS Match-Parameter

TrxTime

an21

M

Zeitstempel der Transaktion im Format dd.MM.yyyy HH:mm:ssff

AQ

an3

M

Kürzel für Acquirer

AuthCode

ans..6

M

Autorisierungscode der Acquirer-Bank

Zusätzliche Ergebnis-Parameter für Kreditkartenzahlungen

Kreditkarten - Kreditkartenformular

Weitere Informationen zur Kreditkartenabwicklung über Formulare finden Sie im Kapitel Kreditkartenformular (paySSL).

Kreditkarten - Server-2-Server Integration

Weitere Informationen zur Kreditkartenabwicklung über Server-zu-Server-Kommunikation finden Sie im Kapitel Server-2-Server Integration.

Buchung / Gutschrift / Storno

Weitere Informationen zu Buchung, Gutschrift, Stornierung und Kreditkartenzahlung über POS-Terminals finden Sie im Kapitel Kreditkarten - Buchung / Gutschrift / Storno / PayNow / Batch.

PayNow

Weitere Informationen zu PayNow finden Sie im Kapitel Kreditkarten - Buchung / Gutschrift / Storno / PayNow / Batch.

Batch-Nutzung der Schnittstelle

Weitere Informationen zur Batch-Verarbeitung finden Sie im Kapitel Kreditkarten - Buchung / Gutschrift / Storno / PayNow / Batch.

Paygate

Documentation (EN)

Dokumentation (DE)

Paygate Status