Revision as of 07:21, 24 August 2018

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.

Property name	Property type	Limitations and constraints	Description
UserName	string	Required	Your e-mail address in the Barion system.
Password	string	Required	Your password in the Barion system.
Currency	string	Required	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	Required	The name of the recipient of the bank transfer.
Comment	string	Optional Maximum length: 90 characters	The comment of the bank transfer.
BankAccount	BankAccount	Required	Information about the recipient's bank account.

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.

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.

Currency	Target country	Amount limitation
HUF	Anywhere	No limitation
EUR	Anywhere	No limitation
USD	Anywhere	No limitation
CZK	Czechia	, }, ~, §, SPACE
CZK	Abroad	Allowed characters: a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, /, -, ?, :, (, ), ., ,, ', +, SPACE

@@ Line 119: / Line 119: @@
 |}
-== Bank transfer amount limitation  ==
+== Bank transfer amount limitations  ==
 {| class="wikitable api-table"
@@ Line 133: / Line 133: @@
 |-
 | CZK || Abroad || Minimum 100 CZK
+|-
+|}
+== Bank transfer charachter limitations  ==
+{| class="wikitable api-table"
+! Currency || Target country || Amount limitation
+|-
+| HUF || Anywhere || No limitation
+|-
+| EUR || Anywhere || No limitation
+|-
+| USD || Anywhere || No limitation
+|-
+| CZK || Czechia || Allowed characters: a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, á, ä, č, ď, é, ě, í, ľ, ň, ó, ô, ö, ř, ŕ, š, ť, ú, ů, ü, ý, ž, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, Á, Ä, Č, Ď, É, Ě, Í, Ľ, Ň, Ó, Ô, Ö, Ř, Ŕ, Š, Ť, Ú, Ů, Ü, Ý, Ž, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, /, -, ?, :, (, ), ., ,, ', +, !, ", #, $, %, &, *, ;, <, =, >, @, [, ], ^, `, {, |, }, ~, §, SPACE
+|-
+| CZK || Abroad || Allowed characters: a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, /, -, ?, :, (, ), ., ,, ', +, SPACE
 |-
 |}