Transaktionen abrufen

Transaktionen abrufenServer-sideAdmin

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

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.

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

required

string <datetime>

Beginn des Zeitraums im Format JJJJ-MM-TT. Nicht erforderlich, wenn der Parameter limit übermittelt wird.

Example: datetime_from=2023-02-08

datetime_to

required

string <datetime>

Ende des Zeitraums im Format JJJJ-MM-TT. Nicht erforderlich, wenn der Parameter limit übermittelt wird. Die Zeitspanne zwischen datetime_from und datetime_to darf maximal 92 Tage betragen.

Example: datetime_to=2023-03-08

in_transfer_currency

required

integer

Rechnet alle Finanzdaten in die Währung um, welche für die Auszahlungen verwendet wird (standardmäßig ist die Währung festgelegt, die für Bezahlungen verwendet wird).

show_total

required

boolean

Fügt die Gesamtsumme zum Bericht hinzu.

merchant_of_records

string or 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:	Description
merchant	Gibt Transaktionen zurück, die über die Gateways des Partners getätigt wurden.
xsolla	Gibt Transaktionen zurück, die nicht über die Gateways des Partners getätigt wurden.

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"

Responses

200

Die Liste der Transaktionen wurde erfolgreich zurückgegeben.

Request samples

Response samples

application/json

[{"payment_details": {"chargebackPenalty": {"amount": 0
},
"commission_agent": {"amount": 0,
"percent": 0
},
"commission_agent_fixed": 0,
"commission_ps": {"amount": 0,
"fixed_amount": 0,
"percent": 0
},
"commission_ps_from_vat": {"amount": 0
},
"commission_user": {"amount": 0.01,
"percent": 33.33
},
"commission_xsolla": {"amount": 0,
"fixed_amount": 0,
"percent": 5
},
"cpa_network_commission": {"amount": 0,
"percent": 0
},
"direct_wht": {"amount": 0,
"percent": 0
},
"payment": {"amount": 0.03,
"amount_from_ps": 0,
"currency": "USD"
},
"payout": {"amount": 0.02,
"amount_from_ps": 0,
"currency": "RUB",
"fx_rate": 64.1386407767,
"percent": 100
},
"refundPenalty": {"amount": 0
},
"repatriation_costs": {"amount": 0,
"percent": 0
},
"sales_tax": {"amount": 0,
"percent": 0
},
"vat": {"amount": 0,
"percent": 0,
"user_amount": 0,
"user_percent": 0
}
},
"purchase": {"friend": {"email": null,
"user_id": null
},
"items_amount": 1,
"pin_codes": {"amount": null,
"content": null,
"currency": null
},
"purchase_amount": 0.02,
"simple_checkout": {"amount": null,
"currency": null
},
"subscription": {"name": null,
"plan_id": null,
"product_id": null,
"product_name": null,
"subscription_id": null
},
"virtual_currency": {"amount": 0.02,
"currency": "USD"
},
"virtual_currency_amount": 1,
"virtual_items": {"amount": null,
"content": null,
"currency": null
}
},
"transaction": {"custom_parameters": null,
"direct_account": 0,
"dry_run": 0,
"external_id": null,
"id": 418756634,
"payment_method": {"class": "Digital Payment Methods",
"id": 2760,
"name": "Your Balance"
},
"project": {"id": 21092,
"name": "Smith"
},
"refund_reason": null,
"refund_reason_comment": null,
"status": "done",
"transfer_date": "2019-02-11T13:32:00+03:00"
},
"user": {"country": "US",
"custom": null,
"email": "email@example.com",
"id": "smith123",
"ip": "209.11.22.33",
"marketplace": "Pay Station",
"name": "Tom",
"phone": null
},
"user_balance": {"payment_currency": {"deduction_amount": 0,
"payout_amount_from_balance": 0.02,
"purchase_amount_from_balance": 0.02
}
}
}
]