Operation setTreasuryParameters is used to set money amount, after exceeding which money are automatically transferred to treasury.
If merchant has set treasury for WUI (see setTreasury), he can set money threashold, after exceeding which money will be automatically transferred to treasury. If money on account is greater than threshold, difference of free amount and threshold will be transferred.
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:setTreasuryParameters soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<treasuryThresholdValue xsi:type="ns1:billonAmount">
<amount xsi:type="xsd:unsignedLong">1000000</amount>
<currency xsi:type="xsd:string">PLN</currency>
<colour xsi:type="xsd:unsignedLong">0</colour>
</treasuryThresholdValue>
<mpin xsi:type="xsd:string">V189E</mpin>
</ns1:setTreasuryParameters>
</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:setTreasuryParametersResponse>
<return>
<requestStatus>SUCCESS</requestStatus>
<requestStatusDescription>Request succeeded.</requestStatusDescription>
</return>
</ns1:setTreasuryParametersResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Request parameters:
parameter | type | description |
---|---|---|
treasuryThresholdValue | billonAmount | amount of money, exceeding which causes automatic transfer to treasury |
mpin | string | number pin (long pin) of machine |
Response parameters:
name | type | description |
---|---|---|
requestStatus | string | result of request |
requestStatusDescription | string | status description |
Possible errors:
error | description |
---|---|
ERR_INVALID_AMOUNT | |
ERR_INVALID_MPIN |