Barion API: send money to an e-mail address
The /transfer/email API endpoint is used to send money to another Barion Wallet.
Prerequisites before use:
v2 This API endpoint is available in API v2 only.
Authentication
Barion Wallet Authentication
Input properties
| Property name
|
Property type
|
Limitations and constraints
|
Description
|
| SourceAccountId |
GUID |
- Required
- Must be an account of the authenticating user, in the same currency as the transfer itself
|
The identifier of the Barion wallet. This can be determined using the Accounts-Get-v2 API endpoint.
|
| Amount |
Money |
- Required
- Must be greater than zero
|
The total amount to transfer.
|
| TargetEmail |
string |
|
The e-mail address of the recipient of the transfer. If they are an active Barion user, they receive the money instantly. If the e-mail address is not registered in Barion, they must register in 7 days in order to claim the money. If the money is not claimed, it gets transferred back to the sender.
|
| Comment |
string |
- Optional
- Maximum length: 1000 characters
|
The comment of the money transfer.
|
Output properties
| Property name
|
Property type
|
Description
|
| IsTransferSuccessful |
bool |
Indicates wether the e-money transfer was successfuly finished.
|
Possible error responses
| Error code |
Description
|
| UserDoesNotHaveAccountInRequiredCurrency |
The caller wallet does not have an account in the specified currency.
|
| ModelValidationError |
One or more fields contain an invalid value. See the error description for details.
|
| InvalidAccount |
The specified account does not exists.
|
| UserIsSuspended |
The user is suspended and cannot send money.
|
| PayerDoesNotHaveEnoughMoney |
The user doesn't have enough available balance to complete the transaction.
|
| ExceedsBalanceLimit |
The transaction exceeds the user's limit.
|
| TransferToEmailFailed |
The money transfer failed due to a system error.
|
| SourceAccountDeleted |
The sender account was deleted.
|
| TargetAccountDeleted |
The target account was deleted.
|