1. Home
  2. Corporate Node
  3. SOAP requests
  4. sendMoneyToVault

sendMoneyToVault

Operation sendMoneyToVault delegates a task of sending provided amount to vault.

In order to send money to Vault, merchant should pass amount in billons (0.1 cents) in amount field.

Sent money becomes not available for direct transfers. In order to use them, user has to get it back from Vault using getMoneyFromVault request.
After money is transferred to Vault, user should see difference in getMoneyStatus request: field freeBalance should be decreased and
vaultBalance increased by transferred amount.

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:sendMoneyToVault soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <amount xsi:type="ns1:billonAmount">
            <amount xsi:type="xsd:unsignedLong">100</amount>
            <currency xsi:type="xsd:string">PLN</currency>
            <colour xsi:type="xsd:unsignedLong">0</colour>
         </amount>
      </ns1:sendMoneyToVault>
   </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:sendMoneyToVaultResponse>
         <return xsi:type="ns1:vuiSoapTaskIdResponse">
            <requestStatus>SUCCESS</requestStatus>
            <requestStatusDescription>Request succeeded.</requestStatusDescription>
            <taskId>62JTHU21HBH1UW8EH5PT19MN78</taskId>
         </return>
      </ns1:sendMoneyToVaultResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Request parameters:

parametertypedescription
amountbillonAmountamount of money to be transferred

Response parameters:

nametypedescription
taskIdstringid of created task
requestStatusstringresult of request
requestStatusDescriptionstringstatus description
Was this article helpful to you? Yes No

How can we help?