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:
| Feld | Format | Beschreibung | |
| Erforderlich | sitereference |
Alphanumerisch & Unterstrich (50) |
Identifiziert Ihre Website auf dem System Trust Payments . Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte wenden Sie sich an unser Support-Team. |
| Erforderlich | currencyiso3a | Alpha (3) | Die Währung der die Transaktion abgewickelt wird, unter Verwendung des ISO3A-Format. |
| Erforderlich | 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 |
| Erforderlich | version | Numerisch (1) | Dieser Wert wird auf 2 gesetzt. |
| Erforderlich | stprofile |
Alphanumerisch (20)
|
Wird verwendet, um das Design für die Darstellung der Payment Pages festzulegen. Bei Verwendung des Standarddesigns ist dieser Wert auf „default“ gesetzt. Erfahren Sie mehr über die Anpassung des Erscheinungsbilds. |
| Erforderlich | sitesecurity | Sicherheits-Hashwert der Website | Wird verwendet, um die Sicherheitsanforderung der Website Hash 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 | |||
| Optional | 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. | ||
| Bedingt | billingfirstname |
Alphanumerisch einschließlich Symbole (127) |
Die Rechnungsvorname. Erforderlich für Visa Secure Data Field Mandate. Erforderlich für Glücksspielanbieter. |
||
| Optional | billingmiddlename |
Alphanumerisch einschließlich Symbole (127) |
Der mittlere Name der Rechnung. | ||
| Bedingt | billinglastname |
Alphanumerisch einschließlich Symbole (127) |
Die Rechnungsnachname. Erforderlich für Visa Secure Data Field Mandate. Erforderlich für Glücksspielanbieter. |
||
| Optional | billingpremise |
Alphanumerisch einschließlich Symbole (25) |
Die Hausnummer oder die erste Zeile der Rechnungsadresse. | ||
| Optional | billingstreet |
Alphanumerisch einschließlich Symbole (127) |
Die für die Rechnungsadresse eingegebene Straße. | ||
| Optional | billingtown |
Alphanumerisch einschließlich Symbole (127) |
Die für die Rechnungsadresse eingegebene Stadt. | ||
| Optional | 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:
|
||
| Optional | billingpostcode | Alphanumerisch (25) | Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a eingereicht werden. | ||
| Optional | billingcountryiso2a | Alpha (2) | Das Land, das für die Rechnungsadresse eingegeben wurde, unter Verwendung des ISO2A-Format. | ||
| Bedingt | billingemail | E-Mail (255) |
Die Rechnungs-E-Mail , die für die Korrespondenz mit dem Kunden verwendet wird.
Abgesehen von den oben aufgeführten Anforderungen entspricht unser System dem RFC 5322, der das Standardformat für gültige E-Mail-Adressen definiert. Erfahren Sie mehr über RFC 5322 (Link zu einer externen Website) Erforderlich für Visa Data Field Mandate wenn billingtelephone nicht angegeben billingtelephone . |
||
| Bedingt | billingtelephone |
Alphanumerisch einschließlich Symbole (20) |
Die Telefonnummer für die Rechnungsstellung. Gültige Zeichen:
Erforderlich für Visa Data Field Mandate wenn keine billingemail angegeben billingemail . |
||
| Optional | billingtelephonetype | Saibling (1) |
Der Typ der eingegebenen Telefonnummer. Die verfügbaren Optionen sind:
|
||
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 | |||
| Optional | 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. | ||
| Optional | customerfirstname |
Alphanumerisch einschließlich Symbole (127) |
Den Vornamen des Kunden. | ||
| Optional | customermiddlename |
Alphanumerisch einschließlich Symbole (127) |
Der zweite Vorname des Kunden. | ||
| Optional | customerlastname |
Alphanumerisch einschließlich Symbole (127) |
Der Nachname des Kunden. | ||
| Optional | customerpremise |
Alphanumerisch einschließlich Symbole (25) |
Die Hausnummer oder die erste Zeile der Kundenadresse. | ||
| Optional | customerstreet |
Alphanumerisch einschließlich Symbole (127) |
Die für die Kundenadresse eingegebene Straße. | ||
| Optional | customertown |
Alphanumerisch einschließlich Symbole (127) |
Die für die Kundenadresse eingegebene Stadt. | ||
| Optional | 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:
|
||
| Bedingt | 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. |
||
| Bedingt | customercountryiso2a | Alpha (2) |
Das Land, das für die Kundenadresse eingegeben wurde, unter Verwendung des ISO2A-Format. Erforderlich, wenn Kunden Categorie Nummer (MCC) 6012 ist. |
||
| Optional | customeremail | E-Mail (255) |
Die E-Mail Adresse des Kunden. Gültige Zeichen:
Abgesehen von den oben aufgeführten Anforderungen entspricht unser System dem RFC 5322, der das Standardformat für gültige E-Mail-Adressen definiert. Erfahren Sie mehr über RFC 5322 (Link zu einer externen Website) |
||
| Optional | customertelephone |
Alphanumerisch einschließlich Symbole (20) |
Die Telefonnummer des Kunden. Gültige Zeichen:
|
||
| Optional | customertelephonetype | Saibling (1) |
Der Typ der eingegebenen Telefonnummer. Die verfügbaren Optionen sind:
|
||
Abrechnung Felder
Sie können die folgenden optionalen Felder in die POST-Datei aufnehmen, um Abrechnung zu beeinflussen.
| Feld | Format | Beschreibung | |
| Optional | settleduedate | Datum JJJJ-MM-TT |
Verwenden Sie dieses Feld, um Abrechnung bis zum angegebenen Datum zu verschieben (im Format JJJJ-MM-TT). |
| Optional | 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. (Wird nur von ausgewählten Acquirern unterstützt)Senden Sie „100“, um die Transaktion unmittelbar nach Autorisierung abzuwickeln. Wenden Sie sich an den Support , um zu überprü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 | ||
| Optional | authmethod | Alpha (11) |
Um die in Ihrem Konto angegebene Standardauthentifizierungsmethode manuell außer Kraft zu setzen. Unterstützte Werte sind: Der Inhalt von authmethod hat keinen Einfluss auf den Abrechnung der Transaktion. Abrechnung kann mithilfe von settlestatus und settleduedategesteuert werden. Erfahren Sie mehr über den Abrechnung |
|
| Bedingt | 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. |
|
| Bedingt | dcctype | Alpha (3) |
Erforderlich bei der Durchführung von DCC Transaktionen. |
|
| Optional | 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:
|
|
| Optional | orderreference |
Alphanumerisch einschließlich 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. Bei Angabe der orderreference in Ihre Website-Sicherheits-Hash, werden nur alphanumerische Zeichen und die folgenden Sonderzeichen unterstützt: ~ ! # $ % ^ & * ( ) _ { } [ ] < > , ? |
|
| Optional | 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 dafür entscheiden, den operatornameeinreichen möchten, empfehlen wir Ihnen, die Sicherheit Ihres Website-Hash , um dieses Feld einzubeziehen, indem Sie sich an unser Support-Team wenden. |
|
| Optional | paymenttypedescription | Alpha (20) | Ermöglicht Ihnen die Auswahl der Zahlungsmethode für die Transaktion bei Verwendung von Journey B. | |
| Optional | requesttypedescriptions | Alpha (20) | Wird verwendet, um die zu verarbeitenden Anforderungstypen anzugeben, wenn Erweitertes Post in Ihrem Konto aktiviert ist. | |
| Optional | scaexemptionindicator | Numerisch (1) |
Wird verwendet, um 3-D Secure in bestimmten Szenarien zu umgehen, in denen dies zulässig ist. Es gelten bestimmte Bedingungen – Erfahren Sie mehr über SCA . Hinweis: Wird nur von bestimmten akquirierenden Banken unterstützt. Weitere Informationen erhalten Sie von unserem 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:
|
|
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 | |
| Optional | stdefaultprofile | Alpha und Unterstriche (20) |
Unterstützte Werte:
|
| Bedingt | 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 | |
| Optional | billingcontactdetailsoverride | Numerisch (1) |
Die Rechnungsadresse für die Zahlung:
Bleibt dieses Feld leer, wird die auf Payment Pages eingegebene (oder gebuchte) Adresse verwendet. |
| Optional | customercontactdetailsoverride | Numerisch (1) |
Die Kundenadresse (Lieferadresse) für die Zahlung:
Bleibt dieses Feld leer, wird die auf Payment Pages eingegebene (oder gebuchte) Adresse verwendet. |
PayPal-Felder
| Feld | Format | Beschreibung | |
| Optional | paypaladdressoverride | Numerisch (1) | Geben Sie an, wie die Lieferadresse bei der Zahlungsabwicklung mit PayPal eingegeben wird. Bei Verwendung der PayPal-Adressüberschreibungsfunktion können in bestimmten Fällen weitere Lieferfelder erforderlich sein. Lesen Sie unsere PayPal-Dokumentation. |
| Optional | paypallocaleiso2a | Alpha (2) | Verwenden Sie dieses Feld, um den auf der PayPal-Checkout-Seite angezeigten Inhalt zu lokalisieren. Eine vollständige Liste der unterstützten Werte, die in diesem Feld übermittelt werden können (z. B. paypallocaleiso2a=GB für Großbritannien), finden Sie in der PayPal-Dokumentation (Link zu einer externen Website). |
Regelfelder
| Feld | Format | Beschreibung | |
| Optional | allurlnotification |
URL Maximale Länge der Domain 75 |
Dies ist die URL der Benachrichtigung nach jeder Anfrage gesendet wird, wenn STR-10 aktiviert ist. |
| Optional | declinedurlredirect |
URL Maximale Länge der Domain 75 |
Dies ist die URL, zu der der Browser des Kunden weitergeleitet wird , wenn STR-7 aktiviert ist. |
| Optional | declinedurlnotification |
URL Maximale Länge der Domain 75 |
Dies ist die URL der Benachrichtigung nach einer abgelehnten Transaktion gesendet wird, wenn STR-9 aktiviert ist. |
| Optional | ruleidentifier | Alphanumerisch und Bindestriche | Wird verwendet, um Regeln auf Anfragebasis zu aktivieren (mehrere Felder werden unterstützt). |
| Optional | stextraurlredirectfields | Alpha | Dies wird verwendet, um zusätzliche Felder in Weiterleitungeneinzufügen. |
| Optional | stextraurlnotifyfields | Alpha | Dies wird verwendet, um zusätzliche Felder in URL-Benachrichtigungen einzufügen Benachrichtigungeneinzufügen. |
| Optional | successfulurlredirect |
URL Maximale Länge der Domain 75 |
Dies ist die URL, zu der der Browser des Kunden weitergeleitet wird , wenn STR-6 aktiviert ist. |
| Optional | successfulurlnotification |
URL Maximale Länge der Domain 75 |
Dies ist die URL der 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 | ||
| Optional | billingdob | Datum JJJJ-MM-TT | Das Geburtsdatum des Kunden. Muss im Format JJJJ-MM-TT sein. | |
| Optional | customershippingmethod | Saibling (1) |
Die Versandart. Kann einer der folgenden Werte sein:
|
|
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 | |
| Bedingt | customeraccountnumbertype | Alpha (7) |
Entweder "CARD" oder "ACCOUNT". Erforderlich, wenn die oben beschriebenen Bedingungen für die Schuldentilgung und andere Bedingungen erfüllt sind. |
| Bedingt | 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. |
| Bedingt | customerdob | Datum JJJJ-MM-TT |
Geburtsdatum des Kontoinhabers. Erforderlich, wenn die oben beschriebenen Bedingungen für die Schuldentilgung und andere Bedingungen erfüllt sind. |
| Bedingt | 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. |
| Bedingt | customerpostcode | Alphanumerisch (25) |
Die Postleitzahl des Kontoinhabers. Erforderlich, wenn die oben beschriebenen Bedingungen für die Schuldentilgung und andere Bedingungen erfüllt sind. |
| Bedingt | debtrepayment | Numerisch (1) |
Gibt an, ob die Transaktion als Schuldentilgung gekennzeichnet ist:
Hinweis: Ihre Website kann so konfiguriert werden, dass dieses Flag standardmäßig bei jeder Transaktion automatisch mit dem Wert 0 oder 1 übermittelt wird. (Sie können sich an unser Support-Team wenden , um diese Änderung vorzunehmen.) Erforderlich, wenn die oben beschriebenen Bedingungen für die Schuldentilgung und andere Bedingungen erfüllt sind. |