Barion API: Initiate a bank transfer
| POST
|
/v2/Withdraw/BankTransfer
|
The /withdraw/banktransfer API endpoint is used to send money out of the Barion system via bank (wire) transfer.
Prerequisites before use:
v2 This API endpoint is available in API v2 only.
Input properties
| Property name
|
Property type
|
Limitations and constraints
|
Description
|
| UserName |
string |
|
Your e-mail address in the Barion system.
|
| Password |
string |
|
Your password in the Barion system.
|
| Currency |
string |
|
The currency of the bank transfer.
Note: Barion does not do currency rate conversion. The caller must have an active account with the selected currency, and must ensure that the target bank accepts the selected currency.
|
| Amount |
decimal |
- Required
- Must be greater than zero
|
The total amount to withdraw, excluding fees.
|
| RecipientName |
string |
|
The name of the recipient of the bank transfer.
|
| Comment |
string |
- Optional
- Maximum length: 90 characters
|
The comment of the bank transfer.
|
| BankAccount |
BankAccount |
|
Information about the recipient's bank account.
|
Output properties
| Property name
|
Property type
|
Description
|
| TransactionId |
Guid |
The unique identifier of the bank transfer, generated by the Barion system.
|
| Currency |
string |
The currency of the bank transfer.
|
| Amount |
decimal |
The total amount transferred.
|
| RecipientName |
string |
The name of the recipient of the transfer.
|
| Comment |
string |
The comment of the bank transfer
|
| BankAccount |
BankAccount |
The bank account data.
|
Possible error responses
| Error code |
Description
|
| ModelValidationError |
This happens when some of the input properties fail the basic validation. For example a string property exceeds its allowed length.
|
| AuthenticationFailed |
The provided UserName or Password are not correct.
|
| MinimumWithdrawAmountNotReached |
The amount specified does not reach the minimum bank transfer amount. This is not in production yet
|
| InvalidCharacter |
One of the characters is invalid for the bank transfer process
|
| InvalidAccount |
There is no account belonging to the user with the specified currency.
|
| InappropriateVerificationLevel |
The user does not have the verification level to be able to transfer.
|
| InvalidCurrency |
The system does not support the specified currency
|
| InvalidCountry |
The Country specified in the BankAccount field is invalid.
|
Bank transfer amount limitation
| Currency |
Target country |
Amount limitation
|
| HUF |
Anywhere |
No limitation
|
| EUR |
Anywhere |
No limitation
|
| USD |
Anywhere |
No limitation
|
| CZK |
Czechia |
No limitation
|
| CZK |
Abroad |
Minimum 100 CZK
|