Vom Händler initiierte Transaktionen (MIT)

  Zuletzt aktualisiert: 

 

Was ist eine Merchant Initiated Transaction (MIT)?

Eine vom Händler initiierte Transaktion (MIT) liegt vor, wenn ein Händler eine Transaktion unter Verwendung gespeicherter Kartendaten initiiert, ohne dass der Karteninhaber direkt mit dem Händler unter Autorisierung interagiert. Nachstehend finden Sie die von uns unterstützten Gründe für eine vom Händler initiierte Transaktion (MIT) und Hinweise zu den Kriterien für die Verwendung.

  Vorteile der Unterstützung MIT

  • Die Zahlungsdaten müssen vom Kunden nur einmal zum Zeitpunkt des Kaufs eingegeben werden.
  • Verarbeiten Sie wiederholte Zahlungen für Kunden, ohne dass Sie deren Kartendaten für die zukünftige Verwendung in Ihrem eigenen System speichern müssen. Die Zahlungsdaten werden sicher auf unseren Servern gespeichert.
  • Eine Merchant Initiated Transaction (MIT) wird nur bearbeitet, wenn eine Anfrage von Ihrem System übermittelt wurde. Händler können wählen, wann vom Händler initiierte Transaktionen (MIT) verarbeitet werden.

 

Vom Händler initiierte Transaktionen (MIT) Arten und Gründe

"A" - Erneute Autorisierung

Dies wird verwendet, um einen zuvor erfolgreich autorisierten Betrag erneut zu autorisieren, der nicht beglichen wurde, bevor die erfolgreiche Autorisierung abgelaufen ist. Beispiel: Der Karteninhaber gibt am 1. Januar eine Bestellung auf, und der am 1. Januar durchgeführte Autorisierung Versuch liefert eine autorisierte Antwort. Der Händler aktualisiert den Abrechnung Status der erfolgreichen Autorisierung auf ausgesetzt, da er nicht in der Lage ist, die bestellten Waren/Dienstleistungen bis zum 1. Februar zu beschaffen und zu liefern. Zu diesem Zeitpunkt ist die ursprüngliche erfolgreiche Autorisierung abgelaufen. Die übergeordnete Transaktion muss erfolgreich sein und darf keine account check sein.


"C" - Ungeplante Zahlung

Dies wird verwendet, um eine außerplanmäßige, vom Händler initiierte Transaktion zu verarbeiten (MIT). Zum Beispiel, um ein Konto auf einen vereinbarten Mindestsaldo aufzuladen, wenn der Kontostand unter den vereinbarten Mindestsaldo fällt. Die übergeordnete Transaktion oder account check muss erfolgreich sein.


"D" - Zeitverzögerte Gebühren

Dies wird verwendet, um eine außerplanmäßige, vom Händler initiierte Transaktion (MIT) abzuwickeln, um verspätete Kosten zu decken, die dem Händler zum Zeitpunkt der Bestellung des Produkts oder der Dienstleistung durch den Karteninhaber nicht bekannt waren, z. B. um zusätzliche Lieferkosten zu bezahlen, die zum Zeitpunkt der vorherigen Autorisierung nicht bekannt waren. Die übergeordnete Transaktion muss erfolgreich sein und darf keine account check sein.


"S" - Erneutes Absenden

Dies wird verwendet, um eine erneute Autorisierung eines zuvor abgelehnten Autorisierung Versuchs zu beantragen. Wenn ein Händler beispielsweise Autorisierung unterstützt, ist es aufgrund der Tatsache, dass der Karteninhaber nicht mehr direkt mit Autorisierung interagiert, nicht möglich, den Karteninhaber sofort über den Ablehnungsstatus zu informieren und eine alternative Zahlungsmethode zu verlangen. In diesem Szenario kann der Händler den Wert "Wiedervorlage" der vom Händler initiierten Transaktion (MIT) verwenden, um einen erneuten Versuch Autorisierung für den zuvor abgelehnten Betrag zu unternehmen. Der Händler sollte es maximal dreimal erneut versuchen. Die übergeordnete Transaktion muss abgelehnt werden und darf keine account check sein.


"X" - Nicht erschienen

Dies wird verwendet, um Autorisierung für eine vereinbarte Gebühr anzufordern, wenn der Karteninhaber nicht erscheint, um einen Kauf für ein zuvor gebuchtes Produkt oder eine Dienstleistung abzuschließen. Zum Beispiel, wenn ein Karteninhaber nicht zu einer Restaurant-, Hotel- oder Autovermietungsbuchung auftaucht. Die übergeordnete Transaktion oder account check muss erfolgreich sein.

 

Überblick über den Prozess

 

  1. Der Karteninhaber gibt seine Kartendaten ein und erklärt sich mit der Speicherung und/oder Nutzung seiner Kartendaten zum Zwecke der Abwicklung von Merchant Initiated Transactions (MIT) einverstanden.


  2. Stimmt der Kunde der Speicherung seiner Kartendaten zum Zwecke der Abwicklung von vom Händler initiierten Transaktionen (MIT) zu, kann der Händler verlangen, dass er zu diesem Zeitpunkt Geld vom Karteninhaber einzieht, muss es aber nicht. Zum Beispiel:

    Szenario 1
    Der Karteninhaber zahlt die Anmeldegebühr in Höhe von 10 £ als ECOM -Transaktion zum Zeitpunkt der Angabe/Erfassung der Kartendaten.
    Szenario 2
    Der Händler verlangt keine Zahlung zum Zeitpunkt der Übermittlung/Erfassung der Kartendaten.

  3. Wenn der Händler bereit ist, die erste oder nächste vom Händler initiierte Transaktion (MIT) abzurechnen, sendet der Händler eine Webservices API AUTH Anfrage oder verwendet MyST, um die vom Händler initiierte Transaktion (MIT) zu verarbeiten.

 

Antrag der Eltern

In diesem Abschnitt wird die erste Anfrage beschrieben, die Ihr System verarbeiten muss. Sie können die in dieser Anfrage übermittelten Zahlungsdetails in nachfolgende, vom Händler initiierte Transaktionen übernehmen.

 

Konfiguration der übergeordneten Anforderung

Erweitern Sie den entsprechenden Abschnitt unten, um zu erfahren, wie Sie die übergeordnete Anfrage über Ihre bevorzugte Schnittstelle konfigurieren.

Antrag der Eltern über Payment Pages

Payment Pages ist unsere vollständig gehostete Checkout-Lösung. Wenn Sie mit unserer Payment Pages Lösung nicht vertraut sind, klicken Sie hier, um mehr zu erfahren und loszulegen.

Um den Ablauf THREEDQUERY und dann ACCOUNTCHECK zu unterstützen, müssen Kunden von Payment Pages die Funktion Erweitertes Post verwenden. Klicken Sie hier, um mehr zu erfahren.

Der THREEDQUERY dann AUTH Ablauf wird durch die Verarbeitung einer standardmäßigen, 3-D Secure authentifizierten Transaktion unter Verwendung von Payment Pages durchgeführt, wobei zusätzliche Felder in die POST aufgenommen werden, wie unten beschrieben.

<html>
<head>
</head>
<body>
<!--YOUR HTML-->
<form method="POST" action="<DOMAIN>/process/payments/choice">
<input type="hidden" name="credentialsonfile" value="1">
<input type="hidden" name="currencyiso3a" value="USD">
<input type="hidden" name="mainamount" value="100.00">
<input type="hidden" name="sitereference" value="test_site12345">
<input type="hidden" name="sitesecurity" value="hee879a9ab97753b3a768925d50842f10e19fea03fef0b820026b6df92d415866">
<input type="hidden" name="sitesecuritytimestamp" value="2019-05-28 14:22:37">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="version" value="2">
<input type="submit" value="Pay">
</form>
</body>
</html>

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.

 

Feldspezifikation

  Feld Format Beschreibung
X1-EN.png mainamount Numerisch (14)

Der mit diesem Antrag verbundene Betrag in Haupteinheiten, wobei die Dezimalstellen durch Komma/Dezimalpunkt getrennt werden. z .B. €10,99 würde als "10.99" und ¥246 als "246"eingereicht werden.

Dieser Betrag wird sofort auf dem Bankkonto des Kunden reserviert.

Dieser Wert wird an alle untergeordneten Anfragen vererbt, die von dieser übergeordneten Anfrage erben, sofern das Feld nicht manuell überschrieben wird.

X1-EN.png credentialsonfile Numerisch (1) Visa und Mastercard haben vorgeschrieben, dass Sie die Zustimmung des Karteninhabers einholen müssen, bevor Sie Kartendaten zur späteren Verwendung speichern. Danach müssen Sie Zugangsdaten, die für eine spätere Verwendung gespeichert werden sollen, entsprechend kennzeichnen, indem Sie das Kennzeichen Daten Hinterlegt (CoF) setzen. Aus diesem Grund müssen Sie immer credentialsonfile mit dem Wert "1" in der übergeordneten Anfrage.
X1-EN.png currencyiso3a Alpha (3) Die Transaktion Währung. Dies muss bei allen künftigen untergeordneten Anfragen, die von dieser übergeordneten Anfrage geerbt werden, gleich bleiben.
X1-EN.png sitereference Alphanumerisch
& Unterstrich (50)
Die Website-Referenz bezieht sich auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.
X1-EN.png sitesecurity

Sicherheits-Hashwert der Website

Wird verwendet, um den Sicherheits-Hash der Anfrageseite im POST zu übermitteln.
X1-EN.png sitesecuritytimestamp

Datum JJJJ-MM-TT hh:mm:ss 

Möglichst genaue Angabe des Zeitstempels, der angibt, wann der Zahlungsvorgang des Kunden eingeleitet wurde. Der Kunde hat ab dem angegebenen Zeitpunkt 3 Stunden Zeit, um die Zahlung abzuschließen.

Zusätzliche Überlegungen:

  • Der Zeitstempel muss in UTC angegeben werden.
  • Der Zeitstempelwert darf NICHT in der Zukunft liegen.
X1-EN.png 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.

 

Antwort

Sie müssen sicherstellen, dass Ihr System die transactionreference Feld, das in der Browserumleitung am Ende der Kassensitzung zurückgegeben wird (falls konfiguriert), und/oder die URL-Benachrichtigung (falls konfiguriert), da dieser in dem später eingereichten untergeordneten Antrag referenziert werden muss.

Antrag der Eltern über JavaScript Library

Unter JavaScript Library finden Sie Ressourcen, die Ihnen helfen, schnell Ihre eigene optimierte Kassenlösung im Internet zu erstellen. Wenn Sie mit unserer JavaScript Library Lösung nicht vertraut sind, klicken Sie hier, um mehr zu erfahren und loszulegen.

  • Sowohl die [“THREEDQUERY”,”AUTH”] und [“THREEDQUERY”,”ACCOUNTCHECK”] Elternanfragen folgen einer ähnlichen Spezifikation wie eine Standard-Zahlung, die über unsere JavaScript Library abgewickelt wird, unterliegen aber anderen Anforderungen, wenn sie als Teil einer Merchant Initiated Transactions-Lösung eingesetzt werden.
  • Diese Änderungen werden im Rahmen der payload des JWT.
  • Weitere Informationen finden Sie in dem Beispiel und der Feldspezifikation unten.
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"credentialsonfile":"1",
"currencyiso3a":"GBP",
"requesttypedescriptions":["THREEDQUERY","AUTH"]
"sitereference":"test_site12345"
},
"iat":1559033849,
"iss":"jwt.user"
}

 

Feldspezifikation

  Feld Format Beschreibung
X1-EN.png accounttypedescription Alpha (20)

Geben Sie "ECOM" ein, um eine E-Commerce-Transaktion anzuzeigen.

Wir empfehlen unser Support-Team zu kontaktieren zu kontaktieren, um zu erfahren, welche Kontotypen auf Ihrem Website-Referenz unterstützt werden.

X1-EN.png baseamount Numerisch (13)

Der mit diesem Antrag verbundene Betrag in Basiseinheiten, ohne Kommas oder Dezimalpunkte. z.B. €10,99 würde als "1099" übermittelt werden, aber ¥246 würde als "246" übermittelt werden.

  • Für eine erste [“THREEDQUERY”,”AUTH”] Anfrage: Dieser Betrag wird sofort auf dem Bankkonto des Kunden reserviert.
  • Für eine erste [“THREEDQUERY”,”ACCOUNTCHECK”] Anfrage: Auf dem Bankkonto des Kunden sind keine Mittel reserviert.

Dieser Wert wird an alle untergeordneten Anfragen vererbt, die von dieser übergeordneten Anfrage erben, sofern das Feld nicht manuell überschrieben wird.

X1-EN.png credentialsonfile Numerisch (1) Visa und Mastercard haben vorgeschrieben, dass Sie die Zustimmung des Karteninhabers einholen müssen, bevor Sie Kartendaten zur späteren Verwendung speichern. Danach müssen Sie Zugangsdaten, die für eine spätere Verwendung gespeichert werden sollen, entsprechend kennzeichnen, indem Sie das Kennzeichen Daten Hinterlegt (CoF) setzen. Aus diesem Grund müssen Sie immer credentialsonfile mit dem Wert "1" in der übergeordneten Anfrage.

Der hier übermittelte Wert wird in der Antwort JWT zurückgegeben.

X1-EN.png currencyiso3a Alpha (3) Die Transaktion Währung. Dies muss bei allen künftigen untergeordneten Anfragen, die von dieser übergeordneten Anfrage geerbt werden, gleich bleiben.
X1-EN.png requesttypedescriptions Liste Die zu bearbeitenden Anfragetypen.
Für den Übergeordnete sollte dies entweder sein [“THREEDQUERY”,”AUTH”] oder [“THREEDQUERY”,”ACCOUNTCHECK”]
X1-EN.png sitereference Alphanumerisch
& Unterstrich (50)
Die Website-Referenz bezieht sich auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.

 

Antwort

Der zurückgegebene Antwort-JWT entspricht der gleichen Spezifikation wie bei der Verarbeitung einer Standardzahlung. Von besonderer Bedeutung ist, dass Ihr System die transactionreference zurückgegeben, da diese in dem später eingereichten untergeordnete Anfrage referenziert werden muss. Klicken Sie hier, um mehr über die Entschlüsselung der JWT-Antwort zu erfahren.

Übergeordneter Antrag mit Mobile SDK

Unser Mobile SDK bietet Ressourcen, mit denen Sie schnell eine optimierte Checkout-Lösung in Ihre mobile App integrieren können. Wenn Sie mit unserer Mobile SDK-Lösung nicht vertraut sind, klicken Sie hier, um mehr zu erfahren und loszulegen.

  • Sowohl die [“THREEDQUERY”,”AUTH”] und [“THREEDQUERY”,”ACCOUNTCHECK”] Elternanfragen folgen einer ähnlichen Spezifikation wie eine Standardzahlung, die über unser Mobile SDK abgewickelt wird, unterliegen aber anderen Anforderungen, wenn sie als Teil einer Merchant Initiated Transactions-Lösung eingesetzt werden.
  • Diese Änderungen werden im Rahmen der payload des JWT.
  • Weitere Informationen finden Sie in dem Beispiel und der Feldspezifikation unten.
{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"credentialsonfile":"1",
"currencyiso3a":"GBP",
"requesttypedescriptions":["THREEDQUERY","AUTH"]
"sitereference":"test_site12345",
"termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener"
},
"iat":1559033849,
"iss":"jwt.user"
}

 

Feldspezifikation

  Feld Format Beschreibung
X1-EN.png accounttypedescription Alpha (20)

Geben Sie "ECOM" ein, um eine E-Commerce-Transaktion anzuzeigen.

Wir empfehlen unser Support-Team zu kontaktieren zu kontaktieren, um zu erfahren, welche Kontotypen auf Ihrem Website-Referenz unterstützt werden.

X1-EN.png baseamount Numerisch (13)

Der mit diesem Antrag verbundene Betrag in Basiseinheiten, ohne Kommas oder Dezimalpunkte. z.B. €10,99 würde als "1099" übermittelt werden, aber ¥246 würde als "246" übermittelt werden.

  • Für eine erste [“THREEDQUERY”,”AUTH”] Anfrage: Dieser Betrag wird sofort auf dem Bankkonto des Kunden reserviert.
  • Für eine erste [“THREEDQUERY”,”ACCOUNTCHECK”] Anfrage: Auf dem Bankkonto des Kunden sind keine Mittel reserviert.

Dieser Wert wird an alle untergeordneten Anfragen vererbt, die von dieser übergeordneten Anfrage erben, sofern das Feld nicht manuell überschrieben wird.

X1-EN.png credentialsonfile Numerisch (1) Visa und Mastercard haben vorgeschrieben, dass Sie die Zustimmung des Karteninhabers einholen müssen, bevor Sie Kartendaten zur späteren Verwendung speichern. Danach müssen Sie Zugangsdaten, die für eine spätere Verwendung gespeichert werden sollen, entsprechend kennzeichnen, indem Sie das Kennzeichen Daten Hinterlegt (CoF) setzen. Aus diesem Grund müssen Sie immer redentialsonfile mit dem Wert "1" in der übergeordneten Anfrage.

Der hier übermittelte Wert wird in der Antwort JWT zurückgegeben.

X1-EN.png currencyiso3a Alpha (3) Die Transaktion Währung. Dies muss bei allen künftigen untergeordneten Anfragen, die von dieser übergeordneten Anfrage geerbt werden, gleich bleiben.
X1-EN.png requesttypedescriptions Liste Die zu bearbeitenden Anfragetypen.
Für den Übergeordnete sollte dies entweder sein [“THREEDQUERY”,”AUTH”] oder [“THREEDQUERY”,”ACCOUNTCHECK”]
X1-EN.png sitereference Alphanumerisch
& Unterstrich (50)
Die Website-Referenz bezieht sich auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.
X1-EN.png termurl URL (1024)

Diese URL wird verwendet, um dem Kartenaussteller mitzuteilen, wohin er den Browser des Kunden senden soll, nachdem er sich am ACS des Kartenausstellers authentifiziert hat. Sie müssen die folgende URL in dieses Feld eingeben, wenn Sie 3-D Secure ausführen:

https://payments.securetrading.net/process/payments/mobilesdklistener

 

Antwort

Der zurückgegebene Antwort-JWT entspricht der gleichen Spezifikation wie bei der Verarbeitung einer Standardzahlung. Von besonderer Bedeutung ist, dass Ihr System die transactionreference zurückgegeben, da diese in dem später eingereichten untergeordnete Anfrage referenziert werden muss. Klicken Sie hier, um mehr über die Entschlüsselung der JWT-Antwort zu erfahren.

Übergeordneter Antrag über Webservices API (ECOM)

Unsere Webservices API ist eine leistungsstarke Server-zu-Server-Zahlungsverarbeitungslösung, die mehrere Nachrichtentypen unterstützt. Wenn Sie mit unserer Webservices API noch nicht vertraut sind, klicken Sie hier, um mehr zu erfahren und loszulegen.

  • Das nachstehende Beispiel ist eine AUTH Anfrage, die für die Verarbeitung der ersten Zahlung im Fluss "Merchant Initiated Transactions" verwendet werden kann.
  • Die accounttypedescription ist "ECOM", um anzuzeigen, dass die Transaktion über Ihre Website durchgeführt wurde.
  • Wenn Sie eine Vereinbarung über händlerinitiierte Transaktionen starten müssen, ohne eine Zahlung zu verarbeiten, können Sie den requesttypedescriptions Wert in "ACCOUNTCHECK" ändern.
Python PHP cURL Rohes JSON Rohes XML

#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
"sitereference": "test_site12345",
"requesttypedescriptions": ["AUTH"],
"accounttypedescription": "ECOM",
"currencyiso3a": "GBP",
"baseamount": "1050",
"orderreference": "My_Order_123",
"pan": "4111111111111111",
"expirydate": "12/2020",
"securitycode": "123",
"cavv":"Q0FWVkNBVlZDQVZWQ0FWVkNBVlY=",
"eci":"05",
"enrolled":"Y",
"status":"Y",
"threedversion":"2.1.0", "threeddirectorytransactionreference":"f00e1111-0011-00a6-ab00-a00000a00000",
"credentialsonfile": "1"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
  Feld Format Beschreibung
X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20)

Geben Sie "ECOM" ein, um eine E-Commerce-Transaktion anzuzeigen.

X1-EN.png baseamount
XPath: /billing/amount
Numerisch (13)

Der mit diesem Antrag verbundene Betrag in Basiseinheiten, ohne Kommas oder Dezimalpunkte. z.B. €10,99 würde als "1099" übermittelt werden, aber ¥246 würde als "246" übermittelt werden.

Dieser Wert wird an alle untergeordneten Anfragen vererbt, die von dieser übergeordneten Anfrage erben, sofern das Feld nicht manuell überschrieben wird.

  Wenn Sie eine ACCOUNTCHECK durchführen, müssen Sie den zu verarbeitenden Höchstbetrag in jede nachfolgende untergeordnete Transaktion aufnehmen.

X1-EN.png credentialsonfile
XPath: /operation/credentialsonfile
Numerisch (1) Visa und Mastercard haben vorgeschrieben, dass Sie die Zustimmung des Karteninhabers einholen müssen, bevor Sie Kartendaten zur späteren Verwendung speichern. Danach müssen Sie Zugangsdaten, die für eine spätere Verwendung gespeichert werden sollen, entsprechend kennzeichnen, indem Sie das Kennzeichen Daten Hinterlegt (CoF) setzen. Aus diesem Grund müssen Sie immer credentialsonfile mit dem Wert "1" in der übergeordneten Anfrage.

Der hier übermittelte Wert wird in der Antwort JWT zurückgegeben.

X1-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3) Die Transaktion Währung. Dies muss bei allen künftigen untergeordneten Anfragen, die von dieser übergeordneten Anfrage geerbt werden, gleich bleiben.
X1-EN.png eingeschrieben
XPath: /threedsecure/einschreiben
Saibling (1) Geben Sie "Y" ein, um anzugeben, dass die Karte registriert ist. Informationen zum Umgang mit nicht registrierten Karten finden Sie weiter unten.
X1-EN.png expirydate
XPath: /abrechnung/zahlung/expirydate
Datum MM/JJJJ Das auf der Karte aufgedruckte Ablaufdatum.
X1-EN.png pan
XPath: /abrechnung/zahlung/pan
Numerisch (12-19) Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.
X1-EN.png requesttypedescriptions
XPath: /@type
Liste Die zu verarbeitenden Anfragetypen.
Für die Muttergesellschaft sollte dies entweder ["AUTH " ] oder ["ACCOUNTCHECK " ] sein.
X1-EN.png sitereference
XPath: /operation/sitereference
Alphanumerisch
& Unterstrich (50)
Die Website-Referenz bezieht sich auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.
X1-EN.png status
XPath: /threedsecure/status
Saibling (1) Zeigt an, ob der Kunde im ACS des Kartenausstellers authentifiziert wurde oder nicht.

Eine erfolgreiche Authentifizierung mit Status "Y" ist erforderlich.

X2-EN.png billingfirstname
XPath: /abrechnung/name/erste
Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsvorname.

Erforderlich für Glücksspielanbieter.

X2-EN.png billinglastname
XPath: /abrechnung/name/last
Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsnachname.

Erforderlich für Glücksspielanbieter.

X2-EN.png cavv
XPath: /threedsecure/cavv
Alphanumerisch (56)

Die eindeutige Cardholder Authentication Verification Value (CAVV), die mit der Transaktion verbunden ist.

Geben Sie diesen Wert immer an, wenn er verfügbar ist.

X2-EN.png eci
XPath: /threedsecure/eci
Alphanumerisch (2)

Die mit der Transaktion verbundene Sicherheitsstufe ECI (E-Commerce Indicator).

Geben Sie diesen Wert immer an, wenn er verfügbar ist.

X2-EN.png threedversion
XPath: /threedsecure/version
Numerisch (6)

Version von 3-D Secure , die zur Authentifizierung der Zahlung verwendet wird. (z.B. "2.1.0")

Geben Sie diesen Wert immer an, wenn er verfügbar ist.

X2-EN.png threeddirectorytransactionreference
XPath: /threedsecure/directorytransactionreference
Alphanumerisch (48)

Einzigartige DSTransactionId von Ihrem MPI Anbieter zurückgegeben.

Geben Sie diesen Wert immer an, wenn er verfügbar ist.

X3-EN.png securitycode
XPath: /abrechnung/zahlung/securitycode
Numerisch (3-4)

Dies ist der 3-stellige Sicherheitscode, der auf der Rückseite der Karte aufgedruckt ist.

(Bei AMEX ist dies ein 4-stelliger Code, der sich auf der Vorderseite der Karte befindet)

Dieses Feld ist für Trust Payments nicht unbedingt erforderlich, wird aber für die Verarbeitung von Sicherheitscodeprüfungen dringend empfohlen.

Außerdem können einige Banken die Zahlung ablehnen, wenn der Sicherheitscode nicht vorhanden ist.

 

Antwort

Die zurückgegebene Antwort entspricht der Spezifikation einer StandardantwortAUTH .

 

Übergeordneter Antrag über Webservices API (MOTO)

Unsere Webservices API ist eine leistungsstarke Server-zu-Server-Zahlungsverarbeitungslösung, die mehrere Nachrichtentypen unterstützt. Wenn Sie mit unserer Webservices API noch nicht vertraut sind, klicken Sie hier, um mehr zu erfahren und loszulegen.

  • Das nachstehende Beispiel ist eine AUTH Anfrage, die für die Verarbeitung der ersten Zahlung im Fluss "Merchant Initiated Transactions" verwendet werden kann.
  • Die accounttypedescription ist "MOTO", um anzuzeigen, dass die Bestellung per Telefon aufgegeben wurde.
  • Wenn Sie eine Vereinbarung über händlerinitiierte Transaktionen starten müssen, ohne eine Zahlung zu verarbeiten, können Sie den requesttypedescriptions Wert in "ACCOUNTCHECK" ändern.
Python PHP cURL Rohes JSON Rohes XML

#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
"sitereference": "test_site12345",
"requesttypedescriptions": ["AUTH"],
"accounttypedescription": "MOTO",
"currencyiso3a": "GBP",
"baseamount": "1050",
"orderreference": "My_Order_123",
"billingfirstname": "Joe",
"billinglastname": "Bloggs",
"pan": "4111111111111111",
"expirydate": "12/2020",
"securitycode": "123",
"credentialsonfile": "1"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
  Feld Format Beschreibung
X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20)

Geben Sie "MOTO" ein, um eine Mail Order Telephone Order-Transaktion anzugeben.

(Beachten Sie, dass die 3-D Secure Authentifizierung für MOTO Transaktionen nicht unterstützt wird)

X1-EN.png baseamount
XPath: /billing/amount
Numerisch (13)

Der mit diesem Antrag verbundene Betrag in Basiseinheiten, ohne Kommas oder Dezimalpunkte. z.B. €10,99 würde als "1099" übermittelt werden, aber ¥246 würde als "246" übermittelt werden.

Dieser Wert wird an alle untergeordneten Anfragen vererbt, die von dieser übergeordneten Anfrage erben, sofern das Feld nicht manuell überschrieben wird.

  Wenn Sie eine ACCOUNTCHECK durchführen, müssen Sie den zu verarbeitenden Höchstbetrag in jede nachfolgende untergeordnete Transaktion aufnehmen.

X1-EN.png credentialsonfile
XPath: /operation/credentialsonfile
Numerisch (1) Visa und Mastercard haben vorgeschrieben, dass Sie die Zustimmung des Karteninhabers einholen müssen, bevor Sie Kartendaten zur späteren Verwendung speichern. Danach müssen Sie Zugangsdaten, die für eine spätere Verwendung gespeichert werden sollen, entsprechend kennzeichnen, indem Sie das Kennzeichen Daten Hinterlegt (CoF) setzen. Aus diesem Grund müssen Sie immer credentialsonfile mit dem Wert "1" in der übergeordneten Anfrage.

Der hier übermittelte Wert wird in der Antwort JWT zurückgegeben.

X1-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3) Die Transaktion Währung. Dies muss bei allen künftigen untergeordneten Anfragen, die von dieser übergeordneten Anfrage geerbt werden, gleich bleiben.
X1-EN.png expirydate
XPath: /abrechnung/zahlung/expirydate
Datum MM/JJJJ Das auf der Karte aufgedruckte Ablaufdatum.
X1-EN.png pan
XPath: /abrechnung/zahlung/pan
Numerisch (12-19) Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.
X1-EN.png requesttypedescriptions
XPath: /@type
Liste Die zu verarbeitenden Anfragetypen.
Für die Muttergesellschaft sollte dies entweder ["AUTH " ] oder ["ACCOUNTCHECK " ] sein.
X1-EN.png sitereference
XPath: /operation/sitereference
Alphanumerisch
& Unterstrich (50)
Die Website-Referenz bezieht sich auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.
X2-EN.png billingfirstname
XPath: /abrechnung/name/erste
Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsvorname.

Erforderlich für Glücksspielanbieter.

X2-EN.png billinglastname
XPath: /abrechnung/name/last
Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsnachname.

Erforderlich für Glücksspielanbieter.

X3-EN.png securitycode
XPath: /abrechnung/zahlung/securitycode
Numerisch (3-4)

Dies ist der 3-stellige Sicherheitscode, der auf der Rückseite der Karte aufgedruckt ist.

(Bei AMEX ist dies ein 4-stelliger Code, der sich auf der Vorderseite der Karte befindet)

Dieses Feld ist für Trust Payments nicht unbedingt erforderlich, wird aber für die Verarbeitung von Sicherheitscodeprüfungen dringend empfohlen.

Außerdem können einige Banken die Zahlung ablehnen, wenn der Sicherheitscode nicht vorhanden ist.

 

Antwort

Die zurückgegebene Antwort entspricht der Spezifikation einer StandardantwortAUTH .

 

  Ihr Fortschritt

Nachdem Sie die obigen Anweisungen befolgt haben, sollten Sie nun in der Lage sein, wiederkehrende Zahlungen manuell über unsere Webservices API zu verarbeiten. Sie können die transactionreference die in der Antwort zurückgegeben wird, und nehmen diese in nachfolgende untergeordnete Anfragen auf.

 


 

Antrag des Kindes

  In diesem Abschnitt werden die nachfolgenden vom Händler initiierten Transaktionen beschrieben. In diesem Abschnitt wird davon ausgegangen, dass die zuvor beschriebene übergeordnete Anfrage bereits bearbeitet wurde.

  Bevor Sie eine untergeordnete Anfrage bearbeiten, müssen Sie sicherstellen, dass der übergeordnete Anfrage erfolgreich abgeschlossen wurde. Untersuchen Sie alle aufgetretenen Probleme und wenden Sie sich an unser Support-Team, wenn Sie Hilfe benötigen.

Wenn eine parenttransactionreference von einem erfolgreichen Elternteil "AUTH" oder "ACCOUNTCHECK" in einer untergeordneten Anfrage enthalten ist, stellt Trust Payments die erforderlichen Schemareferenzdaten für Visa und Mastercard bereit.

Bitte wenden Sie sich an unser Support-Team, wenn Sie Referenzdaten eines anderen Verarbeiters einbeziehen oder untergeordnete Transaktionen mit PAN und Ablaufdatum verarbeiten möchten. Klicken Sie hier, um mehr zu erfahren.

 

Übersicht der Kinderanträge

  1. Ihr System fordert die Verarbeitung einer neuen Zahlung an, indem es manuell eine AUTH Anfrage über unsere Webservices API übermittelt, die die transactionreference der Muttergesellschaft AUTH oder ACCOUNTCHECK auf dem parenttransactionreference Feld.

  Für diejenigen, die unser JavaScript Library oder Mobile SDK verwenden, um die übergeordnete Anfrage zu bearbeiten, enthält das anschließend zurückgegebene Antwort-JWT auch die transactionreference der THREEDQUERY. Sie dürfen dies nicht im untergeordnete Anfrage angeben. Stattdessen müssen Sie nur die transactionreference Wert, der mit dem übergeordneten AUTH oder ACCOUNTCHECK verbunden ist.

  1. Wir wenden uns an die übernehmende Bank, um Autorisierung für die Zahlung zu kontaktieren, wobei wir die von der übergeordneten AUTH/ACCOUNTCHECK geerbten Rechnungs- und Lieferdaten verwenden (Ihr System muss diese Daten nicht erneut übermitteln).
  2. Ihr System erhält eine Antwort von AUTH , die die Ergebnisse der Anfrage enthält.

 

Anforderung

Die für den untergeordneten Antrag eingereichte Anforderungstyp muss "AUTH" lauten (eingereicht in der requesttypedescriptions Feld). Die AUTH Unterabfrage folgt einer ähnlichen Spezifikation wie die Standardabfrage AUTH , unterliegt jedoch anderen Anforderungen, wenn sie als Teil einer Merchant Initiated Transactions-Lösung verwendet wird. Weitere Informationen finden Sie in dem Beispiel und der Feldspezifikation unten.

Python PHP cURL Rohes JSON Rohes XML
#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
"sitereference": "test_site12345",
"requesttypedescriptions": ["AUTH"],
"accounttypedescription": "ECOM",
"initiationreason": "C",
"parenttransactionreference": "12-3-4567",
"baseamount": "1050",
"credentialsonfile": "2"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.

 

  Im obigen Beispiel wird davon ausgegangen, dass die vorherige Anfrage die erste war, die bearbeitet wurde, weshalb die subscriptionnumber wird der Wert "2" zugewiesen. Nachfolgende untergeordnete Anträge werden nach der gleichen Struktur bearbeitet, wobei diese Zahl jedes Mal erhöht wird (d. h. die nächste Zahlung in der Reihenfolge wäre "3", dann "4" usw.).

  Feld Format Beschreibung
X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Übermitteln Sie denselben accounttypedescription Wert in der untergeordneten Anfrage wie in der verknüpften übergeordneten Anfrage.
X3-EN.png baseamount
XPath: /billing/amount
Numerisch (13)

Der Betrag, der mit der untergeordneten Zahlung verbunden ist, in Basiseinheiten, ohne Kommas oder Dezimalpunkte. z.B. €10,99€ würde als "1099" übermittelt werden, aber ¥246 würde als "246" übermittelt werden.

Wenn Sie dieses Feld nicht ausfüllen, wird der verarbeitete Betrag von der vorhergehenden übergeordneten Anfrage übernommen.

X1-EN.png credentialsonfile
XPath: /operation/credentialsonfile
Numerisch (1)

Dies ist für die Transaktionen Visa und Mastercard erforderlich, wenn der Händler Daten Hinterlegt (CoF) verwendet.

Geben Sie in diesem Feld eine "2" ein, um anzugeben, dass die Zahlung mit zuvor gespeicherten Berechtigungsnachweisen erfolgt.

X3-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3) Bei der Einreichung muss es sich um dieselbe Währung handeln, die auch für den übergeordneten Antrag verwendet wird.

Wird dieser Wert nicht übermittelt, wird er von der übergeordneten Anfrage geerbt.

X1-EN.png initiationreason
XPath: /operation/initiationreason
Saibling (1) Sie müssen einen Grund für die Bearbeitung der tokenisierten Zahlung angeben. Geben Sie einen der folgenden Werte an, der den Grund für die Zahlung am besten beschreibt:
  • "A" - Erneute Autorisierung
  • "C" - Ungeplante Zahlung
  • "D" - Zeitverzögerte Gebühren
  • "S" - Erneutes Absenden
  • "X" - Keine Anzeige (bei einer Hotelbuchung)
X1-EN.png parenttransactionreference
XPath: /operation/parenttransactionreference
Alphanumerisch
& Bindestriche (25)
Sie müssen die transactionreference Wert des AUTH oder ACCOUNTCHECK , der in der JWT-Antwort der ursprünglichen übergeordneten Anfrage zurückgegeben wird.

Sie dürfen nicht die transactionreference Wert, der mit der THREEDQUERY verbunden ist.

X1-EN.png requesttypedescriptions
XPath: /@type
Alpha (20) Sie müssen "AUTH" eingeben, wie im Beispiel des Antrags gezeigt.
X1-EN.png sitereference
XPath: /operation/sitereference
Alphanumerisch
& Unterstrich (50)
Die Website-Referenz bezieht sich auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.

 

Antwort

Die zurückgegebene Antwort entspricht der gleichen Spezifikation wie eine Standard AUTH Antwort, mit Ausnahme des zusätzlichen Feldes acquireradvicecode die zurückgegeben werden können (weitere Informationen finden Sie in der nachstehenden Feldspezifikation).

 

Feldspezifikation

  Feld Format Beschreibung
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Der Kontotyp "RECUR" wird zurückgegeben.
X2-EN.png acquireradvicecode
XPath: /acquireradvicecode
Numerisch (1)

Ein von der erwerbenden Bank zurückgegebener numerischer Wert, der angibt, ob weitere Zahlungen verarbeitet werden können. Eine vollständige Zuordnung dieser Werte finden Sie im Abschnitt "Zusätzliche Hinweise" am Ende dieser Seite.

Wird nur zurückgesandt, wenn es von Ihrer anwerbenden Bank unterstützt wird.

X4-EN.png baseamount
XPath: /billing/amount
Numerisch (13)

Der Betrag, der mit der untergeordneten Zahlung verbunden ist, in Basiseinheiten, ohne Kommas oder Dezimalpunkte. z.B. €10,99€ würde als "1099" übermittelt werden, aber ¥246 würde als "246" übermittelt werden.

Wir empfehlen, zu überprüfen, ob dieser Betrag mit dem von Ihnen erwarteten Wert übereinstimmt. Der hier zurückgegebene Betrag entspricht dem Betrag, der dem Kunden bei der untergeordneten Zahlung belastet wird.

X4-EN.png credentialsonfile
XPath: /operation/credentialsonfile
Numerisch (1) Wenn die credentialsonfile Feld in der Anfrage übermittelt wurde und vom Acquirer, der die Transaktion bearbeitet, unterstützt wird, wird es in der Antwort zurückgegeben.
X4-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

Die Währung der Transaktion.

Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.

X4-EN.png parenttransactionreference
XPath: /operation/parenttransactionreference
Alphanumerisch
& Bindestriche (25)
Die Transaktionsnummer der übergeordneten Transaktion.
X4-EN.png requesttypedescription
XPath: /@type
Alpha (20) Anforderungstyp Es wird "AUTH" zurückgegeben.

  Zusammenfassung

Wenn Sie die obigen Anweisungen befolgen, sollte Ihr System nun in der Lage sein, wiederholte Zahlungen manuell über unsere Webservices API zu verarbeiten, ohne dass die Rechnungs- oder Zahlungsdaten des Kunden erneut übermittelt werden müssen. Wie immer empfehlen wir Ihnen, Ihre Lösung gründlich zu testen, um sicherzustellen, dass die vom Händler initiierten Transaktionen wie erwartet verarbeitet werden, bevor Sie Live-Zahlungen in Ihrem Produktionssystem durchführen. Bitte lesen Sie weiter, um zusätzliche Informationen zu erhalten, die Ihnen bei der Entwicklung einer Lösung für Merchant Initiated Transactions nützlich sein könnten.

 

Zusätzliche Hinweise

 

Nachfolgend finden Sie einige zusätzliche Hinweise, die bei der Verarbeitung von vom Händler initiierten Transaktionen zu beachten sind.

 

Über die Hinweiscode des Käufers

Hinweiscode des Käufers ist ein numerischer Wert, der zurückgegeben wird, wenn er von Ihrer Acquiring-Bank unterstützt wird, und der angibt, ob und wann weitere Zahlungen verarbeitet werden können.

  Klicken Sie hier, um mehr zu erfahren

Ähnliche Artikel


Wiederkehrende Zahlungen

Wiederholte Transaktionen mit zuvor gespeicherten Kartendaten verarbeiten.

  Mehr erfahren

War dieser Artikel hilfreich?
0 von 0 Personen fanden dies hilfreich