Description
The following table displays the documentation for the 'UserBalanceTransferAllow' API in all languages currently available:
Language |
Documentation |
---|---|
English (United States) |
Requests transferring (part of) calling user's balance to another user |
Español (moderno) |
Solicita la transferencia de (parte del) saldo del usuario que efectúa la llamada para otro usuario |
Português (Brasil) |
Solicita a transferência de (parte do) saldo do usuário que efetua a chamada para outro usuário |
Parameters
The following table describes all of 'UserBalanceTransferAllow''s parameters, in every language available.
ID |
Name |
Language |
Description |
Type |
Min-Max Length |
Reentr Key Member |
Optional |
---|---|---|---|---|---|---|---|
1 |
Login |
English (United States) |
Operation handle returned from succesful call of UserLoginAllow, identifying user donating balance |
48-48 |
No |
No |
|
2 |
UserToCredit |
English (United States) |
E-mail address of user to receive the balance transfer |
7-128 |
Yes |
No |
|
3 |
Amount |
English (United States) |
Amount (in VersaCoin cents) to be transferred |
1-11 |
No |
No |
|
1 |
Login |
Español (moderno) |
Protocolo de operación obtenido de llamada exitosa a UserLoginAllow, identificando al usuario donando créditos |
48-48 |
No |
No |
|
2 |
UserToCredit |
Español (moderno) |
Dirección de correo electrónico del usuario que recibirá la transferencia de créditos |
7-128 |
Yes |
No |
|
3 |
Amount |
Español (moderno) |
Monto (en centavos de VersaCoins) a ser transferido |
1-11 |
No |
No |
|
1 |
Login |
Português (Brasil) |
Protocolo de operação retornado por chamada bem sucedida a UserLoginAllow, identificando usuário doando créditos |
48-48 |
No |
No |
|
2 |
UserToCredit |
Português (Brasil) |
Endereço de e-mail do usuário que receberá a transferência de créditos |
7-128 |
Yes |
No |
|
3 |
Amount |
Português (Brasil) |
Montante (em centavos de VersaCoins) a ser transferido |
1-11 |
No |
No |
Return Value
'UserBalanceTransferAllow' returns a value of type operationhandle (minimum length of returned values is 48 characters characters, while maximum length of returned values is 48 characters characters).
Please note that all APIs returning values of types that allow for localized values (like e.g. boolean or country) always return the standard type values.
Specific Error Codes
If an error happens during the execution of any VersaCloud call, an errorcode is returned instead of the standard return value described above.
The following table lists errorcodes returned specifically by the 'UserBalanceTransferAllow' API (generic errorcodes like wrong number of parameters or invalid values for parameters' types are not listed):
Errorcode |
Language |
Description |
---|---|---|
:@Err#Bal0000006 |
English (United States) |
No user is allowed to transfer an amount of versacoins higher than his own balance |
:@Err#Bal0000007 |
English (United States) |
No user is allowed to add any amount of versacoins to his own balance |
:@Err#Usr0000002 |
English (United States) |
Value provided as user e-mail is not registered with VersaCloud |
:@Err#Usr0000055 |
English (United States) |
User's balance consumption speed limit has been reached |
:@Err#Bal0000006 |
Español (moderno) |
Ningún usuario está autorizado a transferir um monto de versacoins superior a su proprio saldo |
:@Err#Bal0000007 |
Español (moderno) |
Ningún usuario está autorizado a adicionar cualquier monto de versacoins a su proprio saldo |
:@Err#Usr0000002 |
Español (moderno) |
Valor informado como correo electrónico de usuario no está registrado en VersaCloud |
:@Err#Usr0000055 |
Español (moderno) |
Se alcanzó el límite de velocidad de consumo del saldo del usuario |
:@Err#Bal0000006 |
Português (Brasil) |
Nenhum usuário é autorizado a transferir um montante de versacoins superior a seu próprio saldo |
:@Err#Bal0000007 |
Português (Brasil) |
Nenhum usuário é autorizado a adicionar qualquer montante de versacoins a seu próprio saldo |
:@Err#Usr0000002 |
Português (Brasil) |
Valor informado como e-mail de usuário não está registrado em VersaCloud |
:@Err#Usr0000055 |
Português (Brasil) |
Foi alcançado o limite de velocidade de consumo do saldo do usuário |
US Patent Requested