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 Betrag, der für die Transaktion vorautorisiert werden soll, wird in Haupteinheiten angegeben (z. B. 20,00 £). Die Karte des Kunden wird erst dann belastet, wenn ein Capture-Antrag bearbeitet wurde. |
| Erforderlich | refid | String (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 | String (Mindestlänge: 1) z.B. 1234 |
Einzigartiger Identifikationscode, der von Trust Payments bereitgestellt wird. |
| Erforderlich | terminalserialnumber | String (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 | String 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 | String z.B. 1234567890 |
Die eindeutige Kennung, die der eingereichten Transaktion zugewiesen wurde. |
| Zurückgeschickt | resultcode | String 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 | String z.B. 1234567890 |
Der eindeutige Terminal-Identifikator für das PIN-Eingabegerät (PED), das die Kartendaten liefert. |
| Bedingt | authcode | String 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 | String z.B. Ungültiger Betrag |
Das Feld gibt Details zu einem Fehler zurück, wenn eine Anfrage nicht erfolgreich bearbeitet 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 bearbeitet 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 | Zeichenkette z.B. Merchant Receipt |
Enthält Händlerbon-Daten, die für den Druck auf ePOS verwendet werden können. Wird zurückgegeben, wenn verfügbar. |
| Bedingt | message | String z.B. Nachricht |
Antwortnachricht des Ausstellers, wenn die Karte abgelehnt wird. Wird nur bei einer Ablehnung zurückgegeben. |
| Bedingt | receipt | String z.B. Kundenquittung |
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 | String 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. |
