Podręcznik

Wstęp

Pasek boczny po lewej zawiera odnośniki do odpowiednich sekcji:

• Nazwa użytkownika - odnośniki do profilu osobistego.
• Panel - wyświetl bieżący stan w formie wykresów i grafów.
• Aplikacje - zarządzanie aplikacją.
• Kody odblokowujące - kody odblokowujące generowane automatycznie lub pobrane przez Ciebie.
• Płatności - historia przychodzących płatności użytkowników.
• Podręcznik - obecny podręcznik użytkownika.

Panel

Możesz ustawić wspólne filtry dla wszystkich widżetów na pulpicie nawigacyjnym:

• Waluta - waluta, na którą zostaną przeliczone przychodzące i wychodzące kwoty na pulpicie nawigacyjnym.
• Okres - to okres czasu, dla którego dane są wyświetlane na wykresach i tabelach na pulpicie nawigacyjnym. Określa interwał, w którym analizowane i wyświetlane są informacje i statystyki dotyczące płatności, aplikacji i innych parametrów.

Saldo

Saldo obejmuje następujące kwoty:

• Kwota brutto - łączna kwota wszystkich płatności użytkowników za wybrany okres, pomniejszona o opłaty systemów płatności i PayToUse.
• Kwota netto - łączna kwota wszystkich płatności za wybrany okres, pomniejszona o opłaty systemów płatności i PayToUse.
• Kwota oczekująca - łączna kwota wszystkich płatności za określony okres pomniejszona o opłaty systemów płatności i PayToUse oczekujące na wypłatę na konto dewelopera. Płatność staje się dostępna do wypłaty 7 dni po dokonaniu płatności.
• Dostępna kwota - łączna kwota wszystkich płatności za cały okres pomniejszona o opłaty systemów płatności i PayToUse, dostępna do wypłaty na konto dewelopera.

Płatności

Widżet Płatności zawiera tabelę płatności pogrupowanych według aplikacji dla wybranego okresu.

Pola tabeli:

• Aplikacja - aplikacja. W tabeli wyświetlane są tylko aplikacje, dla których dokonano płatności w wybranym okresie.
• Płatności - liczba płatności.
• Kwota brutto - łączna kwota wszystkich płatności użytkowników za wybrany okres, pomniejszona o opłaty systemów płatności i PayToUse.
• Kwota netto - łączna kwota wszystkich płatności za wybrany okres, pomniejszona o opłaty systemów płatności i PayToUse.

Wykres pokazuje dynamikę wartości Kwota netto i Kwota brutto dziennie.

Nowi użytkownicy

Wykres nowych użytkowników pokazuje dwie wartości w dynamice dziennie:

• Nowi użytkownicy - liczba nowych wywołań interfejsu API. Dostępy do API są rejestrowane tylko wtedy, gdy parametr device - unikalny identyfikator urządzenia - jest przekazywany podczas wysyłania żądania do interfejsu API. Ten parametr musi być rzeczywiście unikalny dla urządzenia. (zobacz Wysyłanie żądania)
• Płatności - liczba płatności w tym samym okresie dziennie.

Konwersja

Miara konwersji odnosi się do oceny efektywności sprzedaży w przekształcaniu Nowi użytkownicy w Płatności.

Wykres pokazuje stosunek liczby Płatności do liczby Nowi użytkownicy, w procentach.

Aplikacje

Przechodząc do tej sekcji, otwiera się lista twoich aplikacji.

Lista kolumn w tabeli aplikacji:

• # - unikalny identyfikator aplikacji. Używany podczas weryfikacji kodu aplikacji lub wyświetlania formularza płatności.
• Nazwa - nazwa aplikacji. Nazwa jest wyświetlana tylko tobie w raportach i na panelu. Kliknięcie na nazwę aplikacji otwiera stronę edycji aplikacji.
• Status - aktualny status aplikacji. Może to być:
• Utworzony - Aplikacja została właśnie utworzona, nie jest jeszcze skonfigurowana.
• Wydana - aplikacja działa.
• Utworzony - data utworzenia aplikacji.
• Dodatkowe przyciski kontroli:
• Usuń - aby usunąć aplikację z listy.

Tworzenie lub edycja aplikacji

Aby akceptować płatności, musisz konsekwentnie wypełniać wszystkie niezbędne dane aplikacji i ją aktywować.

Przycisk tworzenia nowej aplikacji znajduje się na pasku tytułowym listy aplikacji.

Aplikacja

Pola dostępne podczas tworzenia aplikacji:

• Nazwa - nazwa aplikacji, którą widzisz tylko ty w raportach lub na pulpicie. Ta nazwa zostanie wyświetlona w nagłówku strony zapisanej aplikacji. Dopóki aplikacja nie zostanie zapisana, zamiast nazwy wyświetlane jest „Nowa aplikacja”. Pole jest obowiązkowe do wprowadzenia.
• Adres email kontaktowy - adres e-mail, na który będą wysyłane kopie wiadomości wysłanych do użytkowników. Ten adres jest również określony w polu „Odpowiedz do” i służy do odpowiedzi użytkownika na otrzymany e-mail z kodem. Pole jest obowiązkowe do wprowadzenia. Domyślnie pole jest wypełniane wartością z profilem dewelopera. Wartość można zmienić na inną.
• Typ aplikacji - typ aplikacji. Jeśli wybierzesz grupowy typ aplikacji, zostanie wyświetlona lista aplikacji do grupowania. W liście dostępne są tylko pojedyncze aplikacje, dla których generowane są kody odblokowujące.
• Zezwalaj na opinie o płatności - dodaje pole do formularza płatności, w którym użytkownicy mogą wprowadzić tekst. Opinia zostanie dodana do kopii e-maila dewelopera. Opinię można też zobaczyć w szczegółach płatności.

Rozpocznij pisanie lub zmianę wartości, a pojawi się przycisk Zapisz. Przycisk Zapisz umożliwia zapisanie zmian bez przechodzenia do następnej strony. Przycisk Dalej zapisuje zmiany i przechodzi do następnej strony. Zawsze można wrócić, aby dokonać późniejszych zmian.

W nagłówku strony dostępne są tylko zapisane strony aplikacji do nawigacji. Możesz kliknąć Dalej lub przejść do sekcji w nagłówku strony.

Opis

Wybierz język z listy i kliknij Dodaj.

Zostanie wyświetlona karta z zlokalizowanymi tekstami aplikacji dla wybranego języka.

Dostępne języki:

• Niemiecki
• Angielski
• Francuski
• Hiszpański
• Rosyjski
• Chiński uproszczony

Pola w opisie są używane do wyświetlania informacji na formularzu płatności i w odpowiedzi na wiadomość do użytkownika:

• Nazwa - nazwa aplikacji w wybranym języku. Wyświetla się na formularzu płatności i w e-mailu powiadomieniowym o płatności. Domyślnie, po dodaniu języka, wstawiana jest nazwa aplikacji. Możesz ustawić inną nazwę dla każdego języka. Pole wymagane.
• Opis - krótki opis aplikacji. Wyświetlany na formularzu płatności pod nazwą aplikacji. Pole opcjonalne. Możesz je pozostawić puste, jeśli nie chcesz wyświetlać żadnego opisu.
• Odpowiedź - dodatkowe informacje, które zostaną wysłane do użytkownika w e-mailu po pomyślnej płatności. Tekst odpowiedzi jest dodawany na końcu e-maila po standardowej odpowiedzi.

Aby zapisać i przejść do następnej strony, należy dodać przynajmniej jeden język.

Język wyświetlany w formularzu płatności jest automatycznie określany na podstawie preferencji użytkownika określonych w ustawieniach przeglądarki. Można także ustawić język aplikacji dla aplikacji.

Rozpocznij pisanie lub zmianę wartości, a pojawi się przycisk Zapisz. Przycisk Zapisz umożliwia zapisanie zmian bez przechodzenia do następnej strony. Przycisk Dalej zapisuje zmiany i przechodzi do następnej strony. Zawsze można wrócić, aby dokonać późniejszych zmian.

W nagłówku strony dostępne są tylko zapisane strony aplikacji do nawigacji. Możesz kliknąć Dalej lub przejść do sekcji w nagłówku strony.

Cena

Strona zawiera listę cen i pól związanych z płatnościami:

• Okres próbny - długość okresu próbnego.
• Jednostka czasu - jednostka czasu okresu próbnego. Na przykład, jeśli określisz 7 dni, oznacza to, że po 7 dniach od pierwszego wywołania interfejsu API aplikacji, zostanie zwrócona odpowiedź, że okres próbny minął. Czas pierwszego wywołania urządzenia jest zapisywany.
• Metoda obliczania ceny - Metoda obliczania ceny z listy:
• Obliczanie ceny w zależności od okresu - W formularzu płatności użytkownik określa okres aktywacji kodu, a cena jest automatycznie obliczana zgodnie z tabelą poniżej. Użytkownik otrzymuje automatycznie wygenerowany kod odblokowujący w wiadomości e-mail z odpowiedzią.
• Obliczanie okresu w zależności od ceny - W formularzu płatności użytkownik wybiera cenę z listy lub wprowadza swoją własną wartość ceny, a okres jest automatycznie obliczany zgodnie z tabelą poniżej. Użytkownik otrzymuje automatycznie wygenerowany kod w wiadomości odpowiedzi.
• Stały kod - W formularzu płatności użytkownik wybiera cenę z listy lub wprowadza swoją własną wartość ceny. Po dokonaniu płatności otrzymują kod z listy poniżej, odpowiadający wybranej cenie, w wiadomości e-mail z odpowiedzią.
• Darowizna - W formularzu płatności użytkownik wybiera cenę z listy lub wprowadza swoją własną wartość ceny. Dla aplikacji typu Donation nie generowany jest kod odblokowujący.

Cena jest podana w dolarach amerykańskich. Minimalna cena to 1 dolar amerykański.

Rozpocznij pisanie lub zmianę wartości, a pojawi się przycisk Zapisz. Przycisk Zapisz umożliwia zapisanie zmian bez przechodzenia do następnej strony. Przycisk Dalej zapisuje zmiany i przechodzi do następnej strony. Zawsze można wrócić, aby dokonać późniejszych zmian.

W nagłówku strony dostępne są tylko zapisane strony aplikacji do nawigacji. Możesz kliknąć Dalej lub przejść do sekcji w nagłówku strony.

Podgląd

Ta strona ustawia wartości:

• Długość kodu - długość wygenerowanego kodu, jeśli dotyczy.
• Zestaw znaków kodu - zestaw znaków, z którego generowany jest kod:
• Kod numeryczny - kod jest generowany wyłącznie za pomocą cyfr 0, 1, 2, 3, 4, 5, 6, 7, 8, 9. W kodzie może być zawarta wiodąca zero. Wiodące zera są istotne podczas weryfikacji kodu.
• Kod alfanumeryczny - kod jest generowany za pomocą znaków 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F, G, H, I, G, K, L, M, N, P, Q, R, S, T, U, V, X, Y, Z. Kod jest generowany i wysyłany do użytkownika za pomocą wielkich liter. Wielkość liter nie ma znaczenia podczas weryfikacji kodu.
• Link do sprawdzenia kodu - przykładowy link do użycia w weryfikacji kodu.
• Link do płatności - link płatności. Możesz skopiować link i wkleić go do opisu aplikacji na stronie, gdzie aplikacja jest publikowana. Parametry do przekazania:
• app - unikalny identyfikator aplikacji. Parametr wymagany.
• amount - kwota, która zostanie podana w polu ceny podczas zakupu. Domyślna cena jest ignorowana. Jednak kwota nie może być mniejsza niż minimalna cena i nie może być niższa niż minimalna cena ustawiona dla aplikacji. Parametr opcjonalny.

Aby zacząć akceptować płatności, musisz aktywować aplikację za pomocą przycisku Uruchom. Przed aktywacją aplikacji upewnij się, że wszystkie wprowadzone dane są poprawne. Klucze wygenerowane przez aplikację nie mogą być zmieniane.

Weryfikacja kodu

Sprawdzenie kodu odblokowującego aplikację odbywa się w 3 krokach:

1. Napisanie i wysłanie żądania weryfikacji kodu
2. Sprawdzenia po stronie API
3. Otrzymywanie i przetwarzanie odpowiedzi API

Wysyłanie żądania

Aby zweryfikować kod, użytkownik Twojej aplikacji musi wprowadzić go w polu w ustawieniach aplikacji.

<properties>
	<property id="UnlockCode" type="string"></property>
	<property id="UnlockResult" type="string">Checking...</property>
	...
<properties>

<settings>
	<setting propertyKey="@Properties.UnlockCode" title="@Strings.UnlockCode">
		<settingConfig type="alphaNumeric" maxLength="12"/>
	</setting>
	<setting propertyKey="@Properties.UnlockResult" title="@Strings.UnlockResult">
		<settingConfig type="alphaNumeric" readonly="true"/>
	</setting>
	...
</settings>

Następnie należy wysłać żądanie do serwera API Płacenia za korzystanie:

function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	return Toybox.Communications.makeWebRequest(
		"https://api.pay-to-use.com", // URL API
		{
			"device" => ds.uniqueIdentifier, // unikalny identyfikator urządzenia
			"app" => "6", // id twojej aplikacji
			"model" => ds.partNumber, // numer katalogowy urządzenia
			"code" => Application.Properties.getValue("UnlockCode") // wartość kodu odblokowującego w twojej aplikacji
		},
		{
			:method => Communications.HTTP_REQUEST_METHOD_POST,
			:headers => { "Content-Type" => Communications.REQUEST_CONTENT_TYPE_JSON },
			:responseType => Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
		},
		method(:onReceive)
	);
}

parametry żądania API:

• url – https://api.pay-to-use.com. Korzystanie z protokołu HTTPS jest obowiązkowe.
• Treść żądania (przekazane wartości). Słownik kluczy i wartości:
• device - unikalny identyfikator urządzenia.
• app - unikalny identyfikator twojej aplikacji.
• model – identyfikator modelu urządzenia. Parametr opcjonalny. Dane służą do wyświetlania statystyk dotyczących nowych urządzeń.
• code - kod odblokowujący wprowadzony przez użytkownika w ustawieniach twojej aplikacji.
• Opcje żądania:
• :method - API obsługuje metody żądania GET i POST.
• :headers - dla metody POST, parametry muszą być przekazywane w formacie JSON.
• :responseType - odpowiedź jest zwracana w formacie JSON.
• responseCallback - odnośnik do metody zwrotnej, która powinna przyjmować dwa argumenty:
• responseCode - kod nagłówka odpowiedzi serwera.
• data - zawartość, jeśli żądanie było udane, lub null.

Sprawdzenia po stronie API

Jeśli do API nie są przekazywane żadne parametry, API zwraca nagłówek HTTP/1.1 404 Not Found.

Jeśli przynajmniej jeden parametr jest przekazywany do API, API zwraca nagłówek HTTP/1.1 200 OK.

Odpowiedź serwera składa się z:

• response - kod odpowiedzi
• msg - tekstowy opis odpowiedzi
• expires - znacznik czasu UNIXTIME (jeśli dotyczy)

Sprawdzana jest poprawność przekazanego identyfikatora aplikacji. Aplikacja musi być w stanie Wydana w chwili płatności. W przypadku błędu zwracany jest kod odpowiedzi 301.

Jeśli przesłano unikalny identyfikator urządzenia, identyfikator urządzenia jest wyszukiwany i przechowywany. W przypadku wystąpienia błędów podczas sprawdzania lub zapisywania, zwracany jest kod błędu 402. Jeśli zostanie znaleziony taki kod zwrotny, natychmiast napisz do pomocy technicznej pod adresem [email protected]

Jeśli kod zostanie przekazany, następujące kroki są wykonywane dla aplikacji z metodami obliczania Obliczanie ceny w zależności od okresu i Obliczanie okresu w zależności od ceny:

• Jeśli przesłany zostanie pusty kod, zostaje on odłączony od unikalnego identyfikatora urządzenia zdefiniowanego w poprzednich krokach.
• Jeśli zostanie przesłany niepusty kod i nie jest on aktywowany, kod jest aktywowany w zależności od warunków ceny określonych podczas zakupu kodu, niezależnie od daty aktywacji.
• Jeśli nie zostanie przesłany żaden kod lub jeśli przesłany kod nie zostanie znaleziony, zwracany jest kod błędu 201.
• Sprawdzany jest aktywowany kod w porównaniu z urządzeniem i w przypadku przekazania podczas aktywacji innego unikalnego identyfikatora urządzenia niż przechowywany, zwracany jest kod błędu 202.
• Jeśli przesłany kod nie ma daty wygaśnięcia i wszystkie poprzednie sprawdzenia zostały zaliczone, zwracany jest kod 101.
• Jeśli kod ma ograniczony czas ważności, następuje sprawdzenie. Jeśli klucz nie wygasł, zwracany jest kod 101. Jeśli kod wygasł, zwracany jest kod błędu 203.
• Ten rodzaj aplikacji wymaga, aby kod był przypisany do urządzenia. Jeśli nie przesłano unikalnego identyfikatora urządzenia, zwracany jest kod błędu 304.

Dla aplikacji z Stały kod, sprawdzana jest tylko dostępność kodu w chwili zakupu. Jeśli kod zostanie znaleziony, zwracany jest kod 101. Jeśli kod nie zostanie znaleziony, zwracany jest kod błędu 201.

Dla aplikacji z metodą obliczania Darowizna, kod nie jest sprawdzany. Zawsze zwracany jest kod 101.

Jeśli poprzednie sprawdzenia nie zostały zaliczone, sprawdzany jest okres testowy. Jeśli upłynęło więcej czasu od pierwszego skontaktowania się z urządzeniem niż bieżące ustawienia aplikacji, zwracany jest kod błędu 204. Jeśli okres próbny nie wygasł jeszcze, zwracany jest kod błędu 102.

Jeśli przesłano tylko identyfikator aplikacji i ani kod odblokowujący, ani unikalny identyfikator urządzenia nie został przesłany, zwracany jest kod błędu 303.

Jeśli zwrócony zostanie kod odpowiedzi 500, powinieneś napisać do wsparcia pod adresem [email protected]

Poniżej znajduje się tabela wszystkich zwróconych kodów:

{
	"response":101,
	"msg":"Active forever",
	"expires":0
}

{
	"response":101,
	"msg":"Active until 19 Apr 2027",
	"expires":1808169419
}

{
	"response":101,
	"msg":"The code check was successfull",
	"expires":0
}

{
	"response":101,
	"msg":"No code check required",
	"expires":0
}

{
	"response":102,
	"msg":"Trial period expires in 2d 11h 31m",
	"expires":1779698910
}

{
	"response":201,
	"msg":"Code not found"
}

{
	"response":202,
	"msg":"Used on the another device"
}

{
	"response":203,
	"msg":"Expiration: 2 May 2026",
	"expires":1777756619
}

{
	"response":204,
	"msg":"Trial period expired"
}

{
	"response":301,
	"msg":"Application not found"
}

{
	"response":302,
	"msg":"Term undefined"
}

{
	"response":303,
	"msg":"Not enough arguments"
}

{
	"response":304,
	"msg":"Device is nesessary"
}

{
	"response":401,
	"msg":"Error code saving"
}

{
	"response":402,
	"msg":"Error device saving"
}

{
	"response":500,
	"msg":"Unknown error"
}

Sprawdzanie odpowiedzi

Następnie powinieneś sprawdzić odpowiedź serwera API Pay-to-use:

function onReceive(responseHeader, data) as Void {
	if (responseHeader == 200) { Toybox.Background.exit(data); }
}

Możesz sprawdzić wszystkie nagłówki i kody, możesz wyświetlać własne komunikaty dla wygody użytkownika, ale w najprostszej formie weryfikacja będzie wyglądać mniej więcej tak:

function onBackgroundData(data) as Void {
	if (data.hasKey("response")) {
		if (data.hasKey("msg")) {
			// Możesz wyświetlić data["msg"] w polu właściwości pod nazwą "UnlockResult".
			Application.Properties.setValue("UnlockResult", data["msg"]);
		}
		if (data["response"].toString().substring(0, 1).equals("2")) {
			// Weryfikacja kodu nie powiodła się
			// Płatne funkcje NIE są dostępne
			...
		} else {
			// Sprawdzenie kodu zakończyło się sukcesem lub błąd jest Twoją winą lub winą interfejsu API
			// Płatne funkcje są dostępne
			...
		}
	}
}

Kody odblokowujące

Przechodząc do tej sekcji, otworzy się lista kodów odblokowujących.

Lista kodów odblokowujących

Możesz wyszukiwać w polu adresu e-mail lub kodu w górnym pasku wyszukiwania. Znalezione kody będą wyświetlane na liście. Możesz używać całego lub części adresu e-mail lub kodu jako kryterium wyszukiwania. Dopasowania będą wyróżnione kolorem. Wyszukiwanie i filtry działają jednocześnie i nie wykluczają się nawzajem.

Ostatnio używany filtr jest przechowywany dla użytkownika. To znaczy, że kolejnym razem, gdy wejdziesz na stronę, ostatnio używany filtr zostanie automatycznie zastosowany. Filtry są dostępne dla listy kodów odblokowujących:

• Kolumny - wybierz kolumny tabeli do wyświetlenia na liście kodów odblokowujących.
• Aplikacja - wyświetlaj tylko kody odblokowujące dla wybranych aplikacji.
• Status - wyświetlaj tylko kody odblokowujące znajdujące się w wybranych statusach.

Lista kolumn w tabeli kodów odblokowujących:

• Aplikacja - Twoja aplikacja. Możesz przejść do linku, aby edytować jej ustawienia.
• Kod - kod odblokowujący.
• E-mail - adres e-mail powiązany z rejestracją kodu odblokowującego. Ten adres jest używany do wyszukiwania kodów odblokowujących klientów w sekcji Moje zakupy na stronie internetowej. Ta sekcja jest dostępna dla użytkowników.
• Termin - okres ważności wysłanego kodu (określony w ustawieniach aplikacji). Okres ważności jest ustawiony dla kodu, odpowiadający warunkom ustawień aplikacji w momencie jej utworzenia.
• Status - status kodu odblokowującego. (zobacz Status kodu odblokowującego)
• Utworzony - data utworzenia kodu odblokowującego.
• Aktywowany - data aktywacji kodu. Jest ustawiana w momencie, gdy to konkretne urządzenie użytkownika po raz pierwszy kontaktuje się z usługą API PayToUse i przesyła ten kod. Status kodu zmienia się na Aktywowany. Tylko nieaktywny kod może być aktywowany. Jeśli aktywny kod zostanie przesłany przez urządzenie z innym identyfikatorem, API zwróci błąd 202. Tylko jedno urządzenie może być połączone z pojedynczym kodem.
• Wygaśnięcie - data wygaśnięcia aktywacji kodu. Ustawiona dla kodów, które mają ograniczony okres ważności po aktywacji kodu. Dla kodów z nieograniczonym terminem ważności data pozostaje pusta.
• Usunięty - data usunięcia kodu. Po usunięciu status kodu jest ustawiony na Nieznany.
• Płatność nr - unikalny numer sekwencji płatności. Możesz kliknąć na link, aby zobaczyć szczegóły płatności.
• Przyciski do działań z kodami odblokowującymi. Na przykład, usuwanie.

Status kodu odblokowującego

Podczas swojego cyklu życia kod odblokowujący przechodzi przez różne stany, które można śledzić za pomocą statusu kodu.

Płatności

Przechodząc do tej sekcji, otworzy się lista płatności użytkownika.

Do otrzymywania płatności używane są następujące systemy płatności:

Po opłatach systemu płatności PayToUse pobierze opłatę w wysokości 13%. Nieustannie pracujemy nad obniżeniem opłat.

W przypadku jakichkolwiek sporów lub zwrotów w systemie płatności, kary systemu płatności są ponownie przypisywane deweloperowi. Dlatego nie należy dopuszczać do takich sytuacji. Opłata PayToUse nie jest pobierana w sytuacjach kontrowersyjnych.

Lista płatności

Możesz wyszukiwać w polu e-mail lub wysłanym kodzie w górnym pasku wyszukiwania. Znalezione płatności zostaną wyświetlone na liście. Możesz użyć całego lub części adresu e-mail lub wysłanego kodu jako kryterium wyszukiwania. Dopasowania będą podświetlone kolorem. Wyszukiwanie i filtry działają jednocześnie i się wzajemnie nie wykluczają.

Ostatnio używany filtr jest przechowywany dla użytkownika. Oznacza to, że następnym razem, gdy wejdziesz na stronę, ostatnio używany filtr zostanie automatycznie zastosowany. Filtry są dostępne dla listy płatności:

• Kolumny - wybierz kolumny tabeli do wyświetlenia na liście płatności.
• Aplikacja - wyświetlanie płatności tylko z wybranych aplikacji.
• System - wyświetlaj płatności tylko z wybranych systemów płatności.
• Status - wyświetlaj płatności tylko z wybranymi statusami.

Lista kolumn w tabeli płatności:

• Aplikacja - Twoja aplikacja. Możesz przejść do linku, aby edytować jej ustawienia.
• # - unikalny numer sekwencyjny płatności. Jest on przypisywany automatycznie po przejściu użytkownika z formularza płatności na stronę płatności w systemie płatności. Możesz kliknąć na link, aby zobaczyć szczegóły płatności.
• Komentarze - wiadomość od użytkownika wprowadzona w formularzu płatności.
• System - system płatności wybrany przez użytkownika.
• Status - status płatności. (zobacz Status płatności)
• E-mail - e-mail użytkownika podany w formularzu płatności.
• Termin - okres ważności wysłanego kodu (określony w ustawieniach aplikacji).
• Utworzony - data utworzenia płatności.
• Kwota faktury - kwota płatności pobrana od użytkownika. Określana w formularzu płatności w zależności od ustawień aplikacji.
• Data płatności - data płatności.
• Kwota płatności - kwota płatności potwierdzona przez system płatności.
• Wysłany kod - kod wysłany do użytkownika.
• Dostępna kwota - dostępna kwota wypłaty.
• Kwota wypłaty - kwota wypłaconych środków za płatność.

Nie można wprowadzać zmian w płatności.

Status płatności

Podczas swojego cyklu życia płatność przechodzi przez różne stany, które można śledzić za pomocą statusu płatności.

Wypłaty

Przechodząc do tej sekcji, otworzy się lista twoich wypłat.

Lista wypłat

Ostatnio używany filtr jest przechowywany dla użytkownika. Oznacza to, że następnym razem, gdy wejdziesz na stronę, ostatnio używany filtr zostanie automatycznie zastosowany. Dla listy wypłat są dostępne filtry:

• Kolumny - wyświetlaj tylko wybrane kolumny na liście wypłat.
• Status - wyświetlaj tylko wypłaty znajdujące się w wybranych statusach.

Lista kolumn w tabeli wypłat:

• # - unikalny numer sekwencyjny wypłaty. Przypisywany jest automatycznie po zapisaniu wypłaty. Możesz kliknąć na link, aby wyświetlić szczegóły wypłaty.
• Status - status wypłaty. (zobacz Status wypłaty)
• Utworzony - data żądania wypłaty.
• Kwota - kwota wypłaty.
• Wypłata - data wysłania wypłaty.
• Przyciski do działań z wypłatami. Na przykład, potwierdzenie.

Możesz potwierdzić wypłatę, gdy znajduje się w statusie Wysłane.

Status wypłaty

Podczas swojego cyklu życia, wypłata przechodzi przez różne stany, które można śledzić za pomocą statusu wypłaty.

API

Przegląd

Interfejs API PayToUse realizuje następujące funkcje:

1. Sprawdza status aktywacji kodu odblokowującego i w razie potrzeby go aktywuje.
2. Pobiera dane dotyczące poziomu glukozy we krwi z aplikacji NightScout.
3. Pobiera aktualne dane pogodowe dla wskazanej lokalizacji.

Wszystkie informacje można uzyskać i zwrócić w ramach jednego żądania.

Punkty końcowe API

Możesz skorzystać z jednego z poniższych punktów końcowych:

• https://api.pay-to-use.com
• https://api.p2u.io

Oba punkty końcowe obsługują żądania GET i POST.

Parametry żądania

• device: napis (wymagane) — unikalny identyfikator urządzenia
• app: całkowita (wymagane) — twój identyfikator wniosku
• model: napis (opcjonalnie) — kod modelu urządzenia, niezbędny do gromadzenia i wyświetlania statystyk dotyczących urządzeń korzystających z aplikacji
• code: napis (opcjonalnie) — kod odblokowujący
• bg: tablica asocjacyjna (opcjonalnie) — dane służące do pobierania wyników pomiarów poziomu glukozy we krwi z aplikacji NightScout
• url: napis (opcjonalnie) — adres aplikacji NightScout
• weather: tablica asocjacyjna (opcjonalnie) — dane potrzebne do sprawdzenia aktualnej pogody
• appid: napis (opcjonalnie) — klucz dostępu do interfejsu API pogody
• lat: platforma (opcjonalnie) — szerokość geograficzna
• lon: platforma (opcjonalnie) — długość geograficzna
• provider: całkowita (opcjonalnie) — dostawca danych pogodowych

Lista obsługiwanych dostawców danych pogodowych

1. OpenWeatherMap

• Opis: OpenWeatherMap udostępnia dane pogodowe z całego świata, w tym informacje o pogodzie w czasie rzeczywistym, dane historyczne oraz 16-dniowe prognozy. Dzięki szerokiemu zasięgowi geograficznemu i częstym aktualizacjom OpenWeatherMap jest popularnym rozwiązaniem w aplikacjach wymagających zarówno aktualnych informacji o pogodzie, jak i długoterminowych prognoz.
• Dostarczone dane: Temperatura, wilgotność, prędkość wiatru, jakość powietrza, prawdopodobieństwo opadów i inne dane w czasie rzeczywistym. Aplikacja udostępnia zarówno dane bieżące, jak i prognozy, w tym dane pogodowe z dokładnością co do minuty dla wybranych lokalizacji.
• Wybór dostawcy: W sekcji dotyczącej pogody w żądaniu należy podać parametr provider=1, aby wybrać OpenWeatherMap jako dostawcę danych pogodowych.
• Wskazówki dotyczące użytkowania: Oferuje wersje bezpłatną i płatną, a dostęp do danych odbywa się poprzez uwierzytelnianie za pomocą klucza API. Zaawansowane warstwy danych i funkcje premium są dostępne w planach płatnych.
• Dokumentacja API: Dostępne tutaj.

2. QWeather

• Opis: QWeather, znany również jako HeWeather, dostarcza obszerne dane pogodowe dotyczące przede wszystkim Chin, ale obejmuje również dane międzynarodowe. Aplikacja oferuje szczegółowe informacje, takie jak aktualna pogoda, prognozy, dane o jakości powietrza oraz ostrzeżenia.
• Dostarczone dane: Aktualna temperatura, wilgotność, indeks UV, poziom zanieczyszczenia, prognozy dzienne i godzinowe, a także ostrzeżenia o trudnych warunkach pogodowych. Serwis znany jest z szczegółowych danych dotyczących jakości powietrza oraz aktualizacji w czasie rzeczywistym na temat zmieniających się warunków pogodowych.
• Wybór dostawcy: W sekcji dotyczącej pogody w żądaniu należy podać parametr provider=2, aby wybrać QWeather jako dostawcę danych pogodowych.
• Wskazówki dotyczące użytkowania: QWeather oferuje dostęp do interfejsu API w ramach planu bezpłatnego i premium. Plan bezpłatny zapewnia ograniczony dostęp do danych, natomiast opcje premium obejmują dodatkowe punkty danych i lokalizacje.
• Dokumentacja API: Dostępne tutaj.

3. MET Weather (MET Norway)

• Opis: Interfejs API MET Weather, udostępniany przez MET Norway, zapewnia dostęp do szerokiego zakresu otwartych danych meteorologicznych, w tym prognoz, danych historycznych oraz danych dotyczących Norwegii i krajów skandynawskich. Dzięki swojej dokładności i przejrzystości MET Weather doskonale nadaje się do zastosowań wymagających wysoce wiarygodnych danych pogodowych.
• Dostarczone dane: Aktualne warunki pogodowe, prognozy, opady, temperatura, dane dotyczące wiatru oraz indeks UV. Serwis MET Weather oferuje specjalistyczne dane dotyczące regionów skandynawskich, ale udostępnia również informacje pogodowe z całego świata.
• Wybór dostawcy: Aby wybrać serwis pogodowy MET Weather, należy w sekcji dotyczącej pogody w żądaniu podać wartość „provider = 3 ”.
• Wskazówki dotyczące użytkowania: Wszystkie dane udostępniane przez MET Weather są dostępne do swobodnego wykorzystania na licencji Creative Commons, która zezwala zarówno na zastosowania niekomercyjne, jak i komercyjne bez żadnych opłat. MET Norway cieszy się renomą dzięki swoim danym środowiskowym, co czyni tę organizację zaufanym dostawcą, zwłaszcza w Europie.
• Dokumentacja API: Dostępne tutaj.

Przykładowe zapytanie

function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	if (!ds.phoneConnected) { // Sprawdza, czy urządzenie jest podłączone do telefonu w celu wysłania żądania
		return;
	}

	var id = ds.uniqueIdentifier;
	if (id == null) { // Sprawdza, czy urządzeniu przypisano unikalny identyfikator
		return;
	}

	var request = {};

	var lockCheck = Application.Storage.getValue("LastCodeCheckTimestamp");
	if (lockCheck == null || lockCheck <= Time.now().value()) { // W razie potrzeby wysyła kod
		request.put("code", Application.Properties.getValue("UnlockCode"));
	}

	var ns_url = Application.Properties.getValue("NS");
	if (!ns_url.equals("")) { // W razie potrzeby wysyła adres URL aplikacji NightScout
		request.put("bg", { "url" => ns_url });
	}

	var wP = Application.Properties.getValue("Weather");
	if (wP != 0) { // W razie potrzeby wysyła parametry zapytania o pogodę
		var lat = Application.Properties.getValue("latitude");
		var lon = Application.Properties.getValue("longitude");
		if (!lat.equals("") && !lon.equals("")) {
			request.put("weather", {
				"appid" => Application.Properties.getValue("appID"),
				"lat" => lat,
				"lon" => lon,
				"provider" => wP
			});
		}
	}

	if (!request.isEmpty()) {

		// Wypełnia wymagane parametry żądania
		request.put("device", id);
		request.put("app", p2uAppID); // id twojej aplikacji
		request.put("model", ds.partNumber);

		Toybox.Communications.makeWebRequest(
			"https://api.p2u.io", // Punkt końcowy API
			request,
			{
				:method => 3, // Communications.HTTP_REQUEST_METHOD_POST
				:headers => {
					"Content-Type" => 1 // Communications.REQUEST_CONTENT_TYPE_JSON
				},
				:responseType => 0 // Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
			},
			method(:onReceive)
		);
	}
}

Odpowiedź API

Interfejs API zwraca obiekt JSON zawierający informacje o statusie odblokowania, poziomie glukozy oraz pogodzie.

Parametry odpowiedzi

Wyniki weryfikacji kodu odblokowującego (jeśli wysłano żądanie):

• response: całkowita — kod zwrotny
• msg: napis — komunikat dotyczący wyniku weryfikacji
• expires: całkowita — znacznik czasu wygaśnięcia kodu w formacie UNIXTIMESTAMP
• qr: array — Kod QR do realizacji zakupu lub weryfikacji numeru seryjnego, jeśli dotyczy

Odpowiedź aplikacji NightScout (jeśli wysłano żądanie):

• bg: tablica asocjacyjna — sformatowana odpowiedź z aplikacji NightScout
• value: całkowita — poziom glukozy we krwi w mg/dl
• date: całkowita — znacznik czasu wygaśnięcia kodu w formacie UNIXTIMESTAMP
• direction: napis — tendencja zmian poziomu glukozy we krwi

Odpowiedź interfejsu API pogody (jeśli wysłano żądanie):

• weather: tablica asocjacyjna — sformatowana odpowiedź z interfejsu API pogody
• provider: całkowita — identyfikator dostawcy danych pogodowych
• weather: array — aktualne warunki pogodowe. Może zwrócić jedną lub dwie wartości; jeśli zwrócone zostaną dwie wartości, odpowiadają one warunkom panującym w ciągu dnia i w nocy
• temp: platforma — aktualna temperatura w stopniach Celsjusza
• feels_like: platforma — temperatura odczuwalna w stopniach Celsjusza
  Внимание! Отсутствует для MET Norway
• pressure: całkowita — ciśnienie atmosferyczne w hPa
• humidity: całkowita — wilgotność w %
• precipitation: całkowita — prawdopodobieństwo opadów w %
  Внимание! Отсутствует для MET Norway
• wind: całkowita — kierunek wiatru w stopniach
• wind_speed: platforma — prędkość wiatru w m/s
• temp_low: platforma — dzisiejsza minimalna temperatura w stopniach Celsjusza
• temp_high: platforma — dzisiejsza maksymalna temperatura w stopniach Celsjusza
• sunrise_today: całkowita — dzisiejsza godzina wschodu słońca w formacie UNIXTIMESTAMP
• sunset_today: całkowita — dzisiejsza godzina zachodu słońca w formacie UNIXTIMESTAMP
• sunrise_tomorrow: całkowita — czas jutrzejszego wschodu słońca w formacie UNIXTIMESTAMP
• sunset_tomorrow: całkowita — czas jutrzejszego zachodu słońca w formacie UNIXTIMESTAMP
• aqi: tablica asocjacyjna — wskaźnik jakości powietrza
• level: całkowita — poziom wskaźnika jakości powietrza
• value: całkowita — wartość wskaźnika jakości powietrza

Przykładowa odpowiedź

{
	"response": 103,
	"msg": "Free for beta tester",
	"expires": 0,
	"qr": [
		"11111110111011010110101111111",
		"10000010111001001101001000001",
		"10111010101100110110101011101",
		"10111010110101000001001011101",
		"10111010000001010100001011101",
		"10000010100110001101001000001",
		"11111110101010101010101111111",
		"00000000010010110111100000000",
		"11001110000100100100100101111",
		"11111100011011011010011111111",
		"01111011100111111100101000001",
		"01111100101100110111011011011",
		"00110110101010100101110000010",
		"11001000010001011000001011111",
		"01101010001001110100000001101",
		"10111101100010100101100110011",
		"01010111111100110100100100010",
		"10000100111011011000101111011",
		"00000110110110110100100000101",
		"00111100011100001100101100011",
		"11110111110010100111111111001",
		"00000000111001011101100010001",
		"11111110010001011111101011101",
		"10000010100010100111100010010",
		"10111010101101100111111111001",
		"10111010010010110000010000001",
		"10111010001111111110000001111",
		"10000010111101011111101101011",
		"11111110100011011110110010010"
	],
	"bg": {
		"value": -102,
		"date": 1730546101,
		"direction": ""
	},
	"weather": {
		"provider": 1,
		"weather": [
			89
		],
		"temp": 0.27,
		"feels_like": -3.14,
		"pressure": 999,
		"humidity": 78,
		"precipitation": 0,
		"wind": 120,
		"wind_speed": 2.96,
		"temp_low": -3.8,
		"temp_high": 0.27,
		"sunrise_today": 1730527969,
		"sunset_today": 1730551770,
		"sunrise_tomorrow": 1730614492,
		"sunset_tomorrow": 1730638051,
		"aqi": {
			"level": 1,
			"value": 38
		}
	}
}

Notatki

• Żądania wysyłane za pomocą bg wymagają połączenia z aplikacją NightScout.
• W przypadku każdego żądania zawierającego kod API automatycznie sprawdza status kodu i aktywuje go, jeśli jest nieaktywny.
• Należy pamiętać, że parametry API mogą z czasem ulegać aktualizacji lub modyfikacji w celu poprawy funkcjonalności, kompatybilności i bezpieczeństwa. Zaleca się okresowe sprawdzanie dokumentacji API pod kątem wszelkich zmian, które mogą mieć wpływ na integrację lub korzystanie z interfejsu.

Garmin

Szczegółowy opis funkcji pogodowych i stałych biblioteki Garmin SDK można znaleźć pod tym linkiem. W zależności od wybranego dostawcy danych pogodowych można zapisywać wartości uzyskane z interfejsu API lub wyniki funkcji pogodowych biblioteki Garmin SDK, aby zapewnić spójność wyświetlania wartości na ekranie.

Otwórz mapę pogodową

Zobacz przykładowy zestaw ikon dla OpenWeatherMap tutaj.

QWeather

Aby obejrzeć oryginalny zestaw ikon pogodowych, kliknij tutaj

Prognoza pogody MET

Zobacz przykładowy zestaw ikon dla aplikacji MET Weather tutaj.