Capture - Trust Payments

Verwenden Sie diese Transaktion, um eine zuvor genehmigte Transaktion zu erfassen.

Endpunkt : /capture

Voraussetzungen

Die Einziehung kann bis zu 100 % der ursprünglichen Genehmigung betragen.
Die Erfassung kann nur einmal für eine PreAuth.
Die Transaktion kann an einem anderen Terminal als der ursprünglichen Transaktion erfasst werden. Wenn keine terminalserialnumber empfangen wird, verwendet das System die terminalserialnumber verwendet in der PreAuth.

Anfrage erfassen

{
"amount":"40.00",
"refid":"123456789876543212345",
"siteid":"123456",
"txndate":"2023-02-01:16:13:20",
"type":"capture"
}

Feldspezifikation anfordern

	Feld	Format	Beschreibung
Erforderlich	amount	Zeichenfolge z. B. 20,00	Der zu erfassende Betrag in Haupteinheiten (z.B. £20 würde als 20,00 übermittelt werden). Der eingegebene Betrag kann nicht höher sein als das ursprüngliche PreAuth. Wenn der Betrag nicht eingezogen wird, werden alle verbleibenden reservierten Mittel schließlich an den Kunden zurückgegeben.
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	txndate	Zeichenfolge z. B. 2020-03-01:10:20:05	Eindeutiger Zeitstempel für die Transaktion.
Erforderlich	type	Zeichenfolge	Sie müssen "capture" eingeben, wie im Antragsbeispiel gezeigt.
Optional	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.

Erfassungsreaktion

{
"finalamount":"40.00",
"merchantreceipt":"Sample output",
"receipt":"Sample output",
"refid":"123456789876543212345",
"resultcode":"Approved",
"siteid":"123456"
}

Spezifikation des Antwortfeldes

	Feld	Format	Beschreibung
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: Approved Cancelled Connection Timeout Declined Error Pending Terminal Busy
Zurückgeschickt	siteid	Zeichenfolge z. B. 1234	Eindeutiger Code zur Identifizierung der Website Trust Payments , die für die Bearbeitung der Anfrage verwendet wird.
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	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	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	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.