Príručka

Úvod

Ľavý postranný panel obsahuje odkazy na príslušné sekcie:

• Meno používateľa - odkazy na osobný profil.
• Nástenka - zobraziť aktuálny stav vo forme grafov a grafikonov.
• Aplikácie - správa aplikácie.
• Odomknúť kódy - odblokovacie kódy generované automaticky alebo stiahnuté vami.
• Platby - história prichádzajúcich platieb používateľov.
• Príručka - aktuálny používateľský manuál.

Nástenka

Môžete nastaviť bežné filtre pre všetky widgety na palubnej doske:

• Mena - mena, do ktorej budú na palubnej doske konvertované prichádzajúce a odchádzajúce sumy.
• Období - je časové obdobie, počas ktorého sa údaje zobrazujú v grafikónoch a tabuľkách na palubnej doske. Určuje interval, počas ktorého sa analyzujú a zobrazujú informácie a štatistiky o platbách, aplikáciách a iných parametroch.

Zostatok

Bilancia zahŕňa nasledujúce sumy:

• Hrubá suma - celková suma všetkých platieb používateľov za zvolené obdobie s výnimkou poplatkov platobných systémov a PayToUse.
• Čistá suma - celková suma všetkých platieb za zvolené obdobie mínus poplatky platobných systémov a PayToUse.
• Čakajúca suma - celková suma všetkých platieb za uvedené obdobie mínus poplatky systémov platby a PayToUse čakajúce na výber na účet vývojára. Platba bude možná na výber 7 dní po jej prijatí.
• Dostupná suma - celková suma všetkých platieb za všetky časy mínus poplatky systémov platby a PayToUse, dostupné na výber na účet vývojára.

Platby

Prvok platby obsahuje tabuľku platieb zoskupených podľa aplikácie pre zvolené obdobie.

Stĺpce tabuľky:

• Aplikácia - aplikácia. V tabuľke sú zobrazené iba aplikácie, pre ktoré boli v zvolenom období uskutočnené platby.
• Platby - počet platieb.
• Hrubá suma - celková suma všetkých platieb používateľov za zvolené obdobie s výnimkou poplatkov platobných systémov a PayToUse.
• Čistá suma - celková suma všetkých platieb za zvolené obdobie mínus poplatky platobných systémov a PayToUse.

Graf zobrazuje dynamiku hodnôt Čistá suma a Hrubá suma podľa dní.

Noví používatelia

Graf nových používateľov zobrazuje dve hodnoty v dynamike podľa dní:

• Noví používatelia - počet nových volaní API. Prístupy k API sú zaznamenané iba v prípade, že sa parameter device - jedinečný identifikátor zariadenia - prenesie pri odosielaní požiadavky na API. Tento parameter musí byť skutočne jedinečný pre zariadenie. (pozri Posielanie požiadavky)
• Platby - počet platieb za rovnaké obdobie podľa dní.

Konverzia

Metrika konverzie sa týka hodnotenia efektívnosti vašich predajov na premenu Noví používatelia na Platby.

Graf zobrazuje pomer počtu Platby k počtu Noví používatelia, v percentách.

Aplikácie

Pri vstúpení do tejto časti sa zobrazí zoznam vašich aplikácií.

Zoznam stĺpcov v tabuľke aplikácií:

• # - jedinečný identifikátor aplikácie. Používa sa pri overovaní kódu aplikácie alebo zobrazovaní formulára platby.
• Názov - názov aplikácie. Názov sa zobrazuje len vám v správach a na nástenke. Kliknutím na názov aplikácie sa otvorí stránka úpravy aplikácie.
• Stav - aktuálny stav aplikácie. Môže to byť:
• Vytvorené - Aplikácia bola práve vytvorená, ešte nie je nastavená.
• Uvoľnené - aplikácia beží.
• Vytvorené - dátum vytvorenia aplikácie.
• Dodatočné ovládacie tlačidlá:
• Odstrániť - odstrániť aplikáciu zo zoznamu.

Vytváranie alebo úprava aplikácie

Ak chcete prijímať platby, musíte sústavne vyplniť všetky potrebné údaje aplikácie a aktivovať aplikáciu.

Tlačidlo na vytvorenie novej aplikácie sa nachádza v paneli názvu zoznamu aplikácií.

Aplikácia

Polia dostupné pri vytváraní aplikácie:

• Názov - názov aplikácie, ktorý vidíte iba vo vašich správach alebo na nástenke. Názov sa zobrazí v hlavičke stránky uloženej aplikácie. Pokiaľ aplikácia nie je uložená, namiesto názvu sa zobrazuje „Nová aplikácia“. Pole je povinné na vyplnenie.
• Kontaktný e-mail - e-mailová adresa, na ktorú sa budú posielať kópie správ odoslaných používateľom. Táto adresa je tiež špecifikovaná v poli „Odpovedať na“ a používa sa na odpoveď používateľa na prijatý e-mail s kódom. Pole je povinné na vyplnenie. Základne je pole vyplnené hodnotou z profilu vývojára. Hodnota sa môže zmeniť na inú hodnotu.
• Typ aplikácie - typ aplikácie. Ak vyberiete skupinový typ aplikácie, zobrazí sa zoznam aplikácií pre zoskupenie. V zozname sú dostupné iba jednotlivé aplikácie, pre ktoré sú generované odomykacie kódy.
• Povoliť spätnú väzbu k platbe - pridáva pole do platobného formulára, do ktorého môžu používatelia vložiť voľný text. Spätná väzba sa pridá do kópie e-mailu pre vývojára. Spätnú väzbu je možné vidieť aj v podrobnostiach o platbe.

Začnite písať, meniť hodnoty a tlačidlo Uložiť sa zobrazí. Tlačidlo Uložiť umožňuje uložiť zmeny bez prechodu na ďalšiu stránku. Tlačidlo Ďalšie uloží zmeny a prejde na ďalšiu stránku. Vždy sa môžete vrátiť a urobiť zmeny neskôr.

V hlavičke stránky sú dostupné iba stránky uloženej aplikácie na navigáciu. Môžete kliknúť na ďalšie alebo prejsť na časť v hlavičke stránky.

Popis

Vyberte jazyk zo zoznamu a kliknite na Pridať.

Zobrazí sa karta s lokalizovanými textami aplikácie pre vybraný jazyk.

Dostupné jazyky:

• Nemecký
• Anglický
• Francúzsky
• Španielsky
• Ruský
• Čínština (zjednodušená)

Polia v popise sa používajú na zobrazenie informácií v platobnom formulári a v odpovednej správe používateľovi:

• Názov - názov aplikácie pre vybraný jazyk. Zobrazuje sa na platobnom formulári a v e-maile s upozornením na platbu. Pri pridaní jazyka sa vloží predvolený názov aplikácie. Pre každý jazyk môžete nastaviť iný názov. Požadované pole.
• Popis - stručný popis aplikácie. Zobrazuje sa na platobnom formulári pod názvom aplikácie. Voliteľné pole. Môžete ho nechať prázdne, ak nechcete zobraziť žiadny popis.
• Odpoveď - dodatočné informácie, ktoré sa po úspešnej platbe odošlú používateľovi e-mailom. Text odpovede sa pridá na koniec e-mailu po štandardnej odpovedi.

Na uloženie a prejdenie na ďalšiu stránku musí byť pridaný aspoň jeden jazyk.

Jazyk zobrazený v platobnom formulári sa automaticky určuje na základe preferencií používateľa zadaných v jeho nastaveniach prehliadača. Jazyk aplikácie môžete uložiť pre aplikáciu.

Začnite písať alebo meniť hodnoty a tlačidlo Uložiť sa zobrazí. Tlačidlo Uložiť vám umožňuje uložiť zmeny bez prechodu na ďalšiu stránku. Tlačidlo Ďalšie uloží zmeny a prejde na ďalšiu stránku. Vždy sa môžete vrátiť a urobiť zmeny neskôr.

V hlavičke stránky sú dostupné iba stránky uloženej aplikácie na navigáciu. Môžete kliknúť na ďalšie alebo prejsť na časť v hlavičke stránky.

Cena

Stránka obsahuje zoznam cien a polí súvisiacich s platbou:

• Skúšobná doba - dĺžka skúšobného obdobia.
• Časová jednotka - časová jednotka skúšobného obdobia. Napríklad, ak zadáte 7 dní, znamená to, že po 7 dňoch od prvého volania API aplikácie vráti odpoveď, že skúšobné obdobie vypršalo. Čas prvého volania zariadenia je uložený.
• Metóda výpočtu ceny - Metóda výpočtu ceny zo zoznamu:
• Výpočet ceny v závislosti od obdobia - Na platobnom formulári používateľ špecifikuje aktivačné obdobie kódu a cena sa automaticky vypočíta podľa tabuľky nižšie. Používateľ dostane automaticky generovaný kód na odomknutie v odpovednom e-maile.
• Výpočet obdobia v závislosti od ceny - Na platobnom formulári používateľ vyberie cenu zo zoznamu alebo zadá svoju vlastnú hodnotu ceny a obdobie sa automaticky vypočíta podľa tabuľky nižšie. Používateľ dostane automaticky generovaný kód v odpovedi.
• Trvalý kód - Na platobnom formulári používateľ vyberie cenu zo zoznamu alebo zadá svoju vlastnú hodnotu ceny. Po platbe dostane kód zo zoznamu nižšie, ktorý zodpovedá vybranej cene, v odpovedi e-mailom.
• Dar - Na platobnom formulári používateľ vyberie cenu zo zoznamu alebo zadá svoju vlastnú hodnotu ceny. Pre aplikácie typu darovaní nie je generovaný kód na odomknutie.

Cena je nastavená v amerických dolároch. Minimálna cena je 1 americký dolár.

Začnite písať alebo meniť hodnoty a tlačidlo Uložiť sa zobrazí. Tlačidlo Uložiť vám umožňuje uložiť zmeny bez prechodu na ďalšiu stránku. Tlačidlo Ďalšie uloží zmeny a prejde na ďalšiu stránku. Vždy sa môžete vrátiť a urobiť zmeny neskôr.

V hlavičke stránky sú dostupné iba stránky uloženej aplikácie na navigáciu. Môžete kliknúť na ďalšie alebo prejsť na časť v hlavičke stránky.

Náhľad

Táto stránka nastavuje hodnoty:

• Dĺžka kódu - dĺžka generovaného kódu, ak je to vhodné.
• Znaková sada kódu - sada znakov, z ktorých je kód generovaný:
• Číselný kód - kód je generovaný použitím iba číslic 0, 1, 2, 3, 4, 5, 6, 7, 8, 9. Vedúce nuly môžu byť zahrnuté v kóde. Vedúce nuly sú významné pri overovaní kódu.
• Alfanumerický kód - kód je generovaný použitím znakov 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. Kód je vygenerovaný a odoslaný používateľovi pomocou veľkých písmen. Veľkosť písmen nie je dôležitá pri overovaní kódu.
• Odkaz na overenie kódu - príklad odkazu, ktorý sa má použiť na overenie kódu.
• Odkaz na platbu - platobný odkaz. Odkaz môžete skopírovať a vložiť do popisu aplikácie na webovej stránke, kde je aplikácia zverejnená. Prechádzajúce parametre:
• app - jedinečný identifikátor aplikácie. Požadovaný parameter.
• amount - suma, ktorá bude uvedená v poli ceny pri nákupe. Predvolená cena je ignorovaná. Suma však nemôže byť menšia ako minimálna cena a nemôže byť nižšia ako minimálna cena stanovená pre aplikáciu. Voliteľný parameter.

Na začatie prijímania platieb je potrebné aktivovať aplikáciu pomocou tlačidla Spustiť. Pred aktiváciou aplikácie sa uistite, že všetky zadané údaje sú správne. Kľúče vygenerované aplikáciou nie je možné zmeniť.

Overenie kódu

Overenie kódu na odomknutie aplikácie sa vykonáva v 3 krokoch:

1. Zápis a odoslanie požiadavky na overenie kódu
2. Kontroly na strane API
3. Prijímanie a spracovanie odpovede API

Posielanie požiadavky

Na overenie kódu musí používateľ vašej aplikácie zadať kód do poľa v nastaveniach aplikácie.

<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>

Potom musíte odoslať požiadavku na server API Pay-to-use:

function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	return Toybox.Communications.makeWebRequest(
		"https://api.pay-to-use.com", // URL API
		{
			"device" => ds.uniqueIdentifier, // jedinečný identifikátor zariadenia
			"app" => "6", // váš identifikátor aplikácie
			"model" => ds.partNumber, // číslo dielu zariadenia
			"code" => Application.Properties.getValue("UnlockCode") // hodnota kódu na odomknutie vo vašej aplikácii
		},
		{
			:method => Communications.HTTP_REQUEST_METHOD_POST,
			:headers => { "Content-Type" => Communications.REQUEST_CONTENT_TYPE_JSON },
			:responseType => Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
		},
		method(:onReceive)
	);
}

Parametre požiadavky API:

• url – https://api.pay-to-use.com. Používanie protokolu HTTPS je povinné.
• Telu požiadavky (prenášané hodnoty). Slovník kľúčov a hodnôt:
• device - jedinečný identifikátor zariadenia.
• app - jedinečný identifikátor vašej aplikácie.
• model – identifikátor modelu zariadenia. Voliteľný parameter. Údaje sa používajú na zobrazenie štatistík o nových zariadeniach.
• code - kód na odomknutie, ktorý zadal používateľ vo vašich nastaveniach aplikácie.
• Možnosti požiadavky:
• :method - API podporuje metódy požiadaviek GET a POST.
• :headers - pre metódu POST je potrebné prenášať parametre vo formáte JSON.
• :responseType - odpoveď je vrátená vo formáte JSON.
• responseCallback - odkaz na spätnú metódu, ktorá by mala prijať dva argumenty:
• responseCode - kód hlavičky odpovede servera.
• data - obsah, ak bola požiadavka úspešná, alebo null.

Kontroly na strane API

Ak sa API neprenášajú žiadne parametre, API vráti hlavičku HTTP/1.1 404 Not Found.

Ak sa aspoň jeden parameter prenesie do API, API vráti hlavičku HTTP/1.1 200 OK.

Odpoveď servera pozostáva z:

• response - kód odpovede
• msg - textový popis odpovede
• expires - časová pečiatka UNIXTIME (ak je to možné)

Vykoná sa kontrola, aby sa zabezpečilo, že identifikátor aplikácie prenášaný je správny. Aplikácia musí mať v čase platby stav Uvoľnené. V prípade chyby je vrátený kód odpovede 301.

Ak sa prenáša jedinečný identifikátor zariadenia, vyhľadá sa a uloží sa. Ak pri kontrole alebo ukladaní dochádza k chybám, vráti sa chybový kód 402. Ak sa nájde takýto návratový kód, ihneď napíšte na podporu na [email protected]

Ak je kód prenesený, pre aplikácie s metódami výpočtu Výpočet ceny v závislosti od obdobia a Výpočet obdobia v závislosti od ceny sa vykonajú nasledujúce kroky:

• Ak je prenesený prázdny kód, odpojí sa od jedinečného identifikátora zariadenia definovaného v predchádzajúcich krokoch.
• Ak sa prenesie neprázdny kód a nie je aktivovaný, kód sa aktivuje v závislosti na podmienkach ceny uvedenej pri nákupe kódu, bez ohľadu na dátum aktivácie.
• Ak nebol prenesený žiadny kód alebo ak sa prenesený kód nenašiel, vráti sa chybový kód 201.
• Aktivovaný kód sa skontroluje proti zariadeniu a ak bol počas aktivácie prenesený jedinečný identifikátor zariadenia iný ako uložený, vráti sa chybový kód 202.
• Ak prenesený kód nemá dátum expirácie a všetky predchádzajúce kontroly boli úspešné, vráti sa kód 101.
• Ak je kód časovo obmedzený, vykoná sa kontrola. Ak kľúč nie je expirovaný, vráti sa kód 101. Ak kód expiroval, vráti sa chybový kód 203.
• Tento typ aplikácie vyžaduje, aby bol kód viazaný na zariadenie. Ak sa neprenesie jedinečný identifikátor zariadenia, vráti sa chybový kód 304.

Pre aplikáciu s Trvalý kód sa kontroluje iba dostupnosť kódu v čase nákupu. Ak sa nájde kód, vráti sa kód 101. Ak sa žiadny kód nenájde, vráti sa chybový kód 201.

Pre aplikáciu s metódou výpočtu Dar sa kód nekontroluje. Vráti sa vždy kód 101.

Ak predchádzajúce kontroly neboli úspešné, skontroluje sa testovacie obdobie. Ak uplynulo viac času od prvotného kontaktu so zariadením než je aktuálna konfigurácia aplikácie, vráti sa chybový kód 204. Ak skúšobné obdobie ešte neuplynulo, vráti sa chybový kód 102.

Ak sa prenáša iba identifikátor aplikácie a neprenesie sa ani kľúč na odomknutie ani jedinečný identifikátor zariadenia, vráti sa chybový kód 303.

Ak vrátená odpoveď je 500, mali by ste napísať na podporu na [email protected]

Nižšie je tabuľka všetkých vrátených kódov:

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

{
	"response":101,
	"msg":"Active until 5 Sep 2026",
	"expires":1788642993
}

{
	"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 7h 23m",
	"expires":1779511212
}

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

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

{
	"response":203,
	"msg":"Expiration: 23 Apr 2026",
	"expires":1776978993
}

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

Kontrola odpovede

Potom by ste mali skontrolovať odpoveď zo servera Pay-to-use API:

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

Môžete skontrolovať všetky záhlavia a kódy, môžete zobraziť vlastné správy pre pohodlie používateľa, ale v najjednoduchšej forme bude overenie vyzerať niečo ako toto:

function onBackgroundData(data) as Void {
	if (data.hasKey("response")) {
		if (data.hasKey("msg")) {
			// Môžete zobraziť data["msg"] v poli vlastností s názvom "UnlockResult".
			Application.Properties.setValue("UnlockResult", data["msg"]);
		}
		if (data["response"].toString().substring(0, 1).equals("2")) {
			// Overenie kódu zlyhalo
			// Platené funkcie NIE sú k dispozícii
			...
		} else {
			// Kontrola kódu bola úspešná alebo chyba je vaša vina alebo vina API
			// Platené funkcie sú k dispozícii
			...
		}
	}
}

Odomknúť kódy

Po prejdení na túto sekciu sa otvorí zoznam odblokovacích kódov.

Zoznam kódov na odomknutie

Môžete vyhľadávať v poli e-mailu alebo kódu v hornej vyhľadávacej lište. Nájdené kódy budú zobrazené v zozname. Môžete použiť celý alebo časť e-mailu alebo kódu ako kritérium vyhľadávania. Zhody budú zvýraznené farbou. Vyhľadávanie a filtre fungujú súčasne a nevylučujú sa navzájom.

Posledný použitý filter je uložený pre používateľa. To znamená, že pri ďalšej návšteve stránky sa posledný použitý filter automaticky aplikuje. Filtry sú k dispozícii pre zoznam odblokovacích kódov:

• Stĺpce - vyberte stĺpce tabuľky, ktoré sa majú zobraziť v zozname odblokovacích kódov.
• Aplikácia - zobraziť len odblokovacie kódy pre vybrané aplikácie.
• Stav - zobraziť len odblokovacie kódy, ktoré sú vo vybraných stavoch.

Zoznam stĺpcov v tabuľke odblokovacích kódov:

• Aplikácia - vaša aplikácia. Môžete kliknúť na odkaz, aby ste upravili jej nastavenia.
• Kód - odblokovací kód.
• Email - e-mailová adresa spojená s registráciou odblokovacieho kódu. Táto adresa sa používa na vyhľadávanie odblokovacích kódov klienta v Moje nákupy časti webovej stránky. Táto časť je prístupná používateľom.
• Obdobie - obdobie platnosti odoslaného kódu (špecifikované v nastaveniach aplikácie). Platnosť je nastavená pre kód v súlade s podmienkami nastavení aplikácie v čase jeho vytvorenia.
• Stav - stav odblokovacieho kódu. (pozri Stav odblokovacieho kódu)
• Vytvorené - dátum vytvorenia odblokovacieho kódu.
• Aktivované - dátum aktivácie kódu. Je nastavený v momente, keď sa toto konkrétne zariadenie používateľa prvýkrát pripojí k službe PayToUse API a odošle tento kód. Stav kódu sa zmení na Aktivované. Len neaktívny kód môže byť aktivovaný. Ak aktívny kód odosia zariadenie s odlišným identifikátorom, API vráti chybu 202. Len jedno zariadenie môže byť prepojené s jediným kódom.
• Vypršanie - dátum, kedy vyprší platnosť aktivácie kódu. Nastavuje sa pre kódy, ktoré majú obmedzenú platnosť pri aktivácii kódu. Pre kódy s neobmedzeným vypršaním platnosti je dátum nevyplnený.
• Odstránené - dátum vymazania kódu. Po vymazaní je stav kódu nastavený na Neznáme.
• Platba # - jedinečné poradové číslo platby. Kliknutím na odkaz môžete zobraziť podrobnosti platby.
• Tlačidlá pre akcie s odblokovacími kódmi. Napríklad vymazanie.

Stav odblokovacieho kódu

Počas svojho životného cyklu odblokovací kód prechádza rôznymi stavmi, ktoré môžu byť sledované pomocou stavu kódu.

Platby

Pri prechode do tejto sekcie sa zobrazí zoznam platieb používateľa.

Na prijímanie platieb sa používajú nasledujúce platobné systémy:

Po zaplatení poplatkov platobného systému PayToUse účtuje poplatok vo výške 13%. Neustále pracujeme na znižovaní poplatkov.

Ak vzniknú v platobnom systéme akékoľvek spory alebo vrátenia, sankcie platobného systému sú znovu vystavené vývojárovi. Preto by ste nemali povoliť, aby sa takéto situácie vyskytli. Poplatok PayToUse sa neúčtuje v sporných situáciách.

Zoznam platieb

Môžete vyhľadávať v poli e-mailu alebo odoslaného kódu v hornej vyhľadávacej lište. Nájdené platby sa zobrazia v zozname. Môžete použiť celý alebo časť e-mailu alebo odoslaného kódu ako kritérium vyhľadávania. Zhody sa zvýraznia farebne. Vyhľadávanie a filtre fungujú súčasne a nevylučujú sa navzájom.

Posledný použitý filter sa ukladá pre používateľa. To znamená, že pri nasledujúcej návšteve stránky sa posledný použitý filter automaticky aplikuje. Filtre sú k dispozícii pre zoznam platieb:

• Stĺpce - vyberte stĺpce tabuľky, ktoré chcete zobraziť v zozname platieb.
• Aplikácia - zobrazovanie platieb iba pre vybrané aplikácie.
• Systém - zobraziť platby iba z vybraných platobných systémov.
• Stav - zobraziť platby iba s vybranými stavmi.

Zoznam stĺpcov v tabuľke platieb:

• Aplikácia - vaša aplikácia. Môžete kliknúť na odkaz, aby ste upravili jej nastavenia.
• # - jedinečné poradové číslo platby. Automaticky sa priradí k platbe, keď používateľ prejde z formulára platby na stránku platby v platobnom systéme. Kliknite na odkaz, aby ste zobrazili podrobnosti platby.
• Komentáre - správa od používateľa zadaná do formulára platby.
• Systém - platobný systém vybraný používateľom.
• Stav - stav platby. (pozri Stav platby)
• Email - e-mail používateľa uvedený vo formulári platby.
• Obdobie - platnosť odoslaného kódu (určená v nastaveniach aplikácie).
• Vytvorené - dátum vytvorenia platby.
• Čiastka faktúry - suma platby účtovanej používateľovi. Špecifikovaná vo formulári platby v závislosti na nastaveniach aplikácie.
• Dátum platby - dátum platby.
• Čiastka platby - suma platby potvrdená platobným systémom.
• Odoslaný kód - kód odoslaný používateľovi.
• Dostupná suma - dostupná čiastka na výber.
• Čiastka výberu - čiastka vybratých prostriedkov za platbu.

Nie je možné meniť platbu.

Stav platby

Počas svojho životného cyklu platba prechádza rôznymi stavmi, ktoré možno sledovať podľa stavu platby.

Výbery

Po prejdení do tejto sekcie sa zobrazí zoznam vašich výberov.

Zoznam výberov

Posledné použité filtre sa ukladajú pre používateľa. To znamená, že pri ďalšej návšteve stránky sa posledný použitý filter automaticky aplikuje. Filtre sú k dispozícii pre zoznam výberov:

• Stĺpce - zobraziť iba vybrané stĺpce v zozname výberov.
• Stav - zobraziť iba výbery, ktoré sú vo vybraných stavoch.

Zoznam stĺpcov v tabuľke výberov:

• # - jedinečné poradové číslo výberu. Priradí sa výberu automaticky pri jeho uložení. Kliknite na odkaz pre zobrazenie detailov výberu.
• Stav - stav výberu. (pozri Stav výberu)
• Vytvorené - dátum požiadavky na výber.
• Suma - suma výberu.
• Výber - dátum odoslania výberu.
• Tlačidlá pre akcie s výbermi. Napríklad potvrdenie.

Výber môžete potvrdiť, keď je vo stav Odoslané.

Stav výberu

Počas svojho životného cyklu sa výber dostane do rôznych stavov, ktoré možno sledovať podľa stavu výberu.

API

Prehľad

Rozhranie API PayToUse plní nasledujúce funkcie:

1. Skontroluje stav aktivácie odblokovacieho kódu a v prípade potreby ho aktivuje.
2. Načíta údaje o hladine glukózy v krvi z aplikácie NightScout.
3. Načíta aktuálne údaje o počasí pre zadanú lokalitu.

Všetky informácie je možné vyžiadať a vrátiť v rámci jednej požiadavky.

Koncové body API

Môžete použiť jeden z nasledujúcich koncových bodov:

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

Oba koncové body spracúvajú požiadavky typu GET aj POST.

Parametre požiadavky

• device: reťazec (požadované) — jedinečný identifikátor zariadenia
• app: integer (požadované) — ID vašej žiadosti
• model: reťazec (voliteľné) — kód modelu zariadenia, potrebný na zber a zobrazenie štatistík o zariadeniach, ktoré používajú túto aplikáciu
• code: reťazec (voliteľné) — odblokovací kód
• bg: asociatívne pole (voliteľné) — údaje potrebné na vyžiadanie hodnôt hladiny glukózy v krvi z aplikácie NightScout
• url: reťazec (voliteľné) — adresa aplikácie NightScout
• weather: asociatívne pole (voliteľné) — údaje potrebné na zistenie aktuálneho počasia
• appid: reťazec (voliteľné) — prístupový kľúč k rozhraniu API pre počasie
• lat: na pohyblivej čiarke (voliteľné) — zemepisná šírka
• lon: na pohyblivej čiarke (voliteľné) — zemepisná dĺžka
• provider: integer (voliteľné) — poskytovateľ informácií o počasí

Zoznam podporovaných poskytovateľov meteorologických údajov

1. OpenWeatherMap

• Popis: OpenWeatherMap poskytuje globálne meteorologické údaje, vrátane aktuálneho počasia, historických údajov a 16-dňových predpovedí. Vďaka širokému geografickému pokrytiu a častým aktualizáciám je OpenWeatherMap obľúbenou voľbou pre aplikácie, ktoré vyžadujú ako aktuálne informácie o počasí, tak aj dlhodobé predpovede.
• Poskytnuté údaje: Teplota, vlhkosť, rýchlosť vetra, kvalita ovzdušia, pravdepodobnosť zrážok a ďalšie údaje v reálnom čase. Ponúka aktuálne údaje aj predpovede, vrátane minútových údajov o počasí pre vybrané lokality.
• Výber poskytovateľa: Do časti vašej požiadavky týkajúcej sa počasia vložte parameter provider=1, aby ste ako poskytovateľa informácií o počasí vybrali OpenWeatherMap.
• Pokyny na použitie: Ponúka bezplatnú aj platenú verziu, pričom k údajom je možné pristupovať prostredníctvom overenia pomocou API kľúča. V platených balíkoch sú k dispozícii pokročilé vrstvy údajov a prémiové funkcie.
• API Documentation: K dispozícii tu.

2. QWeather

• Popis: Aplikácia QWeather, známa aj pod názvom HeWeather, poskytuje komplexné údaje o počasí so zameraním na Čínu, obsahuje však aj údaje zo zahraničia. Ponúka podrobné informácie, ako sú aktuálne počasie, predpovede, informácie o kvalite ovzdušia a výstrahy.
• Poskytnuté údaje: Aktuálna teplota, vlhkosť, UV index, úroveň znečistenia, denné a hodinové predpovede, ako aj varovania pred nepriaznivými poveternostnými podmienkami. Aplikácia je známa podrobnými údajmi o kvalite ovzdušia a aktualizáciami v reálnom čase o meniacich sa poveternostných podmienkach.
• Výber poskytovateľa: Do časti vašej požiadavky týkajúcej sa počasia vložte parameter provider = 2, aby ste ako poskytovateľa informácií o počasí vybrali službu QWeather.
• Pokyny na použitie: QWeather ponúka prístup cez API v bezplatnej a prémiovej verzii. Bezplatná verzia poskytuje obmedzené množstvo údajov, zatiaľ čo prémiové možnosti zahŕňajú ďalšie údaje a lokality.
• API Documentation: K dispozícii tu.

3. MET Weather (MET Norway)

• Popis: Rozhranie MET Weather API, ktoré poskytuje organizácia MET Norway, ponúka prístup k širokej škále verejne dostupných meteorologických údajov, vrátane predpovedí, historických údajov a špecifických údajov pre Nórsko a severské regióny. Vďaka svojej presnosti a transparentnosti je MET Weather ideálnym riešením pre aplikácie, ktoré vyžadujú vysoko spoľahlivé meteorologické údaje.
• Poskytnuté údaje: Aktuálne poveternostné podmienky, predpovede, zrážky, teplota, údaje o vetre a UV index. MET Weather ponúka špecializované údaje pre severské regióny, ale poskytuje aj globálne informácie o počasí.
• Výber poskytovateľa: Do časti vašej požiadavky týkajúcej sa počasia vložte parameter provider = 3, aby ste ako poskytovateľa informácií o počasí vybrali službu MET Weather.
• Pokyny na použitie: Všetky údaje poskytované spoločnosťou MET Weather sú voľne dostupné na použitie na základe licencie Creative Commons, ktorá bezplatne umožňuje ich využitie na nekomerčné aj komerčné účely. Spoločnosť MET Norway je známa svojimi environmentálnymi údajmi, vďaka čomu je dôveryhodným poskytovateľom najmä v Európe.
• API Documentation: K dispozícii tu.

Príklad požiadavky

function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	if (!ds.phoneConnected) { // Skontroluje, či je zariadenie pripojené k telefónu na odoslanie požiadavky
		return;
	}

	var id = ds.uniqueIdentifier;
	if (id == null) { // Overí, či bolo zariadeniu pridelené jedinečné identifikačné číslo
		return;
	}

	var request = {};

	var lockCheck = Application.Storage.getValue("LastCodeCheckTimestamp");
	if (lockCheck == null || lockCheck <= Time.now().value()) { // V prípade potreby odošle kód
		request.put("code", Application.Properties.getValue("UnlockCode"));
	}

	var ns_url = Application.Properties.getValue("NS");
	if (!ns_url.equals("")) { // V prípade potreby odošle URL aplikácie NightScout
		request.put("bg", { "url" => ns_url });
	}

	var wP = Application.Properties.getValue("Weather");
	if (wP != 0) { // V prípade potreby odošle parametre požiadavky na počasie
		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()) {

		// Vyplní požadované parametre požiadavky
		request.put("device", id);
		request.put("app", p2uAppID); // váš identifikátor aplikácie
		request.put("model", ds.partNumber);

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

Odpoveď API

Rozhranie API vráti objekt JSON s informáciami o stave odomknutia, hladine glukózy a počasí.

Parametre odpovede

Výsledky overenia odblokovacieho kódu (ak bola odoslaná žiadosť):

• response: integer — kód návratu
• msg: reťazec — správa o výsledku overenia
• expires: integer — časová pečiatka vypršania platnosti kódu vo formáte UNIXTIMESTAMP
• qr: array — QR kód na nákup alebo overenie sériového čísla (ak je to potrebné)

Odpoveď aplikácie NightScout (ak bola odoslaná požiadavka):

• bg: asociatívne pole — formátovaná odpoveď z aplikácie NightScout
• value: integer — hladina glukózy v krvi v mg/dl
• date: integer — časová pečiatka vypršania platnosti kódu vo formáte UNIXTIMESTAMP
• direction: reťazec — trend zmien hladiny glukózy v krvi

Odpoveď rozhrania API pre počasie (ak bola odoslaná požiadavka):

• weather: asociatívne pole — formátovaná odpoveď z rozhrania Weather API
• provider: integer — identifikátor poskytovateľa informácií o počasí
• weather: array — aktuálne poveternostné podmienky. Môže vrátiť jednu alebo dve hodnoty; ak sa vrátia dve hodnoty, predstavujú denné a nočné podmienky
• temp: na pohyblivej čiarke — aktuálna teplota v stupňoch Celzia
• feels_like: na pohyblivej čiarke — pocitová teplota v stupňoch Celzia
  Внимание! Отсутствует для MET Norway
• pressure: integer — atmosférický tlak v hPa
• humidity: integer — vlhkosť v %
• precipitation: integer — pravdepodobnosť zrážok v %
  Внимание! Отсутствует для MET Norway
• wind: integer — smer vetra v stupňoch
• wind_speed: na pohyblivej čiarke — rýchlosť vetra v m/s
• temp_low: na pohyblivej čiarke — dnešná najnižšia teplota v stupňoch Celzia
• temp_high: na pohyblivej čiarke — dnešná najvyššia teplota v stupňoch Celzia
• sunrise_today: integer — časový údaj dnešného východu slnka vo formáte UNIXTIMESTAMP
• sunset_today: integer — časový údaj dnešného západu slnka vo formáte UNIXTIMESTAMP
• sunrise_tomorrow: integer — časový údaj o zajtrajšom východe slnka vo formáte UNIXTIMESTAMP
• sunset_tomorrow: integer — časový údaj o zajtrajšom západe slnka vo formáte UNIXTIMESTAMP
• aqi: asociatívne pole — index kvality ovzdušia
• level: integer — hodnota indexu kvality ovzdušia
• value: integer — hodnota indexu kvality ovzdušia

Príklad odpovede

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

Poznámky

• Žiadosti s bg vyžadujú pripojenie k aplikácii NightScout.
• Pri každej požiadavke obsahujúcej kód API automaticky skontroluje stav kódu a v prípade, že je neaktívny, ho aktivuje.
• Upozorňujeme, že parametre API sa môžu v priebehu času aktualizovať alebo upravovať s cieľom zlepšiť funkčnosť, kompatibilitu a bezpečnosť. Odporúčame pravidelne preverovať dokumentáciu API, či nedošlo k zmenám, ktoré by mohli ovplyvniť integráciu alebo používanie.

Garmin

Podrobný popis funkcií a konštánt súvisiacich s počasím v rámci Garmin SDK nájdete na tomto odkaze. V závislosti od zvoleného poskytovateľa informácií o počasí môžete ukladať hodnoty získané z API alebo výsledky funkcií Garmin SDK súvisiacich s počasím, aby ste zabezpečili konzistentnosť zobrazenia hodnôt na obrazovke.

Otvoriť mapu počasia

Pozrite si napríklad sadu ikon pre OpenWeatherMap tu.

QPočasie

Pôvodnú sadu ikon počasia si môžete pozrieť kliknutím sem

Počasie podľa MET

Pozrite si tu ako príklad sadu ikon pre aplikáciu MET Weather.