Operation setVaultParameters sets vault parameters: thresholds after exceeding which money will be automatically transferred to/from vault.
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:setVaultParameters soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<toVaultThresholdValue 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>
</toVaultThresholdValue>
<fromVaultThresholdValue xsi:type="ns1:billonAmount">
<amount xsi:type="xsd:unsignedLong">0</amount>
<currency xsi:type="xsd:string">PLN</currency>
<colour xsi:type="xsd:unsignedLong">0</colour>
</fromVaultThresholdValue>
<vaultTransferFrequencyMinutes xsi:type="xsd:unsignedInt">10</vaultTransferFrequencyMinutes>
<mpin xsi:type="xsd:string">BRRN54</mpin>
</ns1:setVaultParameters>
</soapenv:Body>
</soapenv:Envelope>
Request parameters:
parameter | type | description |
---|---|---|
toVaultThresholdValue | billonAmount | after exceeding this amount money surplus will be automatically transferred to vault |
fromVaultThresholdValue | billonAmount | when accessible money amount will be less from this value, money will be transferred from vault (currently not implemented) |
mpin | string | mpin number |
vaultTransferFrequencyMinutes | unsigned int | check every X minutes if money should be transferred to/from vault |
Response parameters:
name | type | description |
---|---|---|
requestStatus | string | result of request |
requestStatusDescription | string | status description |
Possible errors:
error | description |
---|---|
ERR_INVALID_AMOUNT | |
ERR_INVALID_MPIN | |
ERR_NOT_ENOUGH_MONEY |