UserHistory-GetHistory-v2: Difference between revisions

From Barion Documentation
Jump to navigation Jump to search
No edit summary
 
(One intermediate revision by one other user not shown)
Line 13: Line 13:
* [[Creating_an_account|Creating an account in Barion]]
* [[Creating_an_account|Creating an account in Barion]]
* [[Calling_the_API|Calling the Barion API]]
* [[Calling_the_API|Calling the Barion API]]
* [[Barion Wallet Authentication]]


{{NotificationBox|title=IMPORTANT|text=This API should not be used for reconciliation, use the [[Statement-Download-v2 | statement API]] instead.|color=#FF7A3D}}
{{NotificationBox|title=IMPORTANT|text=This API should not be used for reconciliation, use the [[Statement-Download-v2 | statement API]] instead.|color=#FF7A3D}}
{{NotificationBox|title=IMPORTANT|text=The item type of history elements does not correlate with the type of transactions exported through GUI or downloaded with[[Statement-Download-v2 | statement API]].|color=#FF7A3D}}
{{NotificationBox|title=IMPORTANT|text=The item type of history elements does not correlate with the type of transactions exported through GUI or downloaded with[[Statement-Download-v2 | statement API]].|color=#FF7A3D}}


== Authentication ==
[[Barion Wallet Authentication]]


== Input properties ==
== Input properties ==
Line 28: Line 30:
* Optional
* Optional
  ||  
  ||  
The identifier of the most recent transaction. Only transactions after the defined transaction will be included in the response.
The identifier of the oldest transaction. Only transactions before the defined transaction will be included in the response.
|-
|-



Latest revision as of 13:44, 21 March 2023

Barion API: transaction history

GET /v2/UserHistory/GetHistory

The /v2/UserHistory/GetHistory API endpoint is used to query the transaction history from the Barion system for the authenticated wallet.

Prerequisites before use:

IMPORTANT
This API should not be used for reconciliation, use the statement API instead.
IMPORTANT
The item type of history elements does not correlate with the type of transactions exported through GUI or downloaded with statement API.

Authentication

Barion Wallet Authentication

Input properties

The input properties should be defined in the query string.

Property name Property type Limitations and constraints Description
LastVisibleItemId Guid
  • Optional

The identifier of the oldest transaction. Only transactions before the defined transaction will be included in the response.

LastRequestTime DateTime
  • Optional
  • Universal Time Coordinated (UTC)

The exact time of the last request. Only transactions after the defined request time will be included in the response.

Limit int
  • Optional
  • If not defined the default value is 20
  • If the defined value is greater than 20 the default value will be used

The expected number of transactions in the response.

Currency string
  • Optional
  • Required length: 3 characters
  • Must be supplied in ISO 4217 format

Accepted values:

  • "CZK" (Czech crown)
  • "EUR" (Euro)
  • "HUF" (Hungarian forint)
  • "USD" (U.S. dollar)
The currency of the transaction. If the currency is defined, then only transactions in the same currency will be included in the response.

Output properties

Property name Property type Description
Id Guid The identifier of the transaction.
Type HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
ConcurrencyOrder int The order of the transaction when more than one transaction happened at the same time. The default value is 0.
SourceAccount UserHistoryParticipant The user who initiated the transaction or from whom the money originated.
TargetAccount UserHistoryParticipant The user who will receive the amount of the transaction.
Amount decimal The amount of the transaction.
Currency string The 3-character ISO 4217 currency code of the payment.
Description string Description of the transaction. Max: 640 characters.
IsInProgress bool This flag indicates that the transaction is not in the final state.