MOR API user balance update
From Kolmisoft Wiki
Revision as of 11:06, 10 January 2012 by Mindaugas (talk | contribs) (moved Change user balance to MOR API Change User Balance)
This functionality is available from MOR 10
Login and change user balance.
- Call: /api/user_balance_change
- Methods: POST, GET(if allowed, not recomended)
- Params:
- user_id - Users ID in MOR database, whose balance we want to change. Required.
- u - username to login. Required.
- p - password to login. Required.
- balance - new user balance. Required.
- hash - SHA1 hash constructed using user_id, balance and API_Secret_Key ( More described in Constructing hash). Required.
- Returns:
- Errors:
- <error>User was not found</error> - User was not found using user_id. Use correct user_id.
- <error>Incorrect hash</error> - Hash was not correct. Check API_Secret_Key and order or params while concatenating hash_string.
- <error>Bad login</error> - User not loged in the system. Check username and password.
- <error>User balance not updated</error> - Params balance is not correct or user is not saved. Check balance param.
- Errors:
Additional notes
- If the balance is changed during the call, price for the call will be deducted from new balance, because balance is deducted at the end of call.
- Example:
- We have user_id = 123, API Secret Key = 456789, balance = 100
- Hash string to be converted: "123100456789"
- We send:
- /api/user_balance_change?u=admin&p=admin&user_id=123&balance=100&hash=b1bef44691c237b574263e09b2838ad1e658e507
* Note that username and password are not included in hash