Chargeback

Markdown

Bevor Sie beginnen

Ihre API-Anfragen werden mit einem Zugriffstoken authentifiziert. Jede Anfrage, die kein gültiges Zugriffstoken enthält, gibt einen Fehler zurück. Erfahren Sie mehr unter Authentifizierung.

Basis-URL

• UAT: https://transactions.transactional.uat.unico.app/api/public/v1
• Produktion: https://transactions.transactional.unico.app/api/public/v1

Chargeback melden

POST /credit/transactions/{transaction_id}/chargeback — meldet Unico, dass für eine angegebene Transaktion ein Chargeback eingegangen ist.

Eine Meldung ist keine Anfechtung

Dieser Endpunkt meldet lediglich den Chargeback. Er eröffnet keine Chargeback-Analyse und löst die Haftungsgarantie nicht aus. Damit Unico den Chargeback analysiert, eröffnen Sie im Portal eine Anfechtung für die Transaktion.

Header

Header	Wert
Authorization	Bearer {token} — ein gültiges Zugriffstoken.

Body

{
  "datetime": "2023-01-05T03:00:00.000Z",
  "requestor": { "key": "cpf", "value": "USER_CPF" },
  "name": "USER_NAME",
  "reason": "REQUEST_REASON",
  "observation": "GENERAL_OBSERVATIONS"
}

Feld	Typ	Erforderlich	Beschreibung
datetime	string	ja	Datum und Uhrzeit des Eingangs des Chargebacks, ISO-8601-Format.
requestor	object	ja	Informationen zum Antragsteller.
requestor.key	string	ja	Typ des Identifikationsschlüssels für den Antragsteller (z. B. cpf).
requestor.value	string	ja	Wert des Identifikationsschlüssels für den Antragsteller.
name	string	ja	Name des Antragstellers.
reason	string	ja	Grund für den Chargeback.
observation	string	nein	Allgemeine Anmerkungen zum Chargeback.

201 Created

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"
}

Feld	Beschreibung
id	Chargeback-ID.

Eine Transaktion hat genau einen Chargeback. Wird eine Transaktion gemeldet, die bereits einen hat, wird 200 OK mit der id des bestehenden Chargebacks zurückgegeben, ohne diesen zu ändern.

Fehlerantworten finden Sie unter Fehler — Transaktionserstellung.

Chargeback-Status abrufen

GET /credit/transactions/{transaction_id}/chargeback/{chargeback_id} — prüft den Status eines bestimmten Chargebacks.

Header

Header	Wert
Authorization	Bearer {token} — ein gültiges Zugriffstoken.

200 OK

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "status": "waiting"
}

Feld	Beschreibung
id	Chargeback-ID.
status	Aktueller Status des Chargebacks.

Ein gemeldeter Chargeback bleibt im Status waiting. Wird die Transaktion im Portal angefochten, zeigt dieselbe id den Fortschritt und das Ergebnis der Analyse. Alle möglichen Status finden Sie unter Aufzählungen — Chargeback-Ergebnis. Um die Leistung zu optimieren, implementieren Sie den Webhook, anstatt diesen Endpunkt abzufragen.