Operacja expectPaymentRequest zleca węzłowi CNode zaakceptowanie następnej płatności, która zostanie mu zlecona od podanego użytkownika na podaną kwotę.
Normalnie wszystkie węzły CNode (działające na kolonii produkcyjnej) automatycznie odrzucają wszelkie transfery od innych użytkowników, ta operacja pozwala na dokonanie takiego transferu. Zwraca ona identyfikator transferu, który należy podać zlecając transfer, aby węzeł CNode wiedział, że należy go przyjąć.
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:expectPaymentRequest> <username>username1</username> <amount> <amount>1000</amount> <currency>PLN</currency> <colour>0</colour> </amount> <timeout>600</timeout> </ns:expectPaymentRequest> </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:expectPaymentRequestResponse> <return> <requestPaymentIdConfirmation>X60M88LSSU1714GB9E32GB1P14</requestPaymentIdConfirmation> <requestStatus>SUCCESS</requestStatus> <requestStatusDescription>Request succeeded.</requestStatusDescription> </return> </ns:expectPaymentRequestResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
Parametry zapytania:
Parametr | Typ | Opis | Wymagane? | ||
username | string |
| Tak | ||
amount | billonAmount | Kwota transferu | Tak | ||
timeout | unsignedInt | Czas, przez jaki węzeł CNode ma się spodziewać żądania | Tak |
Parametry odpowiedzi:
Nazwa | Typ | Opis |
requestPaymentIdConfirmation | string | Identyfikator. który należy podać podczas zlecania transferu |
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 |