Transaktionen durchsuchen

Transaktionen durchsuchenServer-sideAdmin

get/merchants/{merchant_id}/reports/transactions/search.{format}

Gibt eine Liste von Transaktionen basierend auf bestimmten Suchparametern zurück. In der Antwort sind Daten zu allen in Ihrem Spiel getätigten Zahlungen aufgeführt, auch wenn diese nicht erfolgreich abgeschlossen wurden. Sie können nicht nur den Transaktionszeitraum festlegen, sondern auch andere Parameter, z. B. um nach Transaktionen eines bestimmten Nutzers oder mit einem bestimmten Zahlungsstatus zu suchen. Sie können die Liste im JSON- oder CSV-Format abrufen.

Hinweis

Dieser API-Aufruf enthält nicht den Pfadparameter project_id, Sie müssen also den API-Schlüssel verwenden, der in allen Projekten des Unternehmens gültig ist, um die Autorisierung einzurichten.

SecuritybasicAuth

Request

path Parameters

merchant_id required	integer Händler-ID.
format required	string Datenformat. Enum: "json" "csv" "xls"

query Parameters

datetime_from

string <datetime>

Beginn des Zeitraums.

datetime_to

string <datetime>

Ende des Zeitraums.

project_id

integer

Projekt-ID.

transaction_id

integer

Transaktions-ID.

type

string

In den Suchergebnissen angezeigte Transaktionsart:

Enum:	Description
all	Alle Transaktionen.
canceled	Stornierte Transaktionen ohne Testtransaktionen.
test	Testtransaktionen.
transferred	Erfolgreiche Transaktionen ohne Testtransaktionen.

phone

string

Telefonnummer des Benutzers (im internationalen Format).

user_id

string

Die bei Ihnen gespeicherte eindeutige Benutzer-ID im Spiel. Stellen Sie sicher, dass Sie die vorhandene Benutzer-ID übermitteln. Falls ein Fehler auftritt, lesen Sie die FAQ.

user_name

string

Benutzername.

user_custom

string

Benutzerdefinierte Parameter zur Benutzeridentifikation.

string <= 100 characters

E-Mail des Benutzers.

external_id

string

Transaktions-ID im Spiel. Eine individuelle ID pro Benutzerzahlung erforderlich.

offset

integer

Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0).

limit

integer

Begrenzung der Elementanzahl auf der Seite.

status

string

Ein Transaktionsstatus.

Enum:	Description
awaitingRefund	Entscheidung über die Erstattung ausstehend. Nachdem der Nutzer eine Erstattung beantragt hat, bearbeitet der Xsolla-Kundensupport den Antrag manuell und entscheidet über die Erstattung.
canceled	Es gibt zwei mögliche Szenarien: Die Transaktion wurde seitens des Zahlungssystems storniert. Zum Beispiel, weil das Nutzerkonto nicht ausreichend gedeckt ist. Dem Nutzer wurde der Betrag erstattet.
created	Der Nutzer hat die Transaktion initiiert, sie wurde aber noch nicht verarbeitet.
done	Die Transaktion wurde erfolgreich verarbeitet.
error	Bei der Verarbeitung der Transaktion ist ein Fehler aufgetreten. Solche Zahlungen können durch Kontaktaufnahme mit dem Xsolla-Kundenservice erstattet werden.
partiallyRefunded	Dem Nutzer wurde ein Teil des Betrags erstattet.
processing	Die Transaktion wird verarbeitet.
refunded	Der zu erstattende Betrag wurde dem Xsolla-Guthaben des Nutzers gutgeschrieben.
review	Die Transaktionsverarbeitung wurde vom Betrugsbekämpfungssystem ausgesetzt, die Transaktion wird derzeit geprüft.

Responses

200

OK.

Request samples

Response samples

application/json

[{"payment_details": {"payment": {"amount": 7.96,
"amount_from_ps": 7.96,
"currency": "RUB"
},
"sales_tax": {"amount": 0,
"percent": 0
}
},
"payment_system": {"decline_reason": null
},
"purchase": {"pin_codes": {"amount": null,
"content": null,
"currency": null
},
"simple_checkout": {"amount": 7.96,
"currency": "RUB"
},
"subscription": {"name": null
},
"virtual_currency": {"amount": 0,
"name": null
},
"virtual_items": null
},
"transaction": {"create_date": "2021-10-20",
"dry_run": 0,
"external_id": "example-external-id",
"id": 123456789,
"is_refund_allowed": 0,
"payment_method": {"id": 1,
"name": "PayPal"
},
"project": {"id": 123456,
"name": "Example"
},
"refund_reason": null,
"status": "done",
"transfer_date": "2021-10-20"
},
"user": {"country": "RU",
"custom": null,
"email": "email@example.com",
"id": "example-id",
"name": "Example",
"phone": null
}
}
]