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 | |
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)
|
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:
|
|||
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:
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:
|
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:
|
|||
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:
|
|||
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 | |
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 MyST 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: 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. |
||
dcctype | Alpha (3) |
Erforderlich bei der Durchführung von DCC Transaktionen. |
||
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:
Klicken Sie hier für weitere Informationen zu diesem Bereich. |
||
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. Wenn Sie das orderreference in Ihren Site-Sicherheitshash einfügen, werden nur alphanumerische Zeichen und die folgenden Sonderzeichen unterstützt: ~ ! # $ % ^ & * ( ) _ { } [ ] < > , ? |
||
operatorname | Alphanumerisch (255) |
In diesem Feld können Sie den Namen des Betreibers eintragen, der die Zahlung über Payment Pages durchführt. Dieser wird in unseren Unterlagen gespeichert und kann später in MyST 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:
|
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:
|
|
strequiredfields |
Alpha |
Geben Sie Felder an, die vom Kunden eingegeben werden müssen (mehrere Felder werden unterstützt). |
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:
Bleibt dieses Feld leer, wird die auf Payment Pages eingegebene (oder gebuchte) Adresse verwendet. |
|
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 | |
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) | Die Sprache der PayPal-Anmeldeseite. Die Werte für die Ländercodes, die übermittelt werden können, finden Sie unter https://developer.paypal.com/docs/classic/api/locale_codes/ |
Regelfelder
Feld | Format | Beschreibung | |
allurlnotification |
URL |
Dies ist die URL, an die die Benachrichtigung nach jeder Anfrage gesendet wird, wenn STR-10 aktiviert ist. | |
declinedurlredirect |
URL |
Dies ist die URL, zu der der Browser des Kunden nach einer abgelehnten Transaktion umgeleitet wird, wenn STR-7 aktiviert ist. | |
declinedurlnotification |
URL |
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 |
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:
|
Kunden Categorie Nummer (MCC) 6012 Felder
Visa und Mastercard haben angeordnet, dass alle in Großbritannien ansässigen Händler mit einer Kunden Categorie Nummer (MCC) von 6012 die folgenden Felder senden müssen. Werden diese Felder nicht übermittelt, kann dies dazu führen, dass dem Kunden eine ungültige Anfrage angezeigt wird.
Feld | Format | Beschreibung | |
customeraccountnumbertype | Alpha (7) |
Entweder "CARD" oder "ACCOUNT". Erforderlich, wenn Kunden Categorie Nummer (MCC) 6012 ist. |
|
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 Kunden Categorie Nummer (MCC) 6012 ist. |
|
customerdob | Datum JJJJ-MM-TT |
Das Geburtsdatum des Kontoinhabers. Erforderlich, wenn Kunden Categorie Nummer (MCC) 6012 ist. |
|
customerlastname |
Alphanumerisch einschließlich Symbole (127) |
Der Nachname des Kontoinhabers. Erforderlich, wenn Kunden Categorie Nummer (MCC) 6012 ist. |
|
customerpostcode | Alphanumerisch (25) |
Die Postleitzahl des Kontoinhabers. Erforderlich, wenn Kunden Categorie Nummer (MCC) 6012 ist. |
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 das Support-Team.
Sobald Sie eine Zahlung oder Account Check verarbeitet haben, die diese erforderlichen Felder enthält, werden sie automatisch in künftigeAutorisierungen und account checks in MyST aufgenommen und an die erwerbende Bank weitergeleitet.
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. 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:
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. |