Verwenden Sie diese Transaktion, um einen Standardverkauf zu bearbeiten.
Endpunkt : /sale
- Die Transaktion wird am Ende des Tages automatisch abgewickelt.
- Für DCC wird die PED auf Wunsch in der Karte Währung verarbeitet.
Verkauf Anfrage
{
"amount":"20.00",
"refid":"12345678987654321",
"siteid":"123456",
"terminalserialnumber":"6789654678",
"txndate":"2023-02-01:16:13:20",
"type":"sale",
"wait":"y"
}
Feldspezifikation anfordern
| Feld | Format | Beschreibung | |
| Erforderlich | amount | Zeichenfolge z.B. 20.00 |
Der volle Betrag für die Transaktion in Haupteinheiten (z. B. £ 20 würde als 20,00 übermittelt werden). Der angegebene Wert muss größer als 0 sein. |
| Erforderlich | refid | String (Mindestlänge: 1) z.B. 1234567890 |
Der eindeutige Bezeichner der zu übermittelnden 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 "Verkauf" angeben, wie im Beispiel des Antrags 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. |
Verkauf Antwort
{
"amount":"20.00",
"authcode":"abc1234",
"cardtype":"Visa",
"finalamount":"20.00",
"last4":"0026",
"merchantreceipt":"Sample output",
"receipt":"Sample output",
"refid":"12345678987654321",
"resultcode":"Approved",
"siteid":"123456",
"terminalserialnumber":"6789654678"
}
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 autorisiert ist. |
| 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 | Ganzzahl z.B. 1006 |
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 | String z.B. Ungültiger Betrag |
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 | letzte4 | Zeichenfolge z.B. 6789 |
Die letzten vier Ziffern der Zahlungskarte des Kunden. 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. |
