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 | 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 | 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 | 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. |
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 | 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. |
| 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 | 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 | 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 | 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. |
