TransactionHistory-GetDetail-v3: Difference between revisions

From Barion Documentation
Jump to navigation Jump to search
 
(65 intermediate revisions by the same user not shown)
Line 14: Line 14:
* [[Calling_the_API|Calling the Barion API]]
* [[Calling_the_API|Calling the Barion API]]


{{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}}


== Authentication ==
== Authentication ==


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


== Input properties ==
== Input properties ==
Line 27: Line 27:
{{api_input_table_header}}
{{api_input_table_header}}
|-
|-
| ItemId || Guid || * Required || The identifier of the history element.
| ItemId || Guid ||  
* Required  
|| The identifier of the history element.
|}
|}


== Input properties ==




Line 48: Line 49:
!Link to the structure
!Link to the structure
|-
|-
| BankTransferPayment || [[BankTransferPaymentDetail | BankTransferPayment structure]]
| BankTransferPayment || [[TransactionHistory-GetDetail-v3#BankTransferPayment | BankTransferPayment structure]]
|-
| BankTransferPaymentFee || [[TransactionHistory-GetDetail-v3#BankTransferPaymentFee | BankTransferPaymentFee structure]]
|-
| BarionBalanceProcessingFee || [[TransactionHistory-GetDetail-v3#BarionBalanceProcessingFee | BarionBalanceProcessingFee structure]]
|-
| BlockAmount || [[TransactionHistory-GetDetail-v3#BlockAmount | BlockAmount structure]]
|-
| CardPayment || [[TransactionHistory-GetDetail-v3#CardPayment | CardPayment structure]]
|-
| CardProcessingFee || [[TransactionHistory-GetDetail-v3#CardProcessingFee | CardProcessingFee structure]]
|-
| CardTopUp || [[TransactionHistory-GetDetail-v3#CardTopUp | CardTopUp structure]]
|-
| CashTopUp || [[TransactionHistory-GetDetail-v3#CashTopUp | CashTopUp structure]]
|-
| Comission || [[TransactionHistory-GetDetail-v3#Comission | Comission structure]]
|-
| Donation || [[TransactionHistory-GetDetail-v3#Donation | Donation structure]]
|-
| ElectronicMoneyPayment || [[TransactionHistory-GetDetail-v3#ElectronicMoneyPayment | ElectronicMoneyPayment structure]]
|-
| ExternalTransfer || [[TransactionHistory-GetDetail-v3#ExternalTransfer | ExternalTransfer structure]]
|-
| GatewayFee || [[TransactionHistory-GetDetail-v3#GatewayFee | GatewayFee structure]]
|-
| InternalTransfer || [[TransactionHistory-GetDetail-v3#InternalTransfer | InternalTransfer structure]]
|-
| IssueFromCustody || [[TransactionHistory-GetDetail-v3#IssueFromCustody | IssueFromCustody structure]]
|-
| PayeeTransaction || [[TransactionHistory-GetDetail-v3#PayeeTransaction | PayeeTransaction structure]]
|-
| RefundToBankAccount || [[TransactionHistory-GetDetail-v3#RefundToBankAccount | RefundToBankAccount structure]]
|-
| RefundToCard || [[TransactionHistory-GetDetail-v3#RefundToCard | RefundToCard structure]]
|-
| RefundToWallet || [[TransactionHistory-GetDetail-v3#RefundToWallet | RefundToWallet structure]]
|-
| RejectedWithdraw || [[TransactionHistory-GetDetail-v3#RejectedWithdraw | RejectedWithdraw structure]]
|-
| RejectedWithdrawFee || [[TransactionHistory-GetDetail-v3#RejectedWithdrawFee | RejectedWithdrawFee structure]]
|-
| ReleaseAmount || [[TransactionHistory-GetDetail-v3#ReleaseAmount | ReleaseAmount structure]]
|-
| UnsuccessfulRefundToBankAccount || [[TransactionHistory-GetDetail-v3#UnsuccessfulRefundToBankAccount | UnsuccessfulRefundToBankAccount structure]]
|-
| UnsuccessfulRefundToCard || [[TransactionHistory-GetDetail-v3#UnsuccessfulRefundToCard | UnsuccessfulRefundToCard structure]]
|-
| UnsuccessfulTransfer || [[TransactionHistory-GetDetail-v3#UnsuccessfulTransfer | UnsuccessfulTransfer structure]]
|-
| UnsuccessfulWithdraw || [[TransactionHistory-GetDetail-v3#UnsuccessfulWithdraw | UnsuccessfulWithdraw structure]]
|-
| WireTopUp || [[TransactionHistory-GetDetail-v3#WireTopUp | WireTopUp structure]]
|-
| Withdraw || [[TransactionHistory-GetDetail-v3#Withdraw | Withdraw structure]]
|-
| WithdrawFee || [[TransactionHistory-GetDetail-v3#WithdrawFee  | WithdrawFee structure]]
|-
|}
 
== Custom structures ==
 
=== BankTransferPayment ===
 
Customers can pay by wire transfer to the facilitator or the e-shop.
 
{{TransactionHistoryDetail}}
{{PaymentDetail}}
|}
 
=== BankTransferPaymentFee ===
 
Bank transfer payment fee is paid by the facilitator or e-shop to the Barion after the successful payments if the customer paid by wire transfer.
 
{{TransactionHistoryDetail}}
{{PaymentDetail}}
|-
|}
 
=== BarionBalanceProcessingFee ===
 
Barion balance processing fee is paid by the facilitator or e-shop to the Barion after the successful payments. This fee type is used when the payer paid with their Barion balance and the shop has been configured to pay this fee.
 
{{TransactionHistoryDetail}}
|-
| PaymentId ||Guid || The identifier of the payment transaction.
|}
 
=== BlockAmount ===
 
Due to a compliance decision, the Barion can block the amount of the transaction.
 
{{TransactionHistoryDetail}}
|-
| CardUsed || [[TransactionHistory-GetDetail-v3#Card_information | Card]] || The details of the payment card used for the payment transaction.
|-
| BlockedAmount || decimal || The amount that was blocked by Barion.
|}
 
=== CardPayment ===
 
Card payment is used when a customer pays with his bank card to the e-shop.
 
{{TransactionHistoryDetail}}
{{PaymentDetail}}
|-
| CardUsed || [[TransactionHistory-GetDetail-v3#Card_information | Card]] || The details of the payment card used for the payment transaction.
|-
| FraudScore  || decimal || Indicating whether the transaction that this history item is representing has a chance to be a fraud.
|-
| TopUpAuthorizationCode || string || The authorization code received by the card processing system when executing the payment.
|}
 
=== CardProcessingFee ===
 
Card processing fee is paid by the facilitator or e-shop to the Barion after the successful payments.
 
{{TransactionHistoryDetail}}
|-
| PaymentId ||Guid || The identifier of the payment transaction.
|}
 
=== CardTopUp ===
 
Wallet top up with bank card.
 
{{TransactionHistoryDetail}}
|-
| CardUsed || [[TransactionHistory-GetDetail-v3#Card_information | Card]] || The details of the payment card used for the payment transaction.
|-
| FraudScore  || decimal || Indicating whether the transaction that this history item is representing has a chance to be a fraud.
|-
| TopUpAuthorizationCode || string || The authorization code received by the card processing system when executing the payment.
|-
| AmountCharged || decimal || The amount that was charged from the bank card and credited to the user's wallet.
|-
| Fee || decimal || The fee was paid by the user to the Barion.
|}
 
=== CashTopUp ===
 
Users can top up their wallets with cash in some banks in Hungary.
 
{{TransactionHistoryDetail}}
|-
| Fee || decimal || The fee was paid by the user to the Barion.
|-
| TopUpComment || string || The comment of the wire transfer.
|}
 
=== Comission ===
 
Commission paid by the user to the Barion after a successful transaction. Most of the transactions are free. See the pricing list for more details.
 
{{TransactionHistoryDetail}}
|-
|}
 
=== Donation ===
 
[Deprecated]
 
{{TransactionHistoryDetail}}
|-
|}
 
=== ElectronicMoneyPayment ===
 
Electronic money payment is used when a customer pays by his wallet to the e-shop.
 
{{TransactionHistoryDetail}}
{{PaymentDetail}}
|-
|}
 
=== ExternalTransfer ===
 
External transfers are used to transfer money to a non-existing user. The recipient has a specific time to claim the transaction amount.
 
{{TransactionHistoryDetail}}
|-
| WasClaimed || bool || True if the recipient claimed the transaction amount. Otherwise, false.
|-
|-
| BankTransferPaymentFee || [[BankTransferPaymentFeeDetail | BankTransferPaymentFee structure]]
| ResolvedAt || DateTime || The exact time when the recipient claimed the transaction amount.
|}
 
=== GatewayFee ===
 
Gateway fee is paid by the facilitator or e-shop to the Barion after the successful payments.
 
{{TransactionHistoryDetail}}
|-
|-
| BlockAmount || [[BlockAmountDetail | BlockAmount structure]]
| PaymentId || Guid || The identifier of the payment transaction.
|}
 
=== InternalTransfer ===
 
Internal transfers are used to transfer money between wallets.
 
{{TransactionHistoryDetail}}
|-
|-
| CardPayment || [[CardPaymentDetail | CardPayment structure]]
|}
 
=== IssueFromCustody ===
 
Custody is used for unrecognized incoming wire transfers. When an unrecognized transfer is proved by the user, the Barion transfers the transaction amount to the user's wallet.
 
{{TransactionHistoryDetail}}
|-
|-
| CardProcessingFee || [[CardProcessingFeeDetail | CardProcessingFee structure]]
|}
 
=== PayeeTransaction ===
 
Payee transactions are included in a payment transaction. These are e-money sub-transactions that are executed after the payment was fully completed. Payee transactions can be used to transfer royalties, agent fees or such to a third party, or to distribute the amount paid by the payer to multiple Barion wallets.
 
{{TransactionHistoryDetail}}
|-
|-
| CardTopUp || [[CardTopUpDetail | CardTopUp structure]]
| PaymentId || Guid || The identifier of the payment transaction.
|}
 
=== RefundToBankAccount ===
 
Refund from the e-shop's wallet to the customer's bank account.
 
{{TransactionHistoryDetail}}
|-
|-
| CashTopUp || [[CashTopUpDetail | CashTopUp structure]]
| OriginalPaymentId || Guid || The identifier of the payment transaction.
|}
 
=== RefundToCard ===
 
Refund from the e-shop's wallet to the customer's bank card.
 
{{TransactionHistoryDetail}}
|-
|-
| Comission || [[ComissionDetail | Comission structure]]
| OriginalPaymentId || Guid || The identifier of the payment transaction.
|-
|-
| Donation || [[DonationDetail | Donation structure]]
| ToCard || [[TransactionHistory-GetDetail-v3#Card_information | Card]] || The details of the payment card used for the payment transaction.
|}
 
=== RefundToWallet ===
 
Refund from the e-shop's wallet to the customer's wallet.
 
{{TransactionHistoryDetail}}
|-
|-
| ElectronicMoneyPayment || [[ElectronicMoneyPaymentDetail | ElectronicMoneyPayment structure]]
| PaymentId || Guid || The identifier of the payment transaction.
|}
 
=== RejectedWithdraw ===
 
The wire transfer was unsuccessful. In this case, Barion returns the wire transfer amount to the user's wallet.
 
 
{{TransactionHistoryDetail}}
|-
|-
| ExternalTransfer || [[ExternalTransferDetail | ExternalTransfer structure]]
|}
 
=== RejectedWithdrawFee ===
 
The wire transfer was unsuccessful. In this case, Barion returns the wire transfer fee to the user's wallet.
 
{{TransactionHistoryDetail}}
|-
|-
| GatewayFee || [[GatewayFeeDetail | GatewayFee structure]]
|}
 
=== ReleaseAmount ===
 
The previously blocked amount is credited to the user's wallet.
 
{{TransactionHistoryDetail}}
|-
|-
| InternalTransfer || [[InternalTransferDetail | InternalTransfer structure]]
| CardUsed || [[TransactionHistory-GetDetail-v3#Card_information | Card]] || The details of the payment card used for the payment transaction.
|-
|-
| IssueFromCustody || [[IssueFromCustodyDetail | IssueFromCustody structure]]
| ReleasedAmount || decimal || The amount that was released by Barion.
|}
 
=== UnsuccessfulRefundToBankAccount ===
 
It is an unsuccessful refund to a bank account, the amount is credited to the wallet.
 
{{TransactionHistoryDetail}}
|-
|-
| PayeeTransaction || [[PayeeTransactionDetail | PayeeTransaction structure]]
| OriginalPaymentId || Guid || The identifier of the payment transaction.
|}
 
=== UnsuccessfulRefundToCard ===
 
Unsuccessful refund to the source bank card, the amount is credited to the wallet.
 
{{TransactionHistoryDetail}}
|-
|-
| RefundToBankAccount || [[RefundToBankAccountDetail | RefundToBankAccount structure]]
| OriginalPaymentId || Guid || The identifier of the payment transaction.
|-
|-
| RefundToCard || [[RefundToCardDetail | RefundToCard structure]]
| ToCard || [[TransactionHistory-GetDetail-v3#Card_information | Card]] || The details of the payment card used for the payment transaction.
|}
 
=== UnsuccessfulTransfer ===
 
Unsuccessful e-money transfer to a non-existent user. The recipient did not claim the amount, so it was credited to the source wallet.
 
{{TransactionHistoryDetail}}
|-
|}
 
=== UnsuccessfulWithdraw ===
 
Unsuccessful wire transfers from the wallet to the outside of the system. The amount of the transaction is credited to the user's balance.
 
{{TransactionHistoryDetail}}
|-
|}
 
=== WireTopUp ===
 
Wallet top-up transactions that are completed via wire transfer.
 
{{TransactionHistoryDetail}}
|-
| FromAccount || [[TransactionHistory-GetDetail-v3#Bank_account_information | BankAccountInformation]] || The details of the source bank account.
|-
| WireComment || string || The comment of the wire transfer.
|}
 
=== Withdraw ===
 
Wire transfers from the wallet to the outside of the system.
 
{{TransactionHistoryDetail}}
|-
| ToAccount || [[TransactionHistory-GetDetail-v3#Bank_account_information | BankAccountInformation]] || The details of the destination bank account.
|-
| Comment || string || The comment of the wire transfer.
|-
| Fee || decimal || The fee was paid by the user to the Barion.
|}
 
=== WithdrawFee ===
 
The fee that is paid by the user to Barion after wire transfers outside of the system.
 
{{TransactionHistoryDetail}}
|-
|}
 
== Common structures ==
 
The structures listed here can be referenced by the detailers.
 
=== Purchased item ===
 
{{api_output_table_header}}
|-
|-
| RefundToWallet || [[RefundToWalletDetail | RefundToWallet structure]]
| Name || string || The name of the purchased item.
|-
|-
| RejectedWithdraw || [[RejectedWithdrawDetail | RejectedWithdraw structure]]
| Description || string || Description about the item.
|-
|-
| RejectedWithdrawFee || [[RejectedWithdrawFeeDetail | RejectedWithdrawFee structure]]
| Quantity || decimal|| The quantity of the purchased items.
|-
|-
| ReleaseAmount || [[ReleaseAmountDetail | ReleaseAmount structure]]
| Unit || decimal|| The unit is the standard measure of the quantity.
|-
|-
| UnsuccessfulRefundToBankAccount || [[UnsuccessfulRefundToBankAccountDetail | UnsuccessfulRefundToBankAccount structure]]
| UnitPrice || decimal|| The unit price shows the price of the smallest unit.
|-
|-
| UnsuccessfulRefundToCard || [[UnsuccessfulRefundToCardDetail | UnsuccessfulRefundToCard structure]]
| ItemTotal || decimal|| The sum of the unit price for the units.
|-
| SKU || string || A SKU is a unique code consisting of letters and numbers that identify the characteristics of each product.
|-
|}
 
=== Marketplace ===
 
{{api_output_table_header}}
|-
| Name || string || The name of the marketplace.
|-
| PublicKey || Guid|| The public key of the marketplace.
|-
|}
 
=== Bank account information ===
 
{{api_output_table_header}}
|-
| BankAccountNumber|| string || The bank account number. It contains the full bank account number without formatting.
|-
| BankAccountOwner || string || The owner of the bank account.
|}
 
=== Card information ===
 
{{api_output_table_header}}
|-
|-
| UnsuccessfulTransfer || [[UnsuccessfulTransferDetail | UnsuccessfulTransfer structure]]
| CardBin || string || The first 6 digits of the bank card number.
|-
|-
| UnsuccessfulWithdraw || [[UnsuccessfulWithdrawDetail | UnsuccessfulWithdraw structure]]
| CardMaskedPan || string || The last 4 digits of the bank card number.
|-
|-
| WireTopUp || [[WireTopUpDetail | WireTopUp structure]]
| Type || [[CardType | CardType]] || The type of bank card.
|-
|-
| Withdraw || [[WithdrawDetail | Withdraw structure]]
| CardSource || [[CardSource | CardSource]] || The source of the bank card.
|-
|-
| WithdrawFee || [[WithdrawFeeDetail  | WithdrawFee  structure]]
| ValidThru  || DateTime || The expiry of the payment card.
|-
|-
| CardHolderName || string || The name written on the card.
|}
|}

Latest revision as of 10:52, 11 July 2023

Barion API: transaction history details

GET /v3/TransactionHistory/GetDetail

The /v3/TransactionHistory/GetDetail API endpoint is used to query the details of the specified transaction history element.

Prerequisites before use:


Authentication

Barion Wallet Authentication


Input properties

The input properties should be defined in the query string.

Property name Property type Limitations and constraints Description
ItemId Guid
  • Required
The identifier of the history element.


Output properties

Property name Property type Description
DetailInformation custom structure The data structure depends on the history item type. The structures are linked below.


History item structures:

History item type Link to the structure
BankTransferPayment BankTransferPayment structure
BankTransferPaymentFee BankTransferPaymentFee structure
BarionBalanceProcessingFee BarionBalanceProcessingFee structure
BlockAmount BlockAmount structure
CardPayment CardPayment structure
CardProcessingFee CardProcessingFee structure
CardTopUp CardTopUp structure
CashTopUp CashTopUp structure
Comission Comission structure
Donation Donation structure
ElectronicMoneyPayment ElectronicMoneyPayment structure
ExternalTransfer ExternalTransfer structure
GatewayFee GatewayFee structure
InternalTransfer InternalTransfer structure
IssueFromCustody IssueFromCustody structure
PayeeTransaction PayeeTransaction structure
RefundToBankAccount RefundToBankAccount structure
RefundToCard RefundToCard structure
RefundToWallet RefundToWallet structure
RejectedWithdraw RejectedWithdraw structure
RejectedWithdrawFee RejectedWithdrawFee structure
ReleaseAmount ReleaseAmount structure
UnsuccessfulRefundToBankAccount UnsuccessfulRefundToBankAccount structure
UnsuccessfulRefundToCard UnsuccessfulRefundToCard structure
UnsuccessfulTransfer UnsuccessfulTransfer structure
UnsuccessfulWithdraw UnsuccessfulWithdraw structure
WireTopUp WireTopUp structure
Withdraw Withdraw structure
WithdrawFee WithdrawFee structure

Custom structures

BankTransferPayment

Customers can pay by wire transfer to the facilitator or the e-shop.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
PaymentId Guid The identifier of the payment transaction.
PurchasedItems PurchasedItem The list of the purchased items.
MarketPlace MarketPlace The details of the marketplace where the transaction happened.

BankTransferPaymentFee

Bank transfer payment fee is paid by the facilitator or e-shop to the Barion after the successful payments if the customer paid by wire transfer.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
PaymentId Guid The identifier of the payment transaction.
PurchasedItems PurchasedItem The list of the purchased items.
MarketPlace MarketPlace The details of the marketplace where the transaction happened.

BarionBalanceProcessingFee

Barion balance processing fee is paid by the facilitator or e-shop to the Barion after the successful payments. This fee type is used when the payer paid with their Barion balance and the shop has been configured to pay this fee.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
PaymentId Guid The identifier of the payment transaction.

BlockAmount

Due to a compliance decision, the Barion can block the amount of the transaction.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
CardUsed Card The details of the payment card used for the payment transaction.
BlockedAmount decimal The amount that was blocked by Barion.

CardPayment

Card payment is used when a customer pays with his bank card to the e-shop.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
PaymentId Guid The identifier of the payment transaction.
PurchasedItems PurchasedItem The list of the purchased items.
MarketPlace MarketPlace The details of the marketplace where the transaction happened.
CardUsed Card The details of the payment card used for the payment transaction.
FraudScore decimal Indicating whether the transaction that this history item is representing has a chance to be a fraud.
TopUpAuthorizationCode string The authorization code received by the card processing system when executing the payment.

CardProcessingFee

Card processing fee is paid by the facilitator or e-shop to the Barion after the successful payments.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
PaymentId Guid The identifier of the payment transaction.

CardTopUp

Wallet top up with bank card.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
CardUsed Card The details of the payment card used for the payment transaction.
FraudScore decimal Indicating whether the transaction that this history item is representing has a chance to be a fraud.
TopUpAuthorizationCode string The authorization code received by the card processing system when executing the payment.
AmountCharged decimal The amount that was charged from the bank card and credited to the user's wallet.
Fee decimal The fee was paid by the user to the Barion.

CashTopUp

Users can top up their wallets with cash in some banks in Hungary.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
Fee decimal The fee was paid by the user to the Barion.
TopUpComment string The comment of the wire transfer.

Comission

Commission paid by the user to the Barion after a successful transaction. Most of the transactions are free. See the pricing list for more details.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.

Donation

[Deprecated]


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.

ElectronicMoneyPayment

Electronic money payment is used when a customer pays by his wallet to the e-shop.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
PaymentId Guid The identifier of the payment transaction.
PurchasedItems PurchasedItem The list of the purchased items.
MarketPlace MarketPlace The details of the marketplace where the transaction happened.

ExternalTransfer

External transfers are used to transfer money to a non-existing user. The recipient has a specific time to claim the transaction amount.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
WasClaimed bool True if the recipient claimed the transaction amount. Otherwise, false.
ResolvedAt DateTime The exact time when the recipient claimed the transaction amount.

GatewayFee

Gateway fee is paid by the facilitator or e-shop to the Barion after the successful payments.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
PaymentId Guid The identifier of the payment transaction.

InternalTransfer

Internal transfers are used to transfer money between wallets.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.

IssueFromCustody

Custody is used for unrecognized incoming wire transfers. When an unrecognized transfer is proved by the user, the Barion transfers the transaction amount to the user's wallet.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.

PayeeTransaction

Payee transactions are included in a payment transaction. These are e-money sub-transactions that are executed after the payment was fully completed. Payee transactions can be used to transfer royalties, agent fees or such to a third party, or to distribute the amount paid by the payer to multiple Barion wallets.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
PaymentId Guid The identifier of the payment transaction.

RefundToBankAccount

Refund from the e-shop's wallet to the customer's bank account.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
OriginalPaymentId Guid The identifier of the payment transaction.

RefundToCard

Refund from the e-shop's wallet to the customer's bank card.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
OriginalPaymentId Guid The identifier of the payment transaction.
ToCard Card The details of the payment card used for the payment transaction.

RefundToWallet

Refund from the e-shop's wallet to the customer's wallet.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
PaymentId Guid The identifier of the payment transaction.

RejectedWithdraw

The wire transfer was unsuccessful. In this case, Barion returns the wire transfer amount to the user's wallet.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.

RejectedWithdrawFee

The wire transfer was unsuccessful. In this case, Barion returns the wire transfer fee to the user's wallet.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.

ReleaseAmount

The previously blocked amount is credited to the user's wallet.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
CardUsed Card The details of the payment card used for the payment transaction.
ReleasedAmount decimal The amount that was released by Barion.

UnsuccessfulRefundToBankAccount

It is an unsuccessful refund to a bank account, the amount is credited to the wallet.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
OriginalPaymentId Guid The identifier of the payment transaction.

UnsuccessfulRefundToCard

Unsuccessful refund to the source bank card, the amount is credited to the wallet.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
OriginalPaymentId Guid The identifier of the payment transaction.
ToCard Card The details of the payment card used for the payment transaction.

UnsuccessfulTransfer

Unsuccessful e-money transfer to a non-existent user. The recipient did not claim the amount, so it was credited to the source wallet.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.

UnsuccessfulWithdraw

Unsuccessful wire transfers from the wallet to the outside of the system. The amount of the transaction is credited to the user's balance.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.

WireTopUp

Wallet top-up transactions that are completed via wire transfer.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
FromAccount BankAccountInformation The details of the source bank account.
WireComment string The comment of the wire transfer.

Withdraw

Wire transfers from the wallet to the outside of the system.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.
ToAccount BankAccountInformation The details of the destination bank account.
Comment string The comment of the wire transfer.
Fee decimal The fee was paid by the user to the Barion.

WithdrawFee

The fee that is paid by the user to Barion after wire transfers outside of the system.


Property name Property type Description
HistoryId Guid The identifier of the transaction.
HistoryType HistoryItemType The type of the transaction.
HappenedAtUtc DateTime The exact time when the transaction happened.
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.

Common structures

The structures listed here can be referenced by the detailers.

Purchased item

Property name Property type Description
Name string The name of the purchased item.
Description string Description about the item.
Quantity decimal The quantity of the purchased items.
Unit decimal The unit is the standard measure of the quantity.
UnitPrice decimal The unit price shows the price of the smallest unit.
ItemTotal decimal The sum of the unit price for the units.
SKU string A SKU is a unique code consisting of letters and numbers that identify the characteristics of each product.

Marketplace

Property name Property type Description
Name string The name of the marketplace.
PublicKey Guid The public key of the marketplace.

Bank account information

Property name Property type Description
BankAccountNumber string The bank account number. It contains the full bank account number without formatting.
BankAccountOwner string The owner of the bank account.

Card information

Property name Property type Description
CardBin string The first 6 digits of the bank card number.
CardMaskedPan string The last 4 digits of the bank card number.
Type CardType The type of bank card.
CardSource CardSource The source of the bank card.
ValidThru DateTime The expiry of the payment card.
CardHolderName string The name written on the card.