Aktywacja i stan
Aktywacja łączy fizyczny terminal POS z jego profilem integracji OpenApp. Merchant generuje krótkotrwały PIN w panelu merchanta, a operator POS wpisuje identyfikator podatkowy merchanta i PIN w POS. Po zweryfikowaniu PIN-u przez OpenApp POS otrzymuje poświadczenia do kolejnych wywołań POS -> OpenApp oraz, jeśli skonfigurowano dostarczanie przez kolejkę, poświadczenia kolejki do odbierania komend inicjowanych przez OpenApp.
Samo wywołanie aktywacji jest operacją bootstrap i nie używa podpisu HMAC, ponieważ poświadczenia POS jeszcze nie istnieją. Zobacz Autoryzacja.
Po aktywacji POS raportuje stan do OpenApp przy aktywacji oraz w regularnych interwałach heartbeat. Jeśli OpenApp nie otrzyma sprawdzeń stanu w czasie skonfigurowanym w profilu integracji, OpenApp przestaje wysyłać komendy zamówień obsługiwane przez POS i informuje klientów, że lokalizacja jest obecnie niedostępna.
Ten diagram jest logiczny. Pomija szczegóły trybu dostarczania; model dostarczania opisuje Architektura.
Typy wiadomości:
| Typ wiadomości | Kierunek | Cel |
|---|---|---|
| ActivatePos | POS -> OpenApp | Prześlij identyfikator podatkowy merchanta i PIN, aby aktywować POS. |
| PosActivationResponse | OpenApp -> POS | Zwróć wynik aktywacji oraz, przy sukcesie, poświadczenia i konfigurację dostarczania. |
| ReportPosHealth | POS -> OpenApp | Raportuj stan POS przy aktywacji i w regularnych interwałach. |