Logo | |
Info | Heartland |
Typ |
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 Heartland
Für die Kreditkartenanbindung Heartland sind neben den oben beschriebenen allgemeinen Parametern noch nachstehende Parameter zusätzlich zu übergeben.
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 |
RefNr | ns..30 | 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, ...). |
Kontaktdaten/Adressverifikation (AVS) | |||
LastName | ans..100 | O | Nachname des Kunden |
FirstName | ans..100 | O | Vorname des Kunden |
AddrZip | ans..20 | O | Postleitzahl |
AddrStreet | ans..128 | O | Straßenname und Hausnummer |
AddrState | a2 | O | Code des Bundeslandes des Kunden |
AddrCountryCode | a2/a3 | M | Ländercode im Format ISO-3166-1, alphanumerisch 2-stellig oder 3-stellig |
AddrCity | ans..50 | O | Ort |
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 | ns..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. 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, ...). |
ErrorText | ans..128 | O | Fehlertext vom nachgelagertem System, nur wenn dessen Rückgabe mit Computop Helpdesk abgesprochen ist. |
CodeExt | ans..10 | O | Nur wenn konfiguriert: externer Fehlercode (nachgelagertes System) |
ApprovalCode | an6 | O | Externer Genehmigungscode (nachgelagertes System). Nur vorhanden, wenn die Autorisierung erfolgreich war. |
HpsTransactionID | n10 | O | Von Heartland vergebene TransaktionsID: wird zurückgegeben, wenn die Autorisierung okay ist |
HpsReferenceNumber | n12 | O | Von Heartland vergebene ReferenceNumber: wird zurückgegeben, wenn die Autorisierung okay ist |
Match | a1 | O | Ergebnis der Adressprüfung: Der Parameter wird je nach Merchant-Konfiguration zurückgeliefert – als vereinfachter Match-Parameter oder wie von Heartland zurückgegeben; Details finden Sie hier: A3 AVS Match-Parameter |
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.