Operacja startRegister rozpoczyna rejestrację nowego użytkownika.
Przykładowe zapytanie SOAP:
<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:startRegister soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<billonUserName xsi:type="xsd:string">login</billonUserName>
<billonUserPassword xsi:type="xsd:string">haslo</billonUserPassword>
<userIPEchoice xsi:type="xsd:string">PLUS_BANK_PRODUCTION</userIPEchoice>
<userARchoice xsi:type="xsd:string">PLUS_BANK_PRODUCTION</userARchoice>
<recoveryEmail1 xsi:type="xsd:string">recovery_mail@billon.info</recoveryEmail1>
<recoveryEmail2 xsi:type="xsd:string">recovery_mail@billon.info</recoveryEmail2>
</ns1:startRegister>
</soapenv:Body>
</soapenv:Envelope>
Przykładowa odpowiedź SOAP:
<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:startRegisterResponse>
<return xsi:type="ns1:vuiSoapTaskIdResponse">
<requestStatus>SUCCESS</requestStatus>
<requestStatusDescription>Request succeeded.</requestStatusDescription>
<taskId>7W3A0N1N9I2E8N1TKLS56A9PTR</taskId>
</return>
</ns1:startRegisterResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Parametry zapytania:
| parametr | typ | opis |
|---|---|---|
| userIPEchoice | string | wybrany IPE (wydawca cyfrowej gotówki „PLUS_BANK_PRODUCTION”) |
| merchantData | merchantData | dane merchanta (jeśli chcemy nadać użytkownikowi status merchanta). Jeśli chcemy zarejestrować normalnego użytkownika, należy to pole pozostawić puste |
| userARchoice | string | wybrany AR (agent rozliczeniowy „PLUS_BANK_PRODUCTION”) |
| billonUserPassword | string | hasło użytkownika, musi mieć >= 4 znaki |
| billonUserName | string | nazwa użytkownika, który ma zostać zarejestrowany, musi mieć >= 4 znaki |
| recoveryEmail | string | adres e-mail do odzyskiwania hasła |
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_USERNAME_ALREADY_EXISTS | |
| ERR_INVALID_IPE_SPECIFIED | |
| ERR_INVALID_AR_SPECIFIED | |
| ERR_INVALID_USERNAME | |
| ERR_INVALID_PASSWORD | |
| ERR_NO_PERMISSION | |
| ERR_USER_LOGGED_IN | |
| ERR_VUI_LOGGING_IN_OR_REGISTERING | |
| ERR_REGISTERING |