# Transaktionen abrufen

Gibt eine Liste mit detaillierten Informationen zu erfolgreichen und 
abgebrochenen Transaktionen für einen bestimmten Zeitraum zurück. In der 
Antwort sind Zahlungsinformationen aufgeführt, einschließlich Daten zu 
Gebühren, Steuern, Bestellungen und Nutzern. Sie können die Liste im JSON- oder 
CSV-Format abrufen. Sie können diesen API-Aufruf verwenden, um einen 
Finanzabgleich durchzuführen.


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

Endpoint: GET /merchants/{merchant_id}/reports/transactions/registry.{format}
Version: 2.0
Security: basicAuth

## Path parameters:

  - `merchant_id` (integer, required)
    Händler-ID.

  - `format` (string, required)
    Datenformat.
    Enum: "json", "csv", "xls"

## Query parameters:

  - `datetime_from` (string, required)
    Beginn des Zeitraums im Format JJJJ-MM-TT. Nicht erforderlich, wenn mindestens einer der folgenden Parameter übermittelt wird:transfer_idreport_id
    Example: "2023-02-08"

  - `datetime_to` (string, required)
    Ende des Zeitraums im Format JJJJ-MM-TT. Nicht erforderlich, wenn mindestens einer der folgenden Parameter übermittelt wird:transfer_idreport_id Der Zeitraum zwischen datetime_from und datetime_to darf maximal 92 Tage betragen.
    Example: "2023-03-08"

  - `in_transfer_currency` (integer, required)
    Konvertiert alle Finanzdaten in die Auszahlungswährung (standardmäßig wird die Einzahlungswährung verwendet). Nicht erforderlich, wenn mindestens einer der folgenden Parameter übermittelt wird:transfer_idreport_id

  - `show_total` (boolean)
    Ob der Gesamtbetrag der Transaktionen im Bericht enthalten sein soll. Nur für den Export im CSV-Format verfügbar. Standardwert ist true.

  - `merchant_of_records` (string,null)
    Merchant of Record. Kann xsolla, merchant oder nicht spezifiziert sein. Wenn merchant festgelegt ist, werden Transaktionen zurückgegeben, die über die Gateways des Partners abgewickelt wurden. Wenn xsolla festgelegt ist, werden Transaktionen zurückgegeben, die nicht über die Gateways des Partners abgewickelt wurden. Wenn nichts angegeben ist, werden alle Transaktionen zurückgegeben.
    Enum: "xsolla", "merchant"

  - `project_id` (integer)
    Projekt-ID.

  - `show_dry_run` (boolean)
    Legt fest, ob testweise durchgeführte Transaktionen miteinbezogen werden.

  - `transfer_id` (integer)
    ID der Auszahlung.

  - `report_id` (integer)
    ID des Finanzberichts.

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

  - `limit` (integer)
    Das Limit für die Anzahl der angezeigten Transaktionen auf der Seite. Wird dieser Parameter übermittelt, brauchen Sie die Parameter datetime_from und datetime_to nicht zu übermitteln.

  - `status` (string)
    Status der Transaktion.
    Enum: "done", "canceled", "error", "refunded"

## Response 200 fields (application/json):

  - `payment_details` (object)
    Zahlungsdaten.

  - `payment_details.chargebackPenalty` (object)

  - `payment_details.chargebackPenalty.amount` (number)

  - `payment_details.commission_agent` (object)

  - `payment_details.commission_agent.percent` (number)

  - `payment_details.commission_agent_fixed` (integer)

  - `payment_details.commission_ps` (object)

  - `payment_details.commission_ps.fixed_amount` (integer)

  - `payment_details.commission_ps_from_vat` (object)

  - `payment_details.commission_user` (object)

  - `payment_details.commission_xsolla` (object)

  - `payment_details.cpa_network_commission` (object)

  - `payment_details.direct_wht` (object)

  - `payment_details.payment` (object)

  - `payment_details.payment.amount_from_ps` (integer)

  - `payment_details.payment.currency` (string)

  - `payment_details.payout` (object)

  - `payment_details.payout.fx_rate` (number)

  - `payment_details.refundPenalty` (object)

  - `payment_details.repatriation_costs` (object)

  - `payment_details.sales_tax` (object)

  - `payment_details.vat` (object)

  - `payment_details.vat.user_amount` (integer)

  - `payment_details.vat.user_percent` (integer)

  - `purchase` (object)
    Kaufdaten.

  - `purchase.friend` (object)

  - `purchase.friend.email` (string,null)

  - `purchase.friend.user_id` (string,null)

  - `purchase.items_amount` (integer)

  - `purchase.pin_codes` (object)

  - `purchase.pin_codes.content` (string,null)

  - `purchase.purchase_amount` (number)

  - `purchase.simple_checkout` (object)

  - `purchase.subscription` (object)

  - `purchase.subscription.name` (string,null)

  - `purchase.subscription.plan_id` (integer,null)

  - `purchase.subscription.product_id` (string,null)

  - `purchase.subscription.product_name` (string,null)

  - `purchase.subscription.subscription_id` (integer,null)

  - `purchase.virtual_currency` (object)

  - `purchase.virtual_currency_amount` (integer)

  - `purchase.virtual_items` (object)

  - `transaction` (object)
    Transaktionsdaten.

  - `transaction.custom_parameters` (object,null)

  - `transaction.direct_account` (integer)

  - `transaction.dry_run` (integer)

  - `transaction.external_id` (string,null)

  - `transaction.id` (integer)

  - `transaction.payment_method` (object)

  - `transaction.payment_method.class` (string)

  - `transaction.project` (object)

  - `transaction.refund_reason` (string,null)

  - `transaction.refund_reason_comment` (string,null)

  - `transaction.status` (string)
    Enum: "created", "processing", "done", "canceled", "error", "refunded", "partiallyRefunded", "awaitingRefund", "disputeFee"

  - `transaction.transfer_date` (string)

  - `user` (object)
    Benutzerdaten (Objekt).

  - `user.country` (string)
    Ländercode, bestehend aus 2 Großbuchstaben gemäß [ISO 3166-1 ALPHA-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `user.custom` (string,null)

  - `user.email` (string)
    E-Mail des Benutzers.

  - `user.id` (string)
    Benutzer-ID.

  - `user.ip` (string)

  - `user.marketplace` (string)

  - `user.name` (string)
    Benutzername.

  - `user.phone` (string,null)
    Telefonnummer des Benutzers.

  - `user_balance` (object)
    Benutzerguthaben.

  - `user_balance.payment_currency` (object)
    Bevorzugte Zahlungswährung.

  - `user_balance.payment_currency.deduction_amount` (number)

  - `user_balance.payment_currency.payout_amount_from_balance` (number)

  - `user_balance.payment_currency.purchase_amount_from_balance` (number)