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, // device part number
			"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. Using HTTPS is mandatory.
• Treść żądania (przekazane wartości). Słownik kluczy i wartości:
• device - unikalny identyfikator urządzenia.
• app - unikalny identyfikator twojej aplikacji.
• model - device model identifier. Optional parameter. Data is used to display statistics for new devices.
• 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 11 Oct 2025",
	"expires":1760178206
}

{
	"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 1d 20h 20m",
	"expires":1732344253
}

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

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

{
	"response":203,
	"msg":"Expiration: 13 Nov 2024",
	"expires":1731493406
}

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

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

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

{
	"response":303,
	"msg":"Not enought 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

Overview

API PayToUse performs the following functions:

1. Checks the activation status of an unlock code and activates it if necessary.
2. Retrieves blood glucose data from the NightScout app.
3. Retrieves current weather data for a specified location.

All information can be requested and returned in a single request.

API Endpoints

You can use one of the following endpoints:

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

Both endpoints handle GET and POST requests.

Request Parameters

• device: string (required) — unique device identifier
• app: integer (required) — your Application ID
• model: string (optional) — device model code, needed for collecting and displaying statistics for devices using the app
• code: string (optional) — unlock code
• bg: associative array (optional) — data for requesting blood glucose levels from the NightScout app
• url: string (optional) — address of the NightScout app
• weather: associative array (optional) — data for requesting current weather
• appid: string (optional) — weather API access key
• lat: float (optional) — latitude
• lon: float (optional) — longitude
• provider: integer (optional) — weather provider

List of Supported Weather Providers

1. OpenWeatherMap

• Description: OpenWeatherMap provides global weather data, including real-time weather, historical data, and 16-day forecasts. With wide geographic coverage and frequent updates, OpenWeatherMap is a popular choice for applications requiring both current weather and extended forecasts.
• Data Provided: Real-time temperature, humidity, wind speed, air quality, precipitation probability, and more. Offers both current and forecast data, including minute-by-minute weather data for select locations.
• Provider Selection: Include provider = 1 in the weather section of your request to select OpenWeatherMap as the weather provider.
• Usage Notes: Offers free and paid tiers, with data accessible via API key authentication. Advanced data layers and premium features are available in paid plans.
• API Documentation: Available here.

2. QWeather

• Description: QWeather, also known as HeWeather, provides comprehensive weather data focused on China but includes international data as well. It offers extensive details such as real-time weather, forecasts, air quality information, and alerts.
• Data Provided: Current temperature, humidity, UV index, pollution levels, daily and hourly forecasts, as well as warnings for severe weather conditions. Known for its granular air quality data and its real-time updates on changing weather conditions.
• Provider Selection: Include provider = 2 in the weather section of your request to select QWeather as the weather provider.
• Usage Notes: QWeather offers API access with free and premium tiers. The free tier provides limited data, while premium options expand to cover additional data points and locations.
• API Documentation: Available here.

3. MET Weather (MET Norway)

• Description: The MET Weather API, provided by MET Norway, gives access to a variety of open meteorological data, including forecasts, historical data, and specific data for Norway and the Nordic regions. Known for its accuracy and transparency, MET Weather is ideal for applications in need of highly reliable weather data.
• Data Provided: Current weather conditions, forecasts, precipitation, temperature, wind data, and UV index. MET Weather offers specialized data for the Nordic regions but also supports global weather information.
• Provider Selection: Include provider = 3 in the weather section of your request to select MET Weather as the weather provider.
• Usage Notes: All data provided by MET Weather is freely available for use under a Creative Commons license, allowing both non-commercial and commercial applications without cost. MET Norway is renowned for its environmental data, making it a trusted provider, particularly in Europe.
• API Documentation: Available here.

Example Request

function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	if (!ds.phoneConnected) { // Checks that the device is connected to the phone for sending the request
		return;
	}

	var id = ds.uniqueIdentifier;
	if (id == null) { // Verifies that the device has been assigned a unique identifier
		return;
	}

	var request = {};

	var lockCheck = Application.Storage.getValue("LastCodeCheckTimestamp");
	if (lockCheck == null || lockCheck <= Time.now().value()) { // Sends the code if necessary
		request.put("code", Application.Properties.getValue("UnlockCode"));
	}

	var ns_url = Application.Properties.getValue("NS");
	if (!ns_url.equals("")) { // Sends the NightScout app URL if needed
		request.put("bg", { "url" => ns_url });
	}

	var wP = Application.Properties.getValue("Weather");
	if (wP != 0) { // Sends weather request parameters if needed
		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()) {

		// Fills in the required request parameters
		request.put("device", id);
		request.put("app", p2uAppID); // id twojej aplikacji
		request.put("model", ds.partNumber);

		Toybox.Communications.makeWebRequest(
			"https://api.p2u.io", // API Endpoint
			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)
		);
	}
}

API Response

The API returns a JSON object with information on unlock status, glucose level, and weather.

Response Parameters

Unlock Code Verification Results (if a request was sent):

• response: integer — return code
• msg: string — message about the verification result
• expires: integer — expiration timestamp of the code in UNIXTIMESTAMP format
• qr: array — QR code for purchase or serial number verification, if applicable

NightScout App Response (if a request was sent):

• bg: associative array — formatted response from the NightScout app
• value: integer — blood glucose level in mg/dL
• date: integer — timestamp of the code expiration in UNIXTIMESTAMP format
• direction: string — trend in blood glucose level change

Weather API Response (if a request was sent):

• weather: associative array — formatted response from the Weather API
• provider: integer — weather provider identifier
• weather: array — current weather conditions. May return one or two values; if two values are returned, they represent day and night conditions
• temp: float — current temperature in Celsius
• feels_like: float — feels-like temperature in Celsius
• pressure: integer — atmospheric pressure in hPa
• humidity: integer — humidity in %
• precipitation: integer — precipitation probability in %
• wind: integer — wind direction in degrees
• wind_speed: float — wind speed in m/s
• temp_low: float — today’s low temperature in Celsius
• temp_high: float — today’s high temperature in Celsius
• sunrise_today: integer — today’s sunrise timestamp in UNIXTIMESTAMP format
• sunset_today: integer — today’s sunset timestamp in UNIXTIMESTAMP format
• sunrise_tomorrow: integer — tomorrow’s sunrise timestamp in UNIXTIMESTAMP format
• sunset_tomorrow: integer — tomorrow’s sunset timestamp in UNIXTIMESTAMP format
• aqi: associative array — air quality index
• level: integer — air quality index level
• value: integer — air quality index value

Example Response

{
	"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
		}
	}
}

Notes

• Requests with bg require a connection to the NightScout app.
• For every request with a code, the API automatically checks the code status and activates it if inactive.
• Please note that API parameters may be updated or modified over time to improve functionality, compatibility, and security. It is recommended to periodically review the API documentation for any changes that might affect integration or usage.

Garmin

Project-Id-Version: PayToUse Report-Msgid-Bugs-To: PO-Revision-Date: 2024-06-26 18:47+0300 Last-Translator: VeshchiyOleg Language-Team: Language: pl_PL MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2); X-Poedit-KeywordsList: _;gettext;gettext_noop X-Poedit-Basepath: ../../.. X-Poedit-SourceCharset: UTF-8 X-Generator: Poedit 3.4.4 X-Poedit-SearchPath-0: . X-Poedit-SearchPathExcluded-0: vendor X-Poedit-SearchPathExcluded-1: www/vendor X-Poedit-SearchPathExcluded-2: mail X-Poedit-SearchPathExcluded-3: api

Open Weather Map

Project-Id-Version: PayToUse Report-Msgid-Bugs-To: PO-Revision-Date: 2024-06-26 18:47+0300 Last-Translator: VeshchiyOleg Language-Team: Language: pl_PL MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2); X-Poedit-KeywordsList: _;gettext;gettext_noop X-Poedit-Basepath: ../../.. X-Poedit-SourceCharset: UTF-8 X-Generator: Poedit 3.4.4 X-Poedit-SearchPath-0: . X-Poedit-SearchPathExcluded-0: vendor X-Poedit-SearchPathExcluded-1: www/vendor X-Poedit-SearchPathExcluded-2: mail X-Poedit-SearchPathExcluded-3: api

QWeather

You can check out the original set of weather icons by clicking here

MET Weather

Project-Id-Version: PayToUse Report-Msgid-Bugs-To: PO-Revision-Date: 2024-06-26 18:47+0300 Last-Translator: VeshchiyOleg Language-Team: Language: pl_PL MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2); X-Poedit-KeywordsList: _;gettext;gettext_noop X-Poedit-Basepath: ../../.. X-Poedit-SourceCharset: UTF-8 X-Generator: Poedit 3.4.4 X-Poedit-SearchPath-0: . X-Poedit-SearchPathExcluded-0: vendor X-Poedit-SearchPathExcluded-1: www/vendor X-Poedit-SearchPathExcluded-2: mail X-Poedit-SearchPathExcluded-3: api