Verwenden Sie diese Transaktion für die Rückerstattung auf eine Karte.
Endpunkt : /refund
Erstattungsantrag
{
"amount":"20.00",
"linked":"n",
"refid":"12345678987654321234",
"siteid":"123456",
"terminalserialnumber":"6789654678",
"txndate":"2023-02-01:16:13:20",
"type":"refund"
}
Feldspezifikation anfordern
Feld | Format | Beschreibung | |
Erforderlich | amount | Zeichenfolge z.B. 20.00 |
Der zu erstattende Betrag in Haupteinheiten (z.B. £20 würde als 20,00 eingereicht werden). Der eingereichte Betrag kann nicht höher sein als der ursprüngliche Verkauf. |
Erforderlich | refid | String (Mindestlänge: 1) z.B. 1234567890 |
Die eindeutige Kennung einer früheren Transaktion, die erstattet werden soll. |
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 "Erstattung" angeben, wie im Antragsbeispiel gezeigt. |
Optional | linked | Zeichenfolge |
Die folgenden zwei Werte können übermittelt werden:
Wenn keine Angaben gemacht werden, ist "linked" standardmäßig auf "y" gesetzt. |
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. |
Antwort auf die Erstattung
{
"amount":"20.00",
"merchantreceipt":"Sample output",
"receipt":"Sample output",
"refid":"12345678987654321234",
"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 der vorherigen Transaktion, die erstattet werden soll. |
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 | 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 | 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. |