Manuale

Introduzione

La barra laterale sinistra contiene collegamenti alle sezioni corrispondenti:

• Nome utente - collegamenti al profilo personale.
• Dashboard - visualizza lo stato attuale sotto forma di grafici.
• Applicazioni - gestione dell'applicazione.
• Sblocca codici - codici di sblocco generati automaticamente o scaricati da te.
• Pagamenti - cronologia dei pagamenti in entrata degli utenti.
• Manuale - il manuale utente attuale.

Dashboard

È possibile impostare filtri comuni per tutti i widget nel cruscotto:

• Valuta - la valuta in cui saranno convertite le entrate e le uscite nel cruscotto.
• Periodo - è il periodo di tempo per il quale i dati vengono visualizzati nei grafici e nelle tabelle nel cruscotto. Determina l'intervallo durante il quale le informazioni e le statistiche su pagamenti, applicazioni e altri parametri vengono analizzate e visualizzate.

Saldo

Il saldo include le seguenti cifre:

• Importo lordo - l'importo totale di tutti i pagamenti degli utenti per il periodo selezionato escludendo le commissioni dei sistemi di pagamento e PayToUse.
• Importo netto - l'importo totale di tutti i pagamenti per il periodo selezionato meno le commissioni dei sistemi di pagamento e PayToUse.
• Importo in sospeso - l'importo totale di tutti i pagamenti per il periodo specificato meno le commissioni dei sistemi di pagamento e PayToUse in attesa di ritiro sul conto dello sviluppatore. Il pagamento diventa disponibile per il prelievo 7 giorni dopo il pagamento.
• Importo disponibile - l'importo totale di tutti i pagamenti di sempre meno le commissioni dei sistemi di pagamento e PayToUse, disponibile per il prelievo sul conto dello sviluppatore.

Pagamenti

Il widget Pagamenti include una tabella dei pagamenti raggruppati per applicazione per il periodo selezionato.

Campi della tabella:

• Applicazione - applicazione. Vengono visualizzate solo le applicazioni per le quali sono stati effettuati pagamenti durante il periodo selezionato.
• Pagamenti - numero di pagamenti.
• Importo lordo - l'importo totale di tutti i pagamenti degli utenti per il periodo selezionato escludendo le commissioni dei sistemi di pagamento e PayToUse.
• Importo netto - l'importo totale di tutti i pagamenti per il periodo selezionato meno le commissioni dei sistemi di pagamento e PayToUse.

Il grafico mostra la dinamica dei valori Importo netto e Importo lordo per giorno.

Nuovi utenti

Il grafico dei nuovi utenti mostra due valori in dinamica per giorno:

• Nuovi utenti - il numero di nuove chiamate API. Gli accessi API vengono registrati solo se il parametro device - un identificatore unico del dispositivo - viene passato durante l'invio di una richiesta all'API. Questo parametro deve essere veramente unico per il dispositivo. (vedi Invio di una richiesta)
• Pagamenti - il numero di pagamenti nello stesso periodo per giorno.

Conversione

La metrica Conversione si riferisce alla valutazione dell'efficienza delle tue vendite nel convertire Nuovi utenti in Pagamenti.

Il grafico mostra il rapporto tra il numero di Pagamenti e il numero di Nuovi utenti, in percentuale.

Applicazioni

Quando vai in questa sezione, si apre un elenco delle tue applicazioni.

L'elenco delle colonne nella tabella delle applicazioni:

• # - identificatore unico dell'applicazione. Utilizzato durante la verifica del codice dell'applicazione o nella visualizzazione del modulo di pagamento.
• Nome - nome dell'applicazione. Il nome viene visualizzato solo a te nei report e nel dashboard. Cliccando sul nome dell'applicazione si apre la pagina di modifica dell'applicazione.
• Stato - lo stato attuale dell'applicazione. Può essere:
• Creato - L'applicazione è stata appena creata, non è ancora configurata.
• Rilasciato - l'applicazione è in esecuzione.
• Creato - la data di creazione dell'applicazione.
• Pulsanti di controllo aggiuntivi:
• Elimina - per rimuovere l'applicazione dall'elenco.

Creazione o modifica di un'applicazione

Per accettare pagamenti, è necessario compilare in modo coerente tutti i dati necessari dell'applicazione e attivare l'applicazione.

Il pulsante per creare una nuova applicazione si trova nella barra del titolo dell'elenco delle applicazioni.

Applicazione

Campi disponibili durante la creazione di un'applicazione:

• Nome - il nome dell'applicazione visibile solo nei report o nel dashboard. Il nome sarà visualizzato nell'intestazione della pagina dell'applicazione salvata. Fino a quando l'applicazione non è salvata, al posto del nome viene visualizzato "Nuova app". Il campo è obbligatorio.
• Email di contatto - l'indirizzo email a cui verranno inviate le copie dei messaggi inviati agli utenti. Questo indirizzo è specificato anche nel campo "Rispondi a" e viene utilizzato per rispondere all'utente all'email ricevuta con il codice. Il campo è obbligatorio. Per impostazione predefinita, il campo è popolato con il valore dal profilo dello sviluppatore. Il valore può essere cambiato.
• Tipo di applicazione - tipo di applicazione. Se si seleziona un tipo di applicazione di gruppo, verrà visualizzato un elenco di applicazioni per il raggruppamento. Saranno disponibili solo le singole applicazioni per le quali sono generati i codici di sblocco.
• Consenti feedback sul pagamento - aggiunge un campo al modulo di pagamento per consentire agli utenti di inserire testo libero. Il feedback viene aggiunto alla copia dell'email del sviluppatore. Il feedback può anche essere visualizzato nei dettagli del pagamento.

Inizia a digitare cambiando i valori e compare il pulsante Salva. Il pulsante Salva ti permette di salvare le modifiche senza passare alla pagina successiva. Il pulsante Avanti salva le modifiche e passa alla pagina successiva. Puoi sempre tornare indietro per apportare modifiche in seguito.

Nell'intestazione della pagina sono disponibili solo le pagine delle applicazioni salvate per la navigazione. Puoi fare clic su Avanti o andare alla sezione nell'intestazione della pagina.

Descrizione

Seleziona una lingua dall'elenco e clicca su Aggiungi.

Verrà visualizzata una scheda con i testi localizzati dell'applicazione per la lingua selezionata.

Lingue disponibili:

• Tedesco
• Inglese
• Francese
• Spagnolo
• Russo
• Cinese semplificato

I campi nella descrizione sono utilizzati per visualizzare informazioni nel modulo di pagamento e nel messaggio di risposta all'utente:

• Nome - il nome dell'applicazione per la lingua selezionata. Viene visualizzato nel modulo di pagamento e nell'email di notifica del pagamento. Per impostazione predefinita, quando si aggiunge una lingua, viene inserito il nome dell'applicazione. È possibile impostare un nome diverso per ogni lingua. Campo obbligatorio.
• Descrizione - una breve descrizione dell'applicazione. Visualizzata nel modulo di pagamento sotto il nome dell'applicazione. Campo opzionale. Puoi lasciarlo vuoto se non vuoi che venga visualizzata alcuna descrizione.
• Rispondi - informazioni aggiuntive che verranno inviate all'utente via email al termine del pagamento. Il testo di risposta è aggiunto alla fine dell'email dopo la risposta standard.

Devi aggiungere almeno una lingua per salvare e procedere alla pagina successiva.

La lingua visualizzata nel modulo di pagamento è determinata automaticamente in base alle preferenze dell'utente specificate nelle impostazioni del browser. Puoi salvare la lingua dell'applicazione per l'applicazione stessa.

Inizia a digitare o a cambiare i valori e compare il pulsante Salva. Il pulsante Salva ti permette di salvare le modifiche senza passare alla pagina successiva. Il pulsante Avanti salva le modifiche e passa alla pagina successiva. Puoi sempre tornare indietro per apportare modifiche in seguito.

Nell'intestazione della pagina sono disponibili solo le pagine delle applicazioni salvate per la navigazione. Puoi fare clic su Avanti o andare alla sezione nell'intestazione della pagina.

Prezzo

La pagina contiene un elenco di prezzi e campi correlati al pagamento:

• Periodo di prova - durata del periodo di prova.
• Unità di tempo - l'unità di tempo del periodo di prova. Ad esempio, se si specificano 7 giorni, significa che dopo 7 giorni dalla prima chiamata API dell'applicazione restituirà una risposta che il periodo di prova è scaduto. Viene salvato il tempo della prima chiamata del dispositivo.
• Metodo di calcolo del prezzo - Il metodo di calcolo del prezzo dall'elenco:
• Calcolo del prezzo in base al periodo - Nel modulo di pagamento, l'utente specifica il periodo di attivazione del codice e il prezzo è calcolato automaticamente secondo la tabella sottostante. L'utente riceve un codice di sblocco generato automaticamente nella email di risposta.
• Calcolo del termine in base al prezzo - Nel modulo di pagamento, l'utente seleziona un prezzo dall'elenco o inserisce il proprio valore, e il periodo viene calcolato automaticamente secondo la tabella sottostante. L'utente riceve un codice generato automaticamente nel messaggio di risposta.
• Codice permanente - Nel modulo di pagamento, l'utente seleziona un prezzo dall'elenco o inserisce il proprio valore. Dopo il pagamento, ricevono un codice dall'elenco sottostante, corrispondente al prezzo selezionato, nella email di risposta.
• Donazione - Nel modulo di pagamento, l'utente seleziona un prezzo dall'elenco o inserisce il proprio valore. Per le applicazioni di tipo Donazione, non viene generato un codice di sblocco.

Il prezzo è impostato in dollari statunitensi. Il prezzo minimo è di 1 dollaro statunitense.

Inizia a digitare o a cambiare i valori e compare il pulsante Salva. Il pulsante Salva ti permette di salvare le modifiche senza passare alla pagina successiva. Il pulsante Avanti salva le modifiche e passa alla pagina successiva. Puoi sempre tornare indietro per apportare modifiche in seguito.

Nell'intestazione della pagina sono disponibili solo le pagine delle applicazioni salvate per la navigazione. Puoi fare clic su Avanti o andare alla sezione nell'intestazione della pagina.

Anteprima

Questa pagina imposta i valori:

• Lunghezza del codice - lunghezza del codice generato, se applicabile.
• Set di caratteri del codice - insieme di caratteri da cui è generato il codice:
• Codice numerico - il codice è generato utilizzando solo le cifre da 0 a 9. Possono essere inclusi zeri iniziali nel codice. Gli zeri iniziali sono significativi durante la verifica del codice.
• Codice alfanumerico - il codice è generato utilizzando i caratteri 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. Il codice è generato e inviato all'utente utilizzando caratteri maiuscoli. Il case dei caratteri non è importante durante la verifica del codice.
• Collegamento per controllare il codice - un esempio di link da utilizzare per la verifica del codice.
• Collegamento per pagare - link di pagamento. È possibile copiare il link e incollarlo nella descrizione dell'applicazione sul sito web dove l'applicazione è pubblicata. Parametri da passare:
• app - l'identificatore unico dell'applicazione. Parametro obbligatorio.
• amount - l'importo che verrà specificato nel campo prezzo durante l'acquisto. Il prezzo predefinito viene ignorato. Tuttavia, l'importo non può essere inferiore al prezzo minimo e non può essere inferiore al prezzo minimo impostato per l'applicazione. Parametro opzionale.

Per iniziare ad accettare pagamenti, è necessario attivare l'applicazione con il pulsante Avvia. Prima di attivare l'applicazione, assicurati che tutti i dati inseriti siano corretti. Le chiavi generate dall'applicazione non possono essere cambiate.

Verifica del codice

Il controllo del codice di sblocco dell'applicazione avviene in 3 fasi:

1. Scrittura e invio di una richiesta di verifica del codice
2. Controlli sul lato API
3. Ricezione e elaborazione della risposta dell'API

Invio di una richiesta

Per verificare il codice, l'utente della tua applicazione deve inserirlo nel campo nelle impostazioni dell'applicazione.

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

Quindi è necessario inviare una richiesta al 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, // identificatore univoco del dispositivo
			"app" => "6", // ID della tua Applicazione
			"model" => ds.partNumber, // codice articolo del dispositivo
			"code" => Application.Properties.getValue("UnlockCode") // valore del codice di sblocco nella tua applicazione
		},
		{
			:method => Communications.HTTP_REQUEST_METHOD_POST,
			:headers => { "Content-Type" => Communications.REQUEST_CONTENT_TYPE_JSON },
			:responseType => Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
		},
		method(:onReceive)
	);
}

Parametri della richiesta API:

• url - https://api.pay-to-use.com. L'uso del protocollo HTTPS è obbligatorio.
• Corpo della richiesta (i valori passati). Un dizionario di chiavi e valori:
• device - identificatore unico del dispositivo.
• app - identificatore unico della tua applicazione.
• model - identificatore del modello del dispositivo. Parametro facoltativo. I dati vengono utilizzati per visualizzare le statistiche relative ai nuovi dispositivi.
• code - codice di sblocco inserito dall'utente nelle impostazioni della tua applicazione.
• Opzioni di richiesta:
• :method - l'API supporta i metodi di richiesta GET e POST.
• :headers - per il metodo POST, i parametri devono essere passati nel formato JSON.
• :responseType - la risposta è restituita in formato JSON.
• responseCallback - un link al metodo di callback, che dovrebbe accettare due argomenti:
• responseCode - il codice di intestazione della risposta del server.
• data - il contenuto se la richiesta è stata completata con successo, altrimenti nullo.

Controlli sul lato API

Se non vengono passati parametri all'API, l'API restituisce un'intestazione HTTP/1.1 404 Not Found.

Se almeno un parametro viene passato all'API, l'API restituisce l'intestazione HTTP/1.1 200 OK.

La risposta del server consiste in:

• response - codice di risposta
• msg - descrizione testuale della risposta
• expires - timestamp UNIXTIME (se applicabile)

Viene eseguito un controllo per garantire che l'identificatore dell'applicazione passato sia corretto. L'applicazione deve essere nello stato Rilasciato al momento del pagamento. In caso di errore, viene restituito il codice di risposta 301.

Se viene trasmesso un ID dispositivo unico, viene cercato e memorizzato l'ID dispositivo. Se si verificano errori durante il controllo o il salvataggio, viene restituito il codice di errore 402. Se viene trovato un codice di ritorno del genere, scrivere immediatamente a supporto su [email protected]

Se il codice viene passato, vengono eseguiti i seguenti passaggi per le applicazioni con i metodi di calcolo Calcolo del prezzo in base al periodo e Calcolo del termine in base al prezzo:

• Se viene trasmesso un codice vuoto, viene staccato dall'identificatore unico del dispositivo definito nei passaggi precedenti.
• Se viene trasmesso un codice non vuoto e non è attivato, il codice viene attivato a seconda delle condizioni del prezzo specificate al momento dell'acquisto del codice, indipendentemente dalla data di attivazione.
• Se non viene trasmesso alcun codice o se il codice trasmesso non viene trovato, viene restituito il codice di errore 201.
• Il codice attivato viene controllato rispetto al dispositivo e, se durante l'attivazione è stato trasmesso un identificatore unico del dispositivo diverso da quello memorizzato, viene restituito il codice di errore 202.
• Se il codice trasmesso non ha una data di scadenza e tutti i controlli precedenti sono stati superati, viene restituito il codice 101.
• Se il codice è a tempo limitato, viene eseguito un controllo. Se la chiave non è scaduta, viene restituito il codice 101. Se il codice è scaduto, viene restituito il codice di errore 203.
• Questo tipo di applicazione richiede che il codice sia vincolato al dispositivo. Se l'ID dispositivo unico non è stato trasmesso, viene restituito il codice di errore 304.

Per un'applicazione con un metodo di calcolo Codice permanente, viene verificata solo la disponibilità del codice al momento dell'acquisto. Se viene trovato un codice, viene restituito il codice 101. Se non viene trovato alcun codice, viene restituito il codice di errore 201.

Per un'applicazione con il metodo di calcolo Donazione, il codice non viene verificato. Il codice 101 viene sempre restituito.

Se i controlli precedenti non sono stati superati, viene verificato il periodo di prova. Se è trascorso più tempo dal primo contatto del dispositivo rispetto alle impostazioni correnti dell'applicazione, viene restituito il codice di errore 204. Se il periodo di prova non è ancora scaduto, viene restituito il codice di errore 102.

Se viene trasmesso solo l'ID dell'applicazione e non vengono trasmessi né il codice di sblocco né l'ID dispositivo unico, viene restituito il codice di errore 303.

Se la risposta restituita è 500, è necessario scrivere al supporto su [email protected]

Di seguito è riportata una tabella di tutti i codici restituiti:

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

{
	"response":101,
	"msg":"Active until 20 Jan 2027",
	"expires":1800479890
}

{
	"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 17h 47m",
	"expires":1779635125
}

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

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

{
	"response":203,
	"msg":"Expiration: 1 May 2026",
	"expires":1777670290
}

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

Verifica della risposta

Quindi è necessario verificare la risposta dal server API Pay-to-use:

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

È possibile controllare tutte le intestazioni e i codici, è possibile visualizzare i propri messaggi per la comodità dell'utente, ma nella forma più semplice la verifica avrà un aspetto simile a questo:

function onBackgroundData(data) as Void {
	if (data.hasKey("response")) {
		if (data.hasKey("msg")) {
			// Puoi mostrare data["msg"] nel campo delle proprietà con il nome "UnlockResult".
			Application.Properties.setValue("UnlockResult", data["msg"]);
		}
		if (data["response"].toString().substring(0, 1).equals("2")) {
			// Verifica del codice fallita
			// Le funzioni a pagamento NON sono disponibili
			...
		} else {
			// La verifica del codice è stata completata con successo o l'errore è dovuto a un problema tuo o dell'API
			// Funzioni a pagamento sono disponibili
			...
		}
	}
}

Sblocca codici

Quando si accede a questa sezione, si aprirà un elenco di codici di sblocco.

Elenco dei codici di sblocco

È possibile cercare nel campo dell'email o del codice nella barra di ricerca in alto. I codici trovati saranno visualizzati nell'elenco. È possibile utilizzare tutto o parte dell'email o del codice come criterio di ricerca. Le corrispondenze saranno evidenziate in colore. Ricerca e filtri funzionano simultaneamente e non si escludono a vicenda.

L'ultimo filtro utilizzato viene memorizzato per l'utente. Quindi, la prossima volta che si accede alla pagina, l'ultimo filtro utilizzato verrà applicato automaticamente. Sono disponibili filtri per l'elenco dei codici di sblocco:

• Colonne - seleziona le colonne della tabella da visualizzare nell'elenco dei codici di sblocco.
• Applicazione - mostra solo i codici di sblocco per le applicazioni selezionate.
• Stato - mostra solo i codici di sblocco che si trovano nello stato selezionato.

Elenco delle colonne nella tabella dei codici di sblocco:

• Applicazione - la tua applicazione. Puoi seguire il link per modificarne le impostazioni.
• Codice - il codice di sblocco.
• Email - l'indirizzo email associato alla registrazione del codice di sblocco. Questo indirizzo viene utilizzato per cercare i codici di sblocco dei clienti nella sezione I miei acquisti del sito web. Questa sezione è accessibile agli utenti.
• Termine - il periodo di validità del codice inviato (specificato nelle impostazioni dell'applicazione). Un periodo di validità è impostato per il codice, corrispondente alle condizioni delle impostazioni dell'applicazione al momento della sua creazione.
• Stato - lo stato del codice di sblocco. (vedi Stato del codice di sblocco)
• Creato - la data di creazione del codice di sblocco.
• Attivato - la data di attivazione del codice. Viene impostata nel momento in cui questo particolare dispositivo dell'utente contatta per la prima volta il servizio API PayToUse e invia questo codice. Lo stato del codice cambia in Attivato. Solo un codice inattivo può essere attivato. Se un codice attivo viene inviato da un dispositivo con un ID diverso, l'API restituisce l'errore 202. Solo un dispositivo può essere collegato a un singolo codice.
• Scadenza - la data di scadenza dell'attivazione del codice. Impostata per i codici che hanno un periodo di validità limitato all'attivazione del codice. Per i codici con data di scadenza illimitata, il campo rimane vuoto.
• Eliminato - la data di eliminazione del codice. Alla cancellazione, lo stato del codice viene impostato su Sconosciuto.
• Pagamento n. - numero di sequenza unico del pagamento. Puoi fare clic sul link per visualizzare i dettagli del pagamento.
• Pulsanti per le azioni con i codici di sblocco. Ad esempio, cancellazione.

Stato del codice di sblocco

Nel corso del suo ciclo di vita, il codice di sblocco passa attraverso diversi stati, che possono essere monitorati dallo stato del codice.

Pagamenti

Quando accedi a questa sezione, si aprirà un elenco dei pagamenti degli utenti.

I seguenti sistemi di pagamento sono utilizzati per ricevere pagamenti:

Dopo le commissioni del sistema di pagamento, PayToUse addebiterà una commissione del 13%. Stiamo costantemente lavorando per ridurre le commissioni.

Se insorgono controversie o rimborsi nel sistema di pagamento, le penali del sistema di pagamento sono riassegnate allo sviluppatore. Pertanto, non dovresti permettere che si verifichino tali situazioni. Le commissioni di PayToUse non vengono addebitate in situazioni controverse.

Elenco dei pagamenti

È possibile cercare nel campo email o nel codice inviato nella barra di ricerca in alto. I pagamenti trovati saranno visualizzati nell'elenco. Puoi utilizzare tutto o parte dell'email o del codice inviato come criterio di ricerca. Le corrispondenze saranno evidenziate a colori. La ricerca e i filtri funzionano simultaneamente e non si escludono a vicenda.

Per l'utente viene memorizzato l'ultimo filtro utilizzato. Quindi, la prossima volta che si accede alla pagina, l'ultimo filtro utilizzato verrà applicato automaticamente. Sono disponibili filtri per l'elenco dei pagamenti:

• Colonne - seleziona le colonne della tabella da visualizzare nell'elenco dei pagamenti.
• Applicazione - visualizzazione dei pagamenti solo per le applicazioni selezionate.
• Sistema - visualizzazione dei pagamenti solo dai sistemi di pagamento selezionati.
• Stato - visualizzazione dei pagamenti solo con stati selezionati.

L'elenco delle colonne nella tabella dei pagamenti:

• Applicazione - la tua applicazione. Puoi seguire il link per modificarne le impostazioni.
• # - numero di sequenza univoco del pagamento. Viene assegnato automaticamente al pagamento quando l'utente passa dal modulo di pagamento alla pagina di pagamento nel sistema di pagamento. Puoi fare clic sul collegamento per visualizzare i dettagli del pagamento.
• Commenti - messaggio dall'utente inserito nel modulo di pagamento.
• Sistema - il sistema di pagamento selezionato dall'utente.
• Stato - lo stato del pagamento. (vedi Stato del pagamento)
• Email - email dell'utente indicata nel modulo di pagamento.
• Termine - periodo di validità del codice inviato (specificato nelle impostazioni dell'applicazione).
• Creato - data di creazione del pagamento.
• Importo della fattura - l'importo del pagamento addebitato all'utente. Specificato nel modulo di pagamento in base alle impostazioni dell'applicazione.
• Data del pagamento - data del pagamento.
• Importo del pagamento - l'importo del pagamento confermato dal sistema di pagamento.
• Codice inviato - codice inviato all'utente.
• Importo disponibile - importo di prelievo disponibile.
• Importo del pagamento - l'importo dei fondi prelevati per il pagamento.

Non è possibile apportare modifiche al pagamento.

Stato del pagamento

Durante il suo ciclo di vita, il pagamento passa attraverso diversi stati, che possono essere monitorati dallo stato del pagamento.

Prelievi

Quando accedi a questa sezione, si aprirà un elenco dei tuoi prelievi.

Elenco dei prelievi

L'ultimo filtro utilizzato viene memorizzato per l'utente. Quindi, la prossima volta che accedi alla pagina, il filtro utilizzato verrà applicato automaticamente. Sono disponibili filtri per l'elenco dei prelievi:

• Colonne - mostra solo le colonne selezionate nell'elenco dei prelievi.
• Stato - mostra solo i prelievi che sono nello stato selezionato.

L'elenco delle colonne nella tabella dei prelievi:

• # - numero di sequenza unico del prelievo. Viene assegnato automaticamente al prelievo quando viene salvato. Puoi fare clic sul link per visualizzare i dettagli del prelievo.
• Stato - lo stato del prelievo. (vedi Stato del prelievo)
• Creato - la data della richiesta di prelievo.
• Importo - l'importo del prelievo.
• Prelievo - la data in cui è stato inviato il prelievo.
• Pulsanti per le azioni con i prelievi. Ad esempio, conferma.

Puoi confermare il prelievo quando è nello stato Inviato.

Stato del prelievo

Nel corso del suo ciclo di vita, il prelievo passa attraverso diversi stati, che possono essere monitorati dallo stato del prelievo.

API

Panoramica

L'API PayToUse esegue le seguenti funzioni:

1. Controlla lo stato di attivazione di un codice di sblocco e lo attiva se necessario.
2. Recupera i dati della glicemia dall'app NightScout.
3. Recupera i dati meteorologici attuali per una posizione specificata.

Tutte le informazioni possono essere richieste e restituite in una singola richiesta.

Endpoint API

Puoi utilizzare uno dei seguenti endpoint:

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

Entrambi gli endpoint gestiscono richieste GET e POST.

Parametri della richiesta

• device: stringa (obbligatorio) — identificatore univoco del dispositivo
• app: intero (obbligatorio) — il tuo ID applicazione
• model: stringa (opzionale) — codice del modello di dispositivo, necessario per raccogliere e visualizzare le statistiche per i dispositivi che utilizzano l'app
• code: stringa (opzionale) — codice di sblocco
• bg: array associativo (opzionale) — dati per richiedere i livelli di glicemia dall'app NightScout
• url: stringa (opzionale) — indirizzo dell'app NightScout
• weather: array associativo (opzionale) — dati per richiedere le condizioni meteorologiche attuali
• appid: stringa (opzionale) — chiave di accesso dell'API meteorologica
• lat: numero decimale (opzionale) — latitudine
• lon: numero decimale (opzionale) — longitudine
• provider: intero (opzionale) — provider meteorologico

Elenco dei provider meteorologici supportati

1. OpenWeatherMap

• Descrizione: OpenWeatherMap fornisce dati meteorologici a livello globale, tra cui condizioni meteorologiche in tempo reale, dati storici e previsioni a 16 giorni. Grazie all'ampia copertura geografica e agli aggiornamenti frequenti, OpenWeatherMap è una scelta molto diffusa per le applicazioni che richiedono sia dati meteorologici aggiornati che previsioni a lungo termine.
• Dati forniti: Temperatura, umidità, velocità del vento, qualità dell'aria, probabilità di precipitazioni e altro ancora, in tempo reale. Fornisce sia dati attuali che previsioni, compresi i dati meteorologici minuto per minuto per alcune località selezionate.
• Selezione del provider: Inserisci provider = 1 nella sezione relativa alle condizioni meteorologiche della tua richiesta per selezionare OpenWeatherMap come fornitore di dati meteorologici.
• Note sull'utilizzo: Offre piani gratuiti e a pagamento, con accesso ai dati tramite autenticazione tramite chiave API. I piani a pagamento includono livelli di dati avanzati e funzionalità premium.
• Documentazione API: Disponibile qui.

2. QWeather

• Descrizione: QWeather, noto anche come HeWeather, fornisce dati meteorologici completi incentrati sulla Cina, ma include anche dati internazionali. Offre informazioni dettagliate quali condizioni meteorologiche in tempo reale, previsioni, dati sulla qualità dell'aria e avvisi.
• Dati forniti: Temperatura attuale, umidità, indice UV, livelli di inquinamento, previsioni giornaliere e orarie, nonché avvisi relativi a condizioni meteorologiche avverse. È noto per i suoi dati dettagliati sulla qualità dell'aria e per gli aggiornamenti in tempo reale sulle variazioni delle condizioni meteorologiche.
• Selezione del provider: Inserisci provider = 2 nella sezione meteo della tua richiesta per selezionare QWeather come fornitore di dati meteorologici.
• Note sull'utilizzo: QWeather offre l'accesso tramite API con un piano gratuito e uno premium. Il piano gratuito fornisce dati limitati, mentre le opzioni premium consentono di accedere a ulteriori dati e località.
• Documentazione API: Disponibile qui.

3. MET Weather (MET Norway)

• Descrizione: L'API MET Weather, fornita da MET Norway, offre accesso a una vasta gamma di dati meteorologici aperti, tra cui previsioni, dati storici e dati specifici relativi alla Norvegia e alle regioni nordiche. Rinomata per la sua accuratezza e trasparenza, MET Weather è la soluzione ideale per le applicazioni che richiedono dati meteorologici altamente affidabili.
• Dati forniti: Condizioni meteorologiche attuali, previsioni, precipitazioni, temperatura, dati sul vento e indice UV. MET Weather offre dati specifici per le regioni nordiche, ma fornisce anche informazioni meteorologiche a livello globale.
• Selezione del provider: Inserisci provider = 3 nella sezione meteo della tua richiesta per selezionare MET Weather come fornitore di dati meteorologici.
• Note sull'utilizzo: Tutti i dati forniti da MET Weather sono disponibili gratuitamente per l'uso in base a una licenza Creative Commons, che consente applicazioni sia a scopo non commerciale che commerciale senza alcun costo. MET Norway è rinomata per i suoi dati ambientali, il che la rende un fornitore affidabile, in particolare in Europa.
• Documentazione API: Disponibile qui.

Esempio di richiesta

function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	if (!ds.phoneConnected) { // Verifica che il dispositivo sia collegato al telefono per l'invio della richiesta
		return;
	}

	var id = ds.uniqueIdentifier;
	if (id == null) { // Verifica che al dispositivo sia stato assegnato un identificatore univoco
		return;
	}

	var request = {};

	var lockCheck = Application.Storage.getValue("LastCodeCheckTimestamp");
	if (lockCheck == null || lockCheck <= Time.now().value()) { // Invia il codice se necessario
		request.put("code", Application.Properties.getValue("UnlockCode"));
	}

	var ns_url = Application.Properties.getValue("NS");
	if (!ns_url.equals("")) { // Se necessario, invia l'URL dell'app NightScout
		request.put("bg", { "url" => ns_url });
	}

	var wP = Application.Properties.getValue("Weather");
	if (wP != 0) { // Invia i parametri della richiesta meteo, se necessario
		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()) {

		// Compila i parametri di richiesta obbligatori
		request.put("device", id);
		request.put("app", p2uAppID); // ID della tua Applicazione
		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)
		);
	}
}

Risposta API

L'API restituisce un oggetto JSON contenente informazioni sullo stato di sblocco, sul livello di glucosio e sulle condizioni meteorologiche.

Parametri della risposta

Risultati della verifica del codice di sblocco (se è stata inviata una richiesta):

• response: intero — codice di ritorno
• msg: stringa — messaggio relativo al risultato della verifica
• expires: intero — timestamp di scadenza del codice in formato UNIXTIMESTAMP
• qr: array — Codice QR per l'acquisto o la verifica del numero di serie, se del caso

Risposta dell'app NightScout (se è stata inviata una richiesta):

• bg: array associativo — risposta formattata dall'app NightScout
• value: intero — livello di glucosio nel sangue in mg/dL
• date: intero — data e ora di scadenza del codice in formato UNIXTIMESTAMP
• direction: stringa — andamento della variazione del livello di glucosio nel sangue

Risposta dell'API meteo (se è stata inviata una richiesta):

• weather: array associativo — risposta formattata dall'API meteo
• provider: intero — identificativo del fornitore di dati meteorologici
• weather: array — condizioni meteorologiche attuali. Può restituire uno o due valori; se vengono restituiti due valori, questi rappresentano le condizioni diurne e notturne
• temp: numero decimale — temperatura attuale in gradi Celsius
• feels_like: numero decimale — temperatura percepita in gradi Celsius
  Внимание! Отсутствует для MET Norway
• pressure: intero — pressione atmosferica in hPa
• humidity: intero — umidità in %
• precipitation: intero — probabilità di precipitazioni in %
  Внимание! Отсутствует для MET Norway
• wind: intero — direzione del vento in gradi
• wind_speed: numero decimale — velocità del vento in m/s
• temp_low: numero decimale — la temperatura minima odierna in gradi Celsius
• temp_high: numero decimale — la temperatura massima odierna in gradi Celsius
• sunrise_today: intero — l’ora dell'alba di oggi in formato UNIXTIMESTAMP
• sunset_today: intero — l’ora del tramonto di oggi in formato UNIXTIMESTAMP
• sunrise_tomorrow: intero — l’ora dell'alba di domani in formato UNIXTIMESTAMP
• sunset_tomorrow: intero — l’ora del tramonto di domani in formato UNIXTIMESTAMP
• aqi: array associativo — indice di qualità dell'aria
• level: intero — livello dell'indice di qualità dell'aria
• value: intero — valore dell'indice di qualità dell'aria

Esempio di risposta

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

Note

• Le richieste con bg richiedono una connessione all'app NightScout.
• Per ogni richiesta contenente un codice, l'API verifica automaticamente lo stato del codice e lo attiva se è inattivo.
• Si prega di tenere presente che i parametri dell'API potrebbero essere aggiornati o modificati nel tempo al fine di migliorarne la funzionalità, la compatibilità e la sicurezza. Si raccomanda di consultare periodicamente la documentazione dell'API per verificare l'eventuale presenza di modifiche che potrebbero influire sull'integrazione o sull'utilizzo.

Garmin

Per una descrizione dettagliata delle funzioni e delle costanti meteorologiche dell'SDK Garmin, consultare questo link. È possibile memorizzare i valori ottenuti dall'API o i risultati delle funzioni meteorologiche dell'SDK Garmin, a seconda del fornitore di dati meteorologici selezionato, per garantire la coerenza nella visualizzazione dei valori sullo schermo.

Apri la mappa meteorologica

Dai un'occhiata al set di icone di OpenWeatherMap come esempio qui.

QWeather

Puoi dare un'occhiata alla serie originale di icone meteorologiche cliccando qui

Previsioni MET

Dai un'occhiata al set di icone di MET Weather come esempio qui.