TransactionHistory-GetDetail-v3: Difference between revisions
(36 intermediate revisions by the same 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]] | ||
== Authentication == | == Authentication == | ||
[[Barion Wallet Authentication]] | [[Barion Wallet Authentication]] | ||
== Input properties == | == Input properties == | ||
Line 28: | Line 32: | ||
|} | |} | ||
Line 49: | Line 52: | ||
|- | |- | ||
| BankTransferPaymentFee || [[TransactionHistory-GetDetail-v3#BankTransferPaymentFee | BankTransferPaymentFee structure]] | | BankTransferPaymentFee || [[TransactionHistory-GetDetail-v3#BankTransferPaymentFee | BankTransferPaymentFee structure]] | ||
|- | |||
| BarionBalanceProcessingFee || [[TransactionHistory-GetDetail-v3#BarionBalanceProcessingFee | BarionBalanceProcessingFee structure]] | |||
|- | |- | ||
| BlockAmount || [[TransactionHistory-GetDetail-v3#BlockAmount | BlockAmount structure]] | | BlockAmount || [[TransactionHistory-GetDetail-v3#BlockAmount | BlockAmount structure]] | ||
Line 107: | Line 112: | ||
=== BankTransferPayment === | === BankTransferPayment === | ||
Customers can pay by wire transfer to the facilitator or the e-shop. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 113: | Line 120: | ||
=== BankTransferPaymentFee === | === 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}} | {{TransactionHistoryDetail}} | ||
{{PaymentDetail}} | {{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 === | === BlockAmount === | ||
Due to a compliance decision, the Barion can block the amount of the transaction. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 129: | Line 149: | ||
=== CardPayment === | === CardPayment === | ||
Card payment is used when a customer pays with his bank card to the e-shop. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 141: | Line 163: | ||
=== CardProcessingFee === | === CardProcessingFee === | ||
Card processing fee is paid by the facilitator or e-shop to the Barion after the successful payments. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 148: | Line 172: | ||
=== CardTopUp === | === CardTopUp === | ||
Wallet top up with bank card. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 163: | Line 189: | ||
=== CashTopUp === | === CashTopUp === | ||
Users can top up their wallets with cash in some banks in Hungary. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 172: | Line 200: | ||
=== Comission === | === 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}} | {{TransactionHistoryDetail}} | ||
Line 178: | Line 208: | ||
=== Donation === | === Donation === | ||
[Deprecated] | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 184: | Line 216: | ||
=== ElectronicMoneyPayment === | === ElectronicMoneyPayment === | ||
Electronic money payment is used when a customer pays by his wallet to the e-shop. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 191: | Line 225: | ||
=== ExternalTransfer === | === 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}} | {{TransactionHistoryDetail}} | ||
Line 200: | Line 236: | ||
=== GatewayFee === | === GatewayFee === | ||
Gateway fee is paid by the facilitator or e-shop to the Barion after the successful payments. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 207: | Line 245: | ||
=== InternalTransfer === | === InternalTransfer === | ||
Internal transfers are used to transfer money between wallets. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 213: | Line 253: | ||
=== IssueFromCustody === | === 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}} | {{TransactionHistoryDetail}} | ||
Line 219: | Line 261: | ||
=== PayeeTransaction === | === 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}} | {{TransactionHistoryDetail}} | ||
Line 226: | Line 270: | ||
=== RefundToBankAccount === | === RefundToBankAccount === | ||
Refund from the e-shop's wallet to the customer's bank account. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 233: | Line 279: | ||
=== RefundToCard === | === RefundToCard === | ||
Refund from the e-shop's wallet to the customer's bank card. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 242: | Line 290: | ||
=== RefundToWallet === | === RefundToWallet === | ||
Refund from the e-shop's wallet to the customer's wallet. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 249: | Line 299: | ||
=== RejectedWithdraw === | === RejectedWithdraw === | ||
The wire transfer was unsuccessful. In this case, Barion returns the wire transfer amount to the user's wallet. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 255: | Line 308: | ||
=== RejectedWithdrawFee === | === RejectedWithdrawFee === | ||
The wire transfer was unsuccessful. In this case, Barion returns the wire transfer fee to the user's wallet. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 261: | Line 316: | ||
=== ReleaseAmount === | === ReleaseAmount === | ||
The previously blocked amount is credited to the user's wallet. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 270: | Line 327: | ||
=== UnsuccessfulRefundToBankAccount === | === UnsuccessfulRefundToBankAccount === | ||
It is an unsuccessful refund to a bank account, the amount is credited to the wallet. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 277: | Line 336: | ||
=== UnsuccessfulRefundToCard === | === UnsuccessfulRefundToCard === | ||
Unsuccessful refund to the source bank card, the amount is credited to the wallet. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 286: | Line 347: | ||
=== UnsuccessfulTransfer === | === 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}} | {{TransactionHistoryDetail}} | ||
Line 292: | Line 355: | ||
=== UnsuccessfulWithdraw === | === 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}} | {{TransactionHistoryDetail}} | ||
Line 298: | Line 363: | ||
=== WireTopUp === | === WireTopUp === | ||
Wallet top-up transactions that are completed via wire transfer. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 307: | Line 374: | ||
=== Withdraw === | === Withdraw === | ||
Wire transfers from the wallet to the outside of the system. | |||
{{TransactionHistoryDetail}} | {{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 === | === WithdrawFee === | ||
The fee that is paid by the user to Barion after wire transfers outside of the system. | |||
{{TransactionHistoryDetail}} | {{TransactionHistoryDetail}} | ||
Line 319: | Line 395: | ||
== Common structures == | == Common structures == | ||
The structures listed here can be referenced by the detailers. | |||
=== Purchased item === | === Purchased item === |
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
Input properties
The input properties should be defined in the query string.
Property name | Property type | Limitations and constraints | Description |
---|---|---|---|
ItemId | Guid |
|
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:
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. |