charge description ist ein Feld, das wir der erwerbenden Bank während einer Transaktion zur Verfügung stellen. Es handelt sich um eine grundlegende Beschreibung der Transaktion, die auf dem Kontoauszug des Kunden angezeigt wird.
Diese Funktion wird von Händlern mit einem Trust Payments Acquiring-Konto unterstützt. Wenn Sie eine andere Acquiring-Bank verwenden, müssen Sie unser Support-Team kontaktieren, um zu prüfen, ob diese Funktion unterstützt wird, bevor Sie fortfahren.
Auf dieser Seite wird erklärt, wie Sie eine charge description in Ihre Anfragen aufnehmen können.
Überblick über den Prozess
Es gibt zwei Methoden, die zur Aufnahme verwendet werden können chargedescription in den bei der erwerbenden Bank eingereichten Anträgen:
-
Durch Zuweisen einer charge description Ihrem Konto:
Bei dieser Methode charge description die charge description automatisch in die Transaktionen Ihres Kontos aufgenommen, ohne dass zusätzliche Konfigurationen erforderlich sind. Um Ihr Konto für diese Methode zu konfigurieren,wenden Sie sich bitte an unser Support-Team und bitten Sie um die Konfiguration einer charge description. -
Durch manuelles Hinzufügen einer charge description Ihren Anfragen:
Mit dieser Methode können Sie charge description jede einzelne Anfrage eine andere charge description angeben.
Übermittlung von charge description in einer Anfrage
Die chargedescription Feld kann in den POST an Payment Pages aufgenommen werden, wie im folgenden Beispiel gezeigt:
Es ist zwingend erforderlich, dass die chargedescription Feld ist auch in der Zeichenkette enthalten, die zur Generierung des Sicherheits-Hashes Ihrer Website verwendet wird. Andernfalls wird dem Kunden die Fehlermeldung "Ungültige Angaben" angezeigt.
<form method="POST" action="<DOMAIN>/process/payments/choice">
<input type="hidden" name="sitereference" value="test_site12345">
<input type="hidden" name="currencyiso3a" value="USD">
<input type="hidden" name="mainamount" value="100.00">
<input type="hidden" name="version" value="2">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="chargedescription" value="TEST DESCRIPTOR">
<input type="submit" value="Pay">
</form>
Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.
Sie müssen die payload die in Ihrem JWT übermittelt werden, um das zusätzliche Feld chargedescription, wie unten gezeigt. Wenn Sie charge description auf diese Weise übermitteln, werden alle in Ihrem Konto gespeicherten oder von einem Übergeordnete geerbten Werte außer Kraft gesetzt.
Sie können auch die chargedescription bei der Einreichung einer Anfrage über unser Webservices API. Beispiele dafür finden Sie auch auf den anderen Registerkarten unten:
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"currencyiso3a":"GBP",
"sitereference":"test_site12345",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"chargedescription":"TEST DESCRIPTOR"
},
"iat":1559033849,
"iss":"jwt.user"
}
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"currencyiso3a":"GBP",
"sitereference":"test_site12345",
"termurl":"https:\/\/payments.securetrading.net\/process\/payments\/mobilesdklistener",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"chargedescription":"TEST DESCRIPTOR"
},
"iat":1559033849,
"iss":"jwt.user"
}
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"currencyiso3a":"GBP",
"requesttypedescriptions":["AUTH"],
"sitereference":"test_site12345",
"baseamount":"1050",
"orderreference":"My_Order_123",
"accounttypedescription":"ECOM",
"chargedescription":"TEST DESCRIPTOR",
"pan":"4111111111111111",
"expirydate":"12/2020",
"securitycode":"123"
}]
}
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="AUTH">
<merchant>
<orderreference>My_Order_123</orderreference>
<chargedescription>TEST DESCRIPTOR</chargedescription>
</merchant>
<billing>
<payment>
<expirydate>12/2020</expirydate>
<pan>4111111111111111</pan>
<securitycode>123</securitycode>
</payment>
<amount currencycode="GBP">1050</amount>
</billing>
<operation>
<sitereference>test_site12345</sitereference>
<accounttypedescription>ECOM</accounttypedescription>
</operation>
</request>
</requestblock>
Feldspezifikation
| Feld | Format | Beschreibung | |
| Optional | chargedescription XPath: /merchant/chargedescription |
Alphanumerisch einschließlich Leerzeichen und Sonderzeichen (25) Empfohlene Länge 25 Zeichen oder weniger (genaue Länge abhängig von der erwerbenden Bank). Die Nichteinhaltung dieser Anforderung kann dazu führen, dass der Text in der Transaktion abgeschnitten wird. |
charge description ist ein Feld, das wir der erwerbenden Bank während einer Transaktion zur Verfügung stellen. Es handelt sich um eine grundlegende Beschreibung der Transaktion, die auf dem Kontoauszug des Kunden angezeigt wird. Die charge description wird in der Antwort JWT zurückgegeben, wenn sie an die erwerbende Bank gesendet wurde. |
Zusätzliche Hinweise
Unterstützte Anfragetypen
Die Felder von charge description können in den folgenden Anfragen über unsere Webservices API übermittelt werden:
- ACCOUNTCHECK
- AUTH
- ORDER
- ORDERDETAILS
- REFUND
- RISKDEC
- THREEDQUERY
Klicken Sie hier für eine vollständige Liste der Antragsarten.
Vererbung von übergeordneten Anfragen
Wenn Sie den Antrag nicht einreichen chargedescription in einer Anfrage und eine übergeordnete Transaktionsnummer angegeben ist, wird die chargedescription von diesem Übergeordnete geerbt wird, es sei denn, die Übergeordnete Anforderungstyp ist AUTH oder REFUND.
