Operation setTreasury sets name of merchant treasury.
With this operation merchant can choose his treasury – user who will receive money when it exceeds selected threshold or sendMoneyToTreasuryRequest message is sent. Threshold can be enabled and set using setTreasuryParameters request.
Attention: money cannot be transferred back automatically. In such case merchant has to ask the trusted user (treasury) to send it back.
Example SOAP request:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="ns1">
<soapenv:Header/>
<soapenv:Body>
<ns1:setTreasury soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<treasuryName xsi:type="xsd:string">my_treasury</treasuryName>
<password xsi:type="xsd:string">passwd</password>
</ns1:setTreasury>
</soapenv:Body>
</soapenv:Envelope>
Example SOAP response:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:ns1="ns1">
<SOAP-ENV:Header/>
<SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<ns1:setTreasuryResponse>
<return>
<requestStatus>SUCCESS</requestStatus>
<requestStatusDescription>Request succeeded.</requestStatusDescription>
</return>
</ns1:setTreasuryResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Request parameters:
| parameter | type | description |
|---|---|---|
| treasuryName | string | name of treasury (trusted user) |
| password | string | password of logged user |
Response parameters:
| name | type | description |
|---|---|---|
| requestStatus | string | result of request |
| requestStatusDescription | string | status description |
Possible errors:
| error | description |
|---|---|
| ERR_INVALID_USERNAME | |
| ERR_INVALID_PASSWORD |