Operacja changeMoney pozwala rozmień pieniądze u użytkownika whoCanChange (lub w systemie jeśli pusty) tak żeby mógł uzbierać amountToAchieve.
Przykładowe zapytanie SOAP:
<?xml version="1.0" encoding="UTF-8"?> <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:ns="ns1"> <SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> <ns:changeMoney> <amountToAchieve> <amount>1000</amount> <currency>PLN</currency> <colour>0</colour> </amountToAchieve> <whoCanChange>username</whoCanChange> </ns:changeMoney> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
Przykładowa odpowiedź SOAP:
<?xml version="1.0" encoding="UTF-8"?> <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:ns="ns1"> <SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> <ns:changeMoneyResponse> <return> <taskId>0B3LCA6254A12E5GEB0MF4F6LH</taskId> <requestStatus>SUCCESS</requestStatus> <requestStatusDescription>Request succeeded.</requestStatusDescription> </return> </ns:changeMoneyResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
Parametry zapytania:
Parametr | Typ | Opis | Wymagane? | Specyfikacja |
amountToChange | billonAmount | Kwota, która ma zostać rozmieniona | Tak | Kwota musi być większa od zera |
whoCanChange | string | Użytkownik, u którego ma zostać dokonana rozmiana | Nie | Musi być poprawną nazwą użytkownika |
Parametry odpowiedzi:
Nazwa | Typ | Opis |
taskId | string | id powstałego taska |
requestStatusDescription | string | opis statusu |
requestStatus | string | status wykonania zapytania |
Możliwe błędy:
Błąd | Opis |
ERR_INVALID_AMOUNT | nieprawidłowa kwota |
ERR_INVALID_CURRENCY | nieprawidłowa waluta |
ERR_INVALID_MONEY_COLOUR | niepoprawny/nieobsługiwany kolor pieniędzy |
ERR_INVALID_USERNAME | niepoprawna nazwa użytkownika |
Przykładowy JSON additionalInfo w odpowiedzi na getTaskStatus:
{ "amount": 5000, "actual_amount": 0, "restart_amount": 0 }