Ext WMKeeper

The Keeper Embedded service is a set of web methods enabling financial interaction between the members of a social network.

The service allows members of a social network to create virtual purses in different currencies, associate existing WebMoney purses with their accounts, transfer funds and generate invoices to other members of the social network, recharge their mobile phone accounts and do a lot more.

Each social network supporting Keeper Embedded has its own number (SNID) that must be passed as a parameter to all methods of the service. Each network also has a unique secret key that is used for generating a (hash) signature that is also passed as a parameter to all methods of the service. The system uses the SHA1 algorithm for signature generation.

The methods sendFunds, issueInvoice, issueInvoiceToWMID, payInvoice, rejectInvoice, topUpByCard, topUpPhoneall accept the RequestN parameter. This is a 64-bit integer that must be unique for each social network - that is, for each SNID

where SNID - social network ID, USID - member's ID, ReturnUrl - the URL the member should be forwarded to after the purse is connected (this is also the page where the following parameters will be passed to: USID (matching the original value), err (containing a request processing error code), hash (containing a hash value of a string in the following form: USID+err+SecretKey)), hash - a hash (SHA1) value of a string in the following form: SNID+USID+ReturnUrl+SecretKey. All URL's containing parameters must be unencoded.Once the purse has been connected, the member must activate their account using the activation code sent to their WM Keeper. Activation is performed using the activatePurse method (see #21) or by following the link sent to the member's WM Keeper.

3. Removing a purse (removal of an existing (not connected) purse is only possible if the current purse balance is zero).

Passed parameters: SNID - social network ID, RequestN - request number (must be unique), USID - member's ID, PhoneNumber - phone number in the 9161231212 format, Amount - amount to be transferred, Purse - the type of the purse the funds will be withdrawn from, hash - hash (SHA1) value of a string in the following form: SNID+RequestN+USID+PhoneNumber+Amount+Purse+SecretKey, where Amount is written in the '#0.00' format.

Returned parameters: errordesc - error description.

Returned value: error code or 0 if there is no error.

14. Getting the history of a member's transactions for a period of time

Passed parameters: SNID - social network ID, USID - member's ID, dateStart - start of the period, dateFinish - end of the period, hash - hash (SHA1) value of a string in the following form: SNID+USID+dateStart+dateFinish+SecretKey, where dateStart and dateFinish are specified in the 'yyyy/MM/dd HH:mm:ss' format

Passed parameters: SNID - social network ID, USID - member's ID, dateStart - start of the period, dateFinish - end of the period, hash - hash (SHA1) value of a string in the following form: SNID+USID+dateStart+dateFinish+SecretKey, where dateStart and dateFinish are specified in the 'yyyy/MM/dd HH:mm:ss' format

Passed parameters: SNID - social network ID, destUSID - member's ID, dateStart - start of the period, dateFinish - end of the period, hash - hash (SHA1) value of a string in the following form: SNID+USID+dateStart+dateFinish+SecretKey, where dateStart and dateFinish are specified in the 'yyyy/MM/dd HH:mm:ss' format

Passed parameters: SNID - social network ID, USID - member's ID, dateStart - start of the period , dateFinish - end of the period, hash - hash (SHA1) value of a string in the following form: SNID+USID+dateStart+dateFinish+SecretKey, where dateStart and dateFinish are specified in the 'yyyy/MM/dd HH:mm:ss' format.

Passed parameters: SNID - social network ID, USID - member's ID, dateStart - start of the period , dateFinish - end of the period, hash - hash (SHA1) value of a string in the following form: SNID+USID+dateStart+dateFinish+SecretKey, where dateStart and dateFinish are specified in the 'yyyy/MM/dd HH:mm:ss' format.