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

operationhandle

48-48

No

No

2

UserToCredit

English (United States)

E-mail address of user to receive the balance transfer

email

7-128

Yes

No

3

Amount

English (United States)

Amount (in VersaCoin cents) to be transferred

versacoin

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

operationhandle

48-48

No

No

2

UserToCredit

Español (moderno)

Dirección de correo electrónico del usuario que recibirá la transferencia de créditos

email

7-128

Yes

No

3

Amount

Español (moderno)

Monto (en centavos de VersaCoins) a ser transferido

versacoin

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

operationhandle

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

email

7-128

Yes

No

3

Amount

Português (Brasil)

Montante (em centavos de VersaCoins) a ser transferido

versacoin

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