Die PreAuth Transaktion wird eine Standardtransaktion Autorisierung durchgeführt, um Geldmittel von der Karte des Kunden zu erhalten. Anschließend erfolgt ein Capture, um die Transaktion abzuschließen.
Endpunkt : /preauth
PreAuth-Anfrage
{
"amount":"60.00",
"refid":"89045432",
"siteid":"123456",
"terminalserialnumber":"6789654678",
"txndate":"2023-02-01:16:13:20",
"type":"preauth",
"wait":"y"
}
Feldspezifikation anfordern
| Feld | Format | Beschreibung | |
| Erforderlich | amount |
Zeichenfolge z. B. 20,00 |
Der für die Transaktion vorab zu autorisierende Betrag in Haupteinheiten (z. B. 20 £ würde als 20,00 eingegeben werden). Die Gelder werden erst dann von der Karte des Kunden abgebucht, wenn eine Erfassungsanforderung bearbeitet wird. |
| Erforderlich | refid |
Zeichenfolge (Mindestlänge: 1) z. B. 1234567890 |
Der eindeutige Bezeichner für die zu übermittelnde Transaktion. (Der übermittelte Wert muss im Rahmen Ihrer eigenen Transaktionen eindeutig sein) |
| Erforderlich | siteid |
Zeichenfolge (Mindestlänge: 1) z. B. 1234 |
Einzigartiger Identifikationscode, der von Trust Payments bereitgestellt wird. |
| Erforderlich | terminalserialnumber |
Zeichenfolge (Mindestlänge: 1) z. B. 1234567890 |
Die eindeutige Kennung des Terminals für das PIN-Eingabegerät (PED), das die Kartendaten liefert. Dies ist die Seriennummer des PED. |
| Erforderlich | txndate |
Zeichenfolge z. B. 2020-03-01:10:20:05 |
Eindeutiger Zeitstempel für die Transaktion. |
| Erforderlich | type | Zeichenfolge | Sie müssen "preauth" übermitteln, wie im Beispiel der Anfrage gezeigt. |
| Erforderlich | wait | Zeichenfolge |
Die folgenden zwei Werte können übermittelt werden:
Der Status der Transaktion kann zu einem späteren Zeitpunkt überprüft werden, indem eine Statusanfrage über TRU Link gestellt wird. |
| Optional | topuptoken |
Zeichenfolge z. B. 1234567890 |
Ein Token, der die vorherige Autorisierung mit dieser verbindet. Ermöglicht die Aufstockung der reservierten Mittel. |
PreAuth-Antwort
{
"amount":"60.00",
"authcode":"abc1234",
"cardtype":"Visa",
"expiry":"2023-02-08:04:13:20",
"finalamount":"60.00",
"last4":"0026",
"merchantreceipt":"Sample output",
"receipt":"Sample output",
"refid":"123456789876543212345",
"resultcode":"Approved",
"siteid":"123456",
"terminalserialnumber":"6789654678",
"topuptoken":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
}
Spezifikation des Antwortfeldes
| Feld | Format | Beschreibung | |
| Zurückgeschickt | amount |
Zeichenfolge z. B. 20,00 |
Der ursprünglich für die Transaktion genehmigte Gesamtbetrag in Haupteinheiten (z. B. 20,- € würde als 20,00 € zurückgegeben). Anmerkung: Die amount kann aufgrund von Änderungen, die der Kunde während des Bestellvorgangs vorgenommen hat (z. B. Hinzufügung von Trinkgeld), von dem in der Anfrage angegebenen Wert abweichen. |
| Zurückgeschickt | refid |
Zeichenfolge z. B. 1234567890 |
Die eindeutige Kennung, die der eingereichten Transaktion zugewiesen wurde. |
| Zurückgeschickt | resultcode |
Zeichenfolge z. B. Genehmigt |
Das Ergebnis der Transaktion des Erwerbers. Mögliche Werte sind:
|
| Zurückgeschickt | siteid |
Zeichenfolge z. B. 1234 |
Eindeutiger Code zur Identifizierung der Website Trust Payments , die für die Bearbeitung der Anfrage verwendet wird. |
| Zurückgeschickt | terminalserialnumber |
Zeichenfolge z. B. 1234567890 |
Der eindeutige Terminal-Identifikator für das PIN-Eingabegerät (PED), das die Kartendaten liefert. |
| Bedingt | authcode |
Zeichenfolge z. B. 1234567890 |
Der Autorisierung Code der Transaktion. Wird nur zurückgegeben, wenn die Transaktion genehmigt wurde. |
| Bedingt | cardtype |
Zeichenfolge z. B. Visa |
Enthält den für diese Transaktion verwendeten Kartentyp (z. B. "VISA"). Wird zurückgegeben, wenn verfügbar. |
| Bedingt | error |
Zeichenfolge z. B. Ungültiger Betrag |
Das Feld gibt Details zu einem Fehler zurück, wenn eine Anfrage nicht erfolgreich verarbeitet wurde. Informationen zur Fehlerbehandlung. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist. |
| Bedingt | errorcode |
Ganzzahl z. B. 1006 |
Dieser Code hilft Ihnen, den Fehler zu identifizieren, wenn eine Anfrage nicht erfolgreich verarbeitet wurde. Informationen zur Fehlerbehandlung. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist. |
| Bedingt | expiry |
Zeichenfolge z. B. 2023-02-08:04:13:20 |
Das Verfallsdatum und die Verfallszeit der Autorisierung. Nach Ablauf dieser Zeit ist es nicht mehr möglich, das Guthaben aufzuladen oder zu erfassen. Wird zurückgegeben, wenn verfügbar. |
| Bedingt | finalamount |
Zeichenfolge z. B. 20,00 |
Der für die Transaktion genehmigte Endbetrag in Haupteinheiten (z. B. 20,- € würde als 20,00 € zurückgegeben). Anmerkung: Die finalamount enthält alle Änderungen, die der Kunde während der Kaufabwicklung vorgenommen hat (z. B. Hinzufügen von Trinkgeld). Wird zurückgegeben, wenn der finalamount vom ursprünglichen Betrag abweicht. |
| Bedingt | last4 |
Zeichenfolge z. B. 6789 |
Die letzten 4 Ziffern der Debit-/Kreditkarte des Kunden, die zur Durchführung der Transaktion verwendet wurde. Wird zurückgegeben, wenn verfügbar. |
| Bedingt | merchantreceipt |
Zeichenfolge z. B. Händlerbeleg |
Enthält Händlerbon-Daten, die für den Druck auf ePOS verwendet werden können. Wird zurückgegeben, wenn verfügbar. |
| Bedingt | message |
Zeichenfolge z. B. Nachricht |
Antwortnachricht des Ausstellers, wenn die Karte abgelehnt wird. Wird nur bei einer Ablehnung zurückgegeben. |
| Bedingt | receipt |
Zeichenfolge z. B. Kundenbeleg |
Enthält die Belegdaten des Karteninhabers, die für den Druck auf ePOS verwendet werden können. Wird zurückgegeben, wenn verfügbar. |
| Bedingt | topuptoken |
Zeichenfolge z. B. 1234567890 |
Ein Token, der die vorherige Autorisierung mit dieser verbindet. Ermöglicht die Aufstockung der reservierten Mittel. Wird zurückgegeben, wenn verfügbar. |
