Payment Pages Feldspezifikation

Die folgenden Felder können in der POST enthalten sein, die von Ihrer Website an Payment Pages übermittelt wird.

Anforderungen:

Alle Feldnamen müssen in Kleinbuchstaben angegeben werden.
Übermitteln Sie nicht mehrere Felder mit demselben Namen in einer einzigen POST, es sei denn, die Dokumentation lässt dies zu.
Es wird empfohlen, dass der eingereichte Text in UTF-8 kodiert ist.
Sonderzeichen müssen in der URL kodiert werden (z. B. sollte "&" als "%26" übermittelt werden).

Erforderliche Felder

Die folgenden Felder sind in jedem POST an Payment Pages erforderlich:

Zusätzlich zu den unten aufgeführten erforderlichen Feldern sollten Sie sich auch die Zeit nehmen, alle Abschnitte in diesem Artikel zu den Feldern zu lesen, die als " bedingt" gekennzeichnet sind. Diese Felder können je nach Ihrer Einrichtung erforderlich sein.

Feld	Format	Beschreibung
sitereference	Alphanumerisch & Unterstrich (50)	Identifiziert Ihre Website auf dem System Trust Payments . Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.
currencyiso3a	Alpha (3)	Die Währung , in der die Transaktion verarbeitet wird, im ISO3A-Format.
mainamount	Numerisch (14)	Der Betrag der Transaktion in Haupteinheiten. Geben Sie nur den Wert des Betrags und die Dezimalstelle an (keine Kommas). z.B. €10,99 würde als 10.99 übermittelt werden Währungen wie der japanische Yen, die keine Dezimalstelle benötigen, werden ohne diese angegeben. z.B. 1000 Yen wären 1000
version	Numerisch (1)	Dieser Wert wird auf 2 gesetzt.
stprofile	Alphanumerisch (20) Nur Kleinbuchstaben. Interpunktion und Leerzeichen sind nicht erlaubt.	Wird verwendet, um das Styling festzulegen, mit dem Payment Pages gerendert wird. Bei Verwendung des Standardaussehens ist dies auf "default" eingestellt. Klicken Sie hier für weitere Informationen.
sitesecurity	Sicherheits-Hashwert der Website	Wird verwendet, um den Sicherheits-Hash der Anfrageseite im POST zu übermitteln.

Felder für die Rechnungsstellung

Sie können auch die folgenden Rechnungsfelder in der POST übermitteln:

Überschreitet ein übermitteltes Abrechnungsfeld die maximal zulässige Länge (wie in der Tabelle unten dokumentiert), wird ein Feldfehler zurückgegeben (errorcode 30000).

Feld	Format	Beschreibung
billingprefixname	Alphanumerisch einschließlich Symbole (25)	Das Präfix des Rechnungsnamens, aus der folgenden Liste: Herr, Frau, Dr., Prof., Hochwürden, Sir, Lord, Lady, Dame & Mx.
billingfirstname	Alphanumerisch einschließlich Symbole (127)	Die Rechnungsvorname. Erforderlich für Visa Secure Data Field Mandate. Erforderlich für Glücksspielanbieter.
billingmiddlename	Alphanumerisch einschließlich Symbole (127)	Der mittlere Name der Rechnung.
billinglastname	Alphanumerisch einschließlich Symbole (127)	Die Rechnungsnachname. Erforderlich für Visa Secure Data Field Mandate. Erforderlich für Glücksspielanbieter.
billingpremise	Alphanumerisch einschließlich Symbole (25)	Die Hausnummer oder die erste Zeile der Rechnungsadresse.
billingstreet	Alphanumerisch einschließlich Symbole (127)	Die für die Rechnungsadresse eingegebene Straße.
billingtown	Alphanumerisch einschließlich Symbole (127)	Die für die Rechnungsadresse eingegebene Stadt.
billingcounty	Alphanumerisch einschließlich Symbole (127)	Der für die Rechnungsadresse eingegebene Bezirk. Dies wird angezeigt als "State code (eg. NY)” auf Seiten mit dem Gebietsschema "us_US". Bei US-Adressen wird der Bundesstaat in dieses Feld eingegeben. Gültige Formate: Bevorzugt: Zweistelliger Staatencode, z. B. "NY". Vollständiger Name des Staates (keine Abkürzungen), z. B. "New York".
billingpostcode	Alphanumerisch (25)	Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a eingereicht werden.
billingcountryiso2a	Alpha (2)	Das für die Rechnungsadresse eingegebene Land im ISO2A-Format.
billingemail	E-Mail (255)	Die Adresse Rechnungs-E-Mail . Diese kann dann für die Korrespondenz mit dem Kunden verwendet werden. Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Zeichen). Erforderlich für Visa Secure Data Field Mandate, wenn billingtelephone nicht angegeben ist.
billingtelephone	Alphanumerisch einschließlich Symbole (20)	Die Telefonnummer für die Rechnungsstellung. Gültige Zeichen: Ziffern 0-9 Räume Sonderzeichen: + - ( ) Erforderlich für Visa Secure Data Field Mandate, wenn billingemail nicht angegeben ist.
billingtelephonetype	Saibling (1)	Der Typ der eingegebenen Telefonnummer. Die verfügbaren Optionen sind: H = Heim M = Handy W = Arbeit

Kundenfelder

Sie können auch Angaben zu einer zusätzlichen Adresse für den Kunden machen. Dies bezieht sich in der Regel auf die Lieferadresse. Diese Felder sind unten aufgeführt:

Wenn ein Kundenfeld die maximal zulässige Länge überschreitet (wie in der nachstehenden Tabelle angegeben), wird ein Feldfehler zurückgegeben (errorcode 30000).

Feld	Format	Beschreibung
customerprefixname	Alphanumerisch einschließlich Symbole (25)	Das Präfix für den Kundennamen, aus der folgenden Liste: Herr, Frau, Dr., Prof., Hochwürden, Sir, Lord, Lady, Dame & Mx.
customerfirstname	Alphanumerisch einschließlich Symbole (127)	Den Vornamen des Kunden.
customermiddlename	Alphanumerisch einschließlich Symbole (127)	Der zweite Vorname des Kunden.
customerlastname	Alphanumerisch einschließlich Symbole (127)	Der Nachname des Kunden.
customerpremise	Alphanumerisch einschließlich Symbole (25)	Die Hausnummer oder die erste Zeile der Kundenadresse.
customerstreet	Alphanumerisch einschließlich Symbole (127)	Die für die Kundenadresse eingegebene Straße.
customertown	Alphanumerisch einschließlich Symbole (127)	Die für die Kundenadresse eingegebene Stadt.
customercounty	Alphanumerisch einschließlich Symbole (127)	Der für die Kundenadresse eingegebene Bezirk. Dies wird angezeigt als "State code (eg. NY)” auf Seiten mit dem Gebietsschema "us_US". Bei US-Adressen wird der Bundesstaat in dieses Feld eingegeben. Gültige Formate: Bevorzugt: Zweistelliger Staatencode, z. B. "NY". Vollständiger Name des Staates (keine Abkürzungen), z. B. "New York".
customerpostcode	Alphanumerisch (25)	Die Postleitzahl oder der ZIP-Code des Kunden. Es muss sich um eine gültige Postleitzahl für den customercountryiso2a eingereicht werden. Erforderlich, wenn Kunden Categorie Nummer (MCC) 6012 ist.
customercountryiso2a	Alpha (2)	Das für die Kundenadresse eingegebene Land im ISO2A-Format. Erforderlich, wenn Kunden Categorie Nummer (MCC) 6012 ist.
customeremail	E-Mail (255)	Die E-Mail Adresse des Kunden. Diese kann dann für die Korrespondenz mit dem Kunden verwendet werden. Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Symbol).
customertelephone	Alphanumerisch einschließlich Symbole (20)	Die Telefonnummer des Kunden. Gültige Zeichen: Ziffern 0-9 Räume Sonderzeichen: + - ( )
customertelephonetype	Saibling (1)	Der Typ der eingegebenen Telefonnummer. Die verfügbaren Optionen sind: H = Heim M = Handy W = Arbeit

Abrechnung Felder

Sie können die folgenden optionalen Felder in die POST-Datei aufnehmen, um Abrechnung zu beeinflussen.

Feld

Format

Beschreibung

settleduedate

Datum JJJJ-MM-TT

Verwenden Sie dieses Feld, um Abrechnung bis zum angegebenen Datum zu verschieben
(im Format JJJJ-MM-TT).

settlestatus

Numerisch (3)

Lassen Sie die Felder leer oder geben Sie "0" ein, um das Standardverhalten von Abrechnung zu wählen.

Geben Sie "1" ein, um die Betrugs- und Duplikatsprüfungen außer Kraft zu setzen, wenn diese in Ihrem Konto aktiviert wurden.

Geben Sie "2" ein, um Abrechnung manuell auszusetzen. Die Transaktion bleibt so lange ausgesetzt, bis Sie die Abrechnungsstatus zu einem späteren Zeitpunkt mit Portal aktualisieren.

(Nur von ausgewählten Acquirern unterstützt) Reichen Sie "100" ein, um die Transaktion sofort nach Autorisierung abzurechnen. Wenden Sie sich an das Support-Team, um zu prüfen, ob Ihr Acquirer dies unterstützt.

Zeichensatz

Damit die Daten übertragen werden können, kodiert der Browser des Kunden sie mit einer Zeichenkodierung. Unsere Server müssen diese Kodierung (oder den Zeichensatz) kennen, um die Daten korrekt entschlüsseln zu können. Viele Browser stellen diese Information nicht zur Verfügung. In diesem Fall gehen wir davon aus, dass die Zeichenkodierung ISO-8859-1 ist. Dies ist mit allen Browsern kompatibel, kann aber dazu führen, dass einige Zeichen (insbesondere nicht-westliche Zeichen) falsch interpretiert werden.

Sie können den Browser anweisen, den richtigen Zeichensatz anzugeben, indem Sie ein verstecktes Feld "_charset_" in Ihr HTML-Formular einfügen. Die Browser füllen den Wert dieses Feldes automatisch mit dem von ihnen verwendeten Zeichensatz, so dass es nicht notwendig ist, einen Wert für dieses Feld anzugeben:

<INPUT TYPE=hidden NAME="_charset_" />

Felder anfordern

Feld	Format	Beschreibung
authmethod	Alpha (11)	Um die in Ihrem Konto angegebene Standardauthentifizierungsmethode manuell außer Kraft zu setzen. Unterstützte Werte sind: "PRE" - Vor-Autorisierung "FINAL" - Endgültige Autorisierung Der Inhalt von authmethod hat keinen Einfluss auf den Status Abrechnung der Transaktion. Der Status Abrechnung kann mit settlestatus und settleduedate. Klicken Sie hier, um mehr über den Prozess Abrechnung zu erfahren.
credentialsonfile	Numerisch (1)	Erforderlich für die Speicherung von Zahlungsinformationen für zukünftige Transaktionen. Für Kunden, die zum ersten Mal eine Transaktion auf Ihrer Website durchführen, müssen Sie credentialsonfile=1 angeben, wenn die Zahlungsdaten für zukünftige Transaktionen gespeichert werden sollen. Klicken Sie hier, um mehr zu erfahren.
dcctype	Alpha (3)	Erforderlich bei der Durchführung von DCC Transaktionen. Klicken Sie hier, um mehr über DCC zu erfahren.
locale	Alphanumerisch einschließlich Unterstriche (5)	Standardmäßig wird Payment Pages dem Kunden in englischer Sprache angezeigt, es sei denn, Sie ändern dies mit den nachstehenden Werten: cy_GB = Walisisch, Vereinigtes Königreich da_DK = Dänisch, Dänemark de_DE = Deutsch, Deutschland en_US = Englisch, Vereinigte Staaten en_GB = Englisch, Vereinigtes Königreich es_ES = Spanisch, Spanien fr_FR = Französisch, Frankreich it_IT = Italienisch, Italien nl_NL = Niederländisch, die Niederlande no_NO = Norwegisch, Norwegen sv_SE = Schwedisch, Schweden Klicken Sie hier für weitere Informationen zu diesem Bereich.
orderreference	Alphanumerisch einschließlich Symbole (25) Empfohlene Länge 25 Zeichen oder weniger (die genaue Länge hängt von der erwerbenden Bank ab). Die Nichteinhaltung dieser Anforderung kann dazu führen, dass der Text in der Transaktion abgeschnitten wird.	Ihre eigene Referenz für die Transaktion. Dies kann beim Abgleich von Transaktionen mit Aufträgen in Ihrem System nützlich sein. Wenn Sie das orderreference in Ihren Site-Sicherheitshash einfügen, werden nur alphanumerische Zeichen und die folgenden Sonderzeichen unterstützt: ~ ! # $ % ^ & * ( ) _ { } [ ] < > , ?
operatorname	Alphanumerisch (255)	Sie können dieses Feld verwenden, um den Namen des Betreibers, der die Zahlung über Payment Pages durchführt, zu erfassen. Dieser wird in unseren Aufzeichnungen gespeichert und kann später unter Portal eingesehen werden. Wenn dieser Wert nicht in der POST übermittelt wird, ist er standardmäßig "paymentpages". Dieser Wert wird auf der Website Payment Pages nicht angezeigt (vorausgesetzt, der Kontotyp ist "ECOM"). Wenn Sie sich für die Übermittlung des operatorname wählen, empfehlen wir Ihnen, Ihr Sicherheits-Hash zu aktualisieren, um dieses Feld einzuschließen, indem Sie sich an unser Support-Team wenden.
paymenttypedescription	Alpha (20)	Ermöglicht es Ihnen, die Zahlungsmethode für die Transaktion zu wählen, wenn Sie Reise B verwenden.
requesttypedescriptions	Alpha (20)	Dient zur Angabe von Anfragetypen, die verarbeitet werden sollen, wenn Erweitertes Post in Ihrem Konto aktiviert ist.
scaexemptionindicator	Numerisch (1)	Wird verwendet, um die 3-D Secure Authentifizierung in bestimmten Szenarien zu umgehen, in denen dies zulässig ist. Vorbehaltlich der Bedingungen - klicken Sie hier, um mehr zu erfahren. Hinweis: Wird nur von bestimmten Acquiring-Banken unterstützt. Kontaktieren Sie unser Support-Team für weitere Informationen. Bitte wenden Sie sich an Ihre erwerbende Bank und prüfen Sie, ob Sie Ausnahmeregelungen anwenden dürfen, bevor Sie Ihre Anträge entsprechend aktualisieren. Geben Sie einen der folgenden Werte an: 1 - Niedriger Wert 2 - Analyse des Transaktionsrisikos 3 - Vertrauenswürdiger Händler 4 - Sichere Unternehmenszahlungen 5 - Delegierte Authentifizierung

Benutzerdefinierte Felder

Sie können benutzerdefinierte Felder in Ihrem POST übergeben. Die Feldnamen müssen nicht in Groß- und Kleinschreibung angegeben werden und werden nicht in der Datenbank gespeichert. Eine zusätzliche Konfiguration ist nicht erforderlich.

Benutzerdefinierte Felder können nach der Verarbeitung einer Transaktion an Ihr System zurückgegeben werden, indem sie in eine Weiterleitung aufgenommen werden und/oder eine URL-Benachrichtigung konfiguriert wird.

Zwar gibt es für benutzerdefinierte Felder keine Spezifikation für gültige Werte, doch muss sichergestellt werden, dass der Wert nicht als Teil eines bösartigen Angriffs missbraucht werden kann. Wo immer möglich, empfehlen wir Folgendes:

Verwenden Sie Standardbuchstaben und -ziffern innerhalb des ASCII-Zeichensatzes, möglichst ohne Sonderzeichen, insbesondere bei den Feldnamen.
Alle Dateiverweise, die Sie definieren, sollten einen vollständigen Pfad und nicht einen relativen Pfad verwenden.
Halten Sie Felder und Werte so kurz wie möglich.

Zusätzliche Überlegungen

Die maximal zulässige Länge von benutzerdefinierten Feldnamen, die übermittelt werden können, beträgt 100 Zeichen. Alle benutzerdefinierten Feldnamen, die diese Grenze überschreiten, werden abgeschnitten oder verursachen einen Fehler.
Feldnamen sollten nicht mit "_html" enden.

Felder zur Personalisierung

Feld

Format

Beschreibung

stdefaultprofile

Alpha und Unterstriche (20)

Unterstützte Werte:

"st_paymentcardonly"
"st_cardonly"
"st_iframe_cardonly"

Klicken Sie hier für weitere Informationen.

strequiredfields

Alpha

Geben Sie Felder an, die vom Kunden eingegeben werden müssen (mehrere Felder werden unterstützt).

Erforderlich für Visa Secure Data Field Mandate.

Erfahren Sie mehr über das Mandat Erfahren Sie mehr über strequiredfields

Apple Pay Felder

Sie können die folgenden optionalen Felder in Ihrem POST übermitteln, um die Art und Weise zu ändern, wie der Kunde auf Payment Pages nach seinen Adressdaten gefragt wird:

Feld

Format

Beschreibung

billingcontactdetailsoverride

Numerisch (1)

Die Rechnungsadresse für die Zahlung:

"0" - Verwendet die auf der Website Payment Pages eingegebenen (oder gebuchten) Daten.
"1" - Verwendet die Angaben im Apple Pay Konto des Kunden.

Bleibt dieses Feld leer, wird die auf Payment Pages eingegebene (oder gebuchte) Adresse verwendet.

customercontactdetailsoverride

Numerisch (1)

Die Kundenadresse (Lieferadresse) für die Zahlung:

"0" - Verwendet die auf der Website Payment Pages eingegebenen (oder gebuchten) Daten.
"1" - Verwendet die Angaben im Apple Pay Konto des Kunden.

Bleibt dieses Feld leer, wird die auf Payment Pages eingegebene (oder gebuchte) Adresse verwendet.

PayPal-Felder

Feld	Format	Beschreibung
paypaladdressoverride	Numerisch (1)	Legen Sie fest, wie die Lieferadresse bei der Verarbeitung von Zahlungen mit PayPal eingegeben werden soll. Wenn Sie die PayPal-Adressüberschreibungsfunktion verwenden, können in bestimmten Szenarien andere Lieferfelder erforderlich sein. Klicken Sie hier, um mehr zu erfahren.
paypallocaleiso2a	Alpha (2)	Verwenden Sie dieses Feld, um den auf der PayPal Kasse angezeigten Inhalt zu lokalisieren. Eine vollständige Liste der unterstützten Werte, die in diesem Feld eingegeben werden können (z. B. paypallocaleiso2a=GB für Großbritannien), finden Sie in der Dokumentation PayPal (Link zu externer Seite).

Regelfelder

Feld	Format	Beschreibung
allurlnotification	URL Maximale Länge des Bereichs 75	Dies ist die URL, an die die Benachrichtigung nach jeder Anfrage gesendet wird, wenn STR-10 aktiviert ist.
declinedurlredirect	URL Maximale Länge des Bereichs 75	Dies ist die URL, zu der der Browser des Kunden nach einer abgelehnten Transaktion umgeleitet wird, wenn STR-7 aktiviert ist.
declinedurlnotification	URL Maximale Länge des Bereichs 75	Dies ist die URL, an die die Benachrichtigung nach einer abgelehnten Transaktion gesendet wird, wenn STR-9 aktiviert ist.
ruleidentifier	Alphanumerisch und Bindestriche	Wird verwendet, um Regeln für jede einzelne Anfrage zu aktivieren (mehrere Felder werden unterstützt).
stextraurlredirectfields	Alpha	Dies wird verwendet, um zusätzliche Felder in Weiterleitungen aufzunehmen.
stextraurlnotifyfields	Alpha	Dies wird verwendet, um zusätzliche Felder in URL-Benachrichtigungen aufzunehmen.
successfulurlredirect	URL Domain max. Länge 75	Dies ist die URL, an die der Browser des Kunden nach einer erfolgreichen Transaktion weitergeleitet wird, wenn STR-6 aktiviert ist.
successfulurlnotification	URL Maximale Länge des Bereichs 75	Dies ist die URL, an die die Benachrichtigung nach einer erfolgreichen Transaktion gesendet wird, wenn STR-8 aktiviert ist.

Protect Plus Felder

Die folgenden optionalen Felder können an die Payment Pages gesendet werden, um die Protect Plus Prüfungen:

Feld	Format	Beschreibung
billingdob	Datum JJJJ-MM-TT	Das Geburtsdatum des Kunden. Muss im Format JJJJ-MM-TT sein.
customershippingmethod	Saibling (1)	Die Versandart. Kann einer der folgenden Werte sein: C Geringe Kosten D Vom Kunden benannt I International M Militär N Nächster Tag/Übernachtung O Sonstiges P Ladenabholung T 2 Tage Service W 3 Tage Service

Kunden Categorie Nummer (MCC) 6012 Felder

Visa und Mastercard haben angeordnet, dass alle im Vereinigten Königreich ansässigen Händler mit einer Kunden Categorie Nummer (MCC) von 6012 verpflichtet sind, die zusätzlichen Felder zu senden. Werden diese Felder nicht übermittelt, kann dies dazu führen, dass dem Kunden eine ungültige Anfrage angezeigt wird.

Erfahren Sie mehr über MCC 6012

Felder für die Rückzahlung von Schulden

Visa und Mastercard haben angeordnet, dass alle Händler, die Schuldenrückzahlungen verarbeiten, die folgenden Felder in der POST übermitteln (wenn die Daten zur Verfügung gestellt wurden).

Dieses Mandat gilt für Händler mit einem Trust Payments Acquiring-Konto. Wenn Sie eine andere Acquiring-Bank verwenden, müssen Sie unser Support-Team kontaktieren, um zu prüfen, ob dieses Mandat für Ihre Lösung gilt.

Erfordernis: Ihre Kunden Categorie Nummer muss entweder 6012, 6051 oder 7299 sein.

Ihr Kunden Categorie Nummer (MCC) ist eine vierstellige Nummer, die Ihnen von Ihrem Acquirer zugewiesen wird. Sie wird verwendet, um das Unternehmen nach der Art der Produkte oder Dienstleistungen zu klassifizieren, die es anbietet. Wenn Sie sich über den Wert Ihres Händlerkategorie-Codes nicht sicher sind, wenden Sie sich bitte an unser Support-Team.

Feld	Format	Beschreibung
customeraccountnumbertype	Alpha (7)	Entweder "CARD" oder "ACCOUNT". Erforderlich, wenn die oben beschriebenen Bedingungen für die Schuldentilgung und andere Bedingungen erfüllt sind.
customeraccountnumber	Numerisch (20)	Wenn der Kontonummern-Typ "ACCOUNT" ist, die Kontonummer des Kontoinhabers. Wenn der Kontonummern-Typ "CARD" ist, erspricht es die Kartennummer, von der aus die Gelder gesendet werden. Erforderlich, wenn die oben beschriebenen Bedingungen für die Schuldentilgung und andere Bedingungen erfüllt sind.
customerdob	Datum JJJJ-MM-TT	Das Geburtsdatum des Kontoinhabers. Muss im Format JJJJ-MM-TT angegeben werden. Erforderlich, wenn die oben beschriebenen Bedingungen für die Schuldentilgung und andere Bedingungen erfüllt sind.
customerlastname	Alphanumerisch einschließlich Symbole (127)	Der Nachname des Kontoinhabers. Erforderlich, wenn die oben beschriebenen Bedingungen für die Schuldentilgung und andere Bedingungen erfüllt sind.
customerpostcode	Alphanumerisch (25)	Die Postleitzahl des Kontoinhabers. Erforderlich, wenn die oben beschriebenen Bedingungen für die Schuldentilgung und andere Bedingungen erfüllt sind.
debtrepayment	Numerisch (1)	Gibt an, ob die Transaktion als Schuldentilgung gekennzeichnet ist: 1 - Die Transaktion ist als Schuldentilgung gekennzeichnet. 0 - Die Transaktion ist nicht als Schuldentilgung gekennzeichnet. Hinweis: Ihre Website kann so konfiguriert werden, dass dieses Kennzeichen bei jeder Transaktion automatisch mit dem Wert 0 oder 1 übermittelt wird. (Sie können unser Support-Team kontaktieren, um diese Änderung vorzunehmen) Erforderlich, wenn die oben beschriebenen Bedingungen für die Schuldentilgung und andere Bedingungen erfüllt sind.

Weitere Lektüre zu diesem Thema