Handbuch

Einführung

Die Seitenleiste links enthält Links zum entsprechenden Abschnitt:

• Benutzername - Links zum persönlichen Profil.
• Übersicht - Den aktuellen Status in Form von Diagrammen und Grafiken anzeigen.
• Anwendungen - Anwendungsverwaltung.
• Entsperrcodes - Automatisch generierte oder von Ihnen heruntergeladene Freischaltcodes.
• Zahlungen - Verlauf der eingehenden Zahlungen der Benutzer.
• Handbuch - Das aktuelle Benutzerhandbuch.

Übersicht

Sie können gemeinsame Filter für alle Widgets im Dashboard festlegen:

• Währung - die Währung, in die eingehende und ausgehende Beträge im Dashboard umgerechnet werden.
• Zeitraum - ist der Zeitraum, für den Daten in den Diagrammen und Tabellen auf dem Dashboard angezeigt werden. Er bestimmt das Intervall, in dem Informationen und Statistiken zu Zahlungen, Anwendungen und anderen Parametern analysiert und angezeigt werden.

Kontostand

Der Saldo enthält folgende Beträge:

• Bruttobetrag - der Gesamtbetrag aller Zahlungen der Benutzer für den ausgewählten Zeitraum, ohne die Gebühren der Zahlungssysteme und PayToUse.
• Nettobetrag - der Gesamtbetrag aller Zahlungen für den ausgewählten Zeitraum abzüglich der Gebühren der Zahlungssysteme und von PayToUse.
• Ausstehender Betrag - der Gesamtbetrag aller Zahlungen für den angegebenen Zeitraum abzüglich der Gebühren der Zahlungssysteme und von PayToUse, die auf das Konto des Entwicklers zur Auszahlung ausstehen. Die Zahlung wird 7 Tage nach der Zahlung zur Auszahlung freigegeben.
• Verfügbarer Betrag - der Gesamtbetrag aller Zahlungen aller Zeiten abzüglich der Gebühren der Zahlungssysteme und von PayToUse, die für die Auszahlung auf das Konto des Entwicklers verfügbar sind.

Zahlungen

Das Zahlungs-Widget enthält eine Tabelle von Zahlungen, gruppiert nach Anwendung für den ausgewählten Zeitraum.

Tabellenfelder:

• Anwendung - Anwendung. In der Tabelle werden nur Anwendungen angezeigt, für die Zahlungen im ausgewählten Zeitraum erfolgt sind.
• Zahlungen - Anzahl der Zahlungen.
• Bruttobetrag - der Gesamtbetrag aller Zahlungen der Benutzer für den ausgewählten Zeitraum, ohne die Gebühren der Zahlungssysteme und PayToUse.
• Nettobetrag - der Gesamtbetrag aller Zahlungen für den ausgewählten Zeitraum abzüglich der Gebühren der Zahlungssysteme und von PayToUse.

Das Diagramm zeigt die Dynamik der Werte Nettobetrag und Bruttobetrag pro Tag.

Neue Benutzer

Das Diagramm der neuen Benutzer zeigt zwei Werte in der Dynamik pro Tag:

• Neue Benutzer - die Anzahl der neuen API-Aufrufe. API-Zugriffe werden nur aufgezeichnet, wenn der Parameter device - eine eindeutige Gerätekennung - übergeben wird, wenn eine Anfrage an die API gesendet wird. Dieser Parameter muss für das Gerät wirklich eindeutig sein. (siehe Senden einer Anfrage)
• Zahlungen - die Anzahl der Zahlungen für den gleichen Zeitraum pro Tag.

Konversion

Die Konversionsmetrik bezieht sich auf die Bewertung Ihrer Verkaufseffizienz, um Neue Benutzer in Zahlungen umzuwandeln.

Das Diagramm zeigt das Verhältnis der Anzahl von Zahlungen zur Anzahl von Neue Benutzer in Prozent.

Anwendungen

Wenn Sie zu diesem Abschnitt gehen, öffnet sich eine Liste Ihrer Anwendungen.

Die Liste der Spalten in der Anwendungstabelle:

• # - Eindeutiger Anwendungsidentifikator. Wird beim Überprüfen des Anwendungscodes oder beim Anzeigen des Zahlungsformulars verwendet.
• Name - Anwendungsname. Der Name wird nur in Berichten und im Dashboard angezeigt. Durch Klicken auf den Anwendungsnamen wird die Bearbeitungsseite der Anwendung geöffnet.
• Status - Der aktuelle Status der Anwendung. Es kann sein:
• Erstellt - Die Anwendung wurde gerade erstellt, sie ist noch nicht konfiguriert.
• Veröffentlicht - Die Anwendung läuft.
• Erstellt - Das Datum der Anwendungserstellung.
• Zusätzliche Steuerelemente Buttons:
• Löschen - um die Anwendung aus der Liste zu entfernen.

Erstellen oder Bearbeiten einer Anwendung

Um Zahlungen zu akzeptieren, müssen Sie alle erforderlichen Anwendungsdaten konsequent ausfüllen und die Anwendung aktivieren.

Die Schaltfläche zum Erstellen einer neuen Anwendung befindet sich in der Titelleiste der Anwendungsliste.

Anwendung

Felder, die beim Erstellen einer Anwendung verfügbar sind:

• Name - der Name der Anwendung, den nur Sie in Berichten oder auf dem Dashboard sehen können. Der Name wird im Seitenkopf der gespeicherten Anwendung angezeigt. Solange die Anwendung nicht gespeichert ist, wird anstelle des Namens "Neue App" angezeigt. Das Feld muss eingegeben werden.
• Kontakt-E-Mail - die E-Mail-Adresse, an die Kopien der an Benutzer gesendeten Nachrichten gesendet werden. Diese Adresse ist auch im "Antworten an"-Feld angegeben und wird verwendet, um dem Benutzer auf die mit dem Code empfangene E-Mail zu antworten. Das Feld muss eingegeben werden. Standardmäßig wird das Feld mit dem Wert aus dem Entwicklerprofil gefüllt. Der Wert kann auf einen anderen Wert geändert werden.
• Anwendungstyp - Anwendungstyp. Wenn Sie einen Gruppenanwendungstyp auswählen, wird eine Liste von Anwendungen zur Gruppierung angezeigt. Nur einzelne Anwendungen, für die Entsperrcodes generiert werden, sind in der Liste verfügbar.
• Feedback bei Zahlung erlauben - fügt ein Feld zum Zahlungsformular hinzu, in dem Benutzer freien Text eingeben können. Feedback wird in die E-Mail-Kopie des Entwicklers aufgenommen. Feedback kann auch in den Zahlungsdetails eingesehen werden.

Beginnen Sie mit der Eingabe von geänderten Werten und die Schaltfläche Speichern erscheint. Mit der Schaltfläche Speichern können Sie Ihre Änderungen speichern, ohne zur nächsten Seite zu gehen. Die Schaltfläche Weiter speichert die Änderungen und wechselt zur nächsten Seite. Sie können jederzeit zurückkehren, um später Änderungen vorzunehmen.

In der Seitenkopfzeile sind nur die gespeicherten Anwendungsseiten zur Navigation verfügbar. Sie können auf Weiter klicken oder zum Abschnitt in der Seitenkopfzeile wechseln.

Beschreibung

Wählen Sie eine Sprache aus der Liste und klicken Sie auf Hinzufügen.

Ein Tab mit lokalisierten Anwendungstexten für die ausgewählte Sprache wird erscheinen.

Verfügbare Sprachen:

• Deutsch
• Englisch
• Französisch
• Spanisch
• Russisch
• Vereinfachtes Chinesisch

Die Felder in der Beschreibung werden verwendet, um Informationen im Zahlungsformular und in der Antwortnachricht an den Benutzer anzuzeigen:

• Name - der Name der Anwendung für die ausgewählte Sprache. Er wird im Zahlungsformular und in der Zahlungsbenachrichtigungs-E-Mail angezeigt. Standardmäßig wird beim Hinzufügen einer Sprache der Anwendungsname eingefügt. Sie können für jede Sprache einen anderen Namen festlegen. Pflichtfeld.
• Beschreibung - eine kurze Beschreibung der Anwendung. Wird im Zahlungsformular unter dem Anwendungsnamen angezeigt. Optionales Feld. Sie können es leer lassen, wenn keine Beschreibung angezeigt werden soll.
• Antwort - zusätzliche Informationen, die dem Benutzer nach erfolgreicher Zahlung in der E-Mail gesendet werden. Der Antworttext wird am Ende der E-Mail nach der Standardantwort hinzugefügt.

Es muss mindestens eine Sprache hinzugefügt werden, um zu speichern und zur nächsten Seite zu gelangen.

Die im Zahlungsformular angezeigte Sprache wird automatisch auf der Grundlage der vom Benutzer in seinen Browsereinstellungen angegebenen Präferenzen bestimmt. Sie können die Anwendungssprache für die Anwendung speichern.

Beginnen Sie mit der Eingabe oder ändern Sie die Werte und die Schaltfläche Speichern wird angezeigt. Die Schaltfläche Speichern ermöglicht es Ihnen, Ihre Änderungen zu speichern, ohne zur nächsten Seite zu gehen. Die Schaltfläche Weiter speichert die Änderungen und wechselt zur nächsten Seite. Sie können jederzeit zurückkehren, um später Änderungen vorzunehmen.

In der Seitenkopfzeile sind nur die gespeicherten Anwendungsseiten zur Navigation verfügbar. Sie können auf Weiter klicken oder zum Abschnitt in der Seitenkopfzeile wechseln.

Preis

Die Seite enthält eine Liste von Preisen und Feldern im Zusammenhang mit der Zahlung:

• Testzeitraum - die Dauer des Testzeitraums.
• Zeiteinheit - die Zeiteinheit des Testzeitraums. Zum Beispiel, wenn Sie 7 Tage angeben, bedeutet dies, dass nach 7 Tagen nach dem ersten API-Aufruf der Anwendung eine Antwort zurückgegeben wird, dass der Testzeitraum abgelaufen ist. Die Zeit des ersten Geräteaufrufs wird gespeichert.
• Preiskalkulationsmethode - Die Methode der Preiskalkulation aus der Liste:
• Preiskalkulation je nach Laufzeit - Im Zahlungsformular gibt der Benutzer den Aktivierungszeitraum des Codes an, und der Preis wird automatisch entsprechend der unten stehenden Tabelle berechnet. Der Benutzer erhält einen automatisch generierten Freischaltcode in der Antwort-E-Mail.
• Zeitraumberechnung abhängig vom Preis - Im Zahlungsformular wählt der Benutzer einen Preis aus der Liste oder gibt seinen eigenen Preis ein, und der Zeitraum wird automatisch gemäß der unten stehenden Tabelle berechnet. Der Benutzer erhält einen automatisch generierten Code in der Antwortnachricht.
• Permanentcode - Im Zahlungsformular wählt der Benutzer einen Preis aus der Liste oder gibt seinen eigenen Preis ein. Nach der Zahlung erhält er einen Code aus der unten stehenden Liste, der dem ausgewählten Preis entspricht, in der Antwort-E-Mail.
• Spende - Im Zahlungsformular wählt der Benutzer einen Preis aus der Liste oder gibt seinen eigenen Preis ein. Für Anwendungen des Typs Spende wird kein Freischaltcode generiert.

Der Preis wird in US-Dollar festgelegt. Der Mindestpreis beträgt 1 US-Dollar.

Beginnen Sie mit der Eingabe oder ändern Sie die Werte und die Schaltfläche Speichern wird angezeigt. Die Schaltfläche Speichern ermöglicht es Ihnen, Ihre Änderungen zu speichern, ohne zur nächsten Seite zu gehen. Die Schaltfläche Weiter speichert die Änderungen und wechselt zur nächsten Seite. Sie können jederzeit zurückkehren, um später Änderungen vorzunehmen.

In der Seitenkopfzeile sind nur die gespeicherten Anwendungsseiten zur Navigation verfügbar. Sie können auf Weiter klicken oder zum Abschnitt in der Seitenkopfzeile wechseln.

Vorschau

Diese Seite legt die Werte fest:

• Codelänge - die Länge des generierten Codes, falls zutreffend.
• Zeichensatz für Code - der Zeichensatz, aus dem der Code generiert wird:
• Numerischer Code - der Code wird nur mit den Ziffern 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 generiert. Führende Nullen können im Code enthalten sein. Führende Nullen sind bei der Überprüfung des Codes von Bedeutung.
• Alphanumerischer Code - der Code wird mit den Zeichen 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 generiert. Der Code wird dem Benutzer in Großbuchstaben generiert und gesendet. Die Groß- und Kleinschreibung der Zeichen ist bei der Überprüfung des Codes unerheblich.
• Link zum Code überprüfen - ein Beispiel-Link zur Verwendung für die Code-Überprüfung.
• Link zum Bezahlen - Zahlungslink. Sie können den Link kopieren und in die Beschreibung der Anwendung auf der Website einfügen, auf der die Anwendung veröffentlicht wird. Zu übergebende Parameter:
• app - der eindeutige Bezeichner der Anwendung. Erforderlicher Parameter.
• amount - der Betrag, der beim Kauf im Preisfeld angegeben wird. Der Standardpreis wird ignoriert. Der Betrag kann jedoch nicht weniger als der Mindestpreis und nicht niedriger als der für die Anwendung festgelegte Mindestpreis sein. Optionaler Parameter.

Um Zahlungen zu akzeptieren, müssen Sie die Anwendung mit der Schaltfläche 'Starten' aktivieren. Bevor Sie die Anwendung aktivieren, stellen Sie sicher, dass alle eingegebenen Daten korrekt sind. Die von der Anwendung generierten Schlüssel können nicht geändert werden.

Codeüberprüfung

Die Überprüfung des Anwendungsschlüssels erfolgt in 3 Schritten:

1. Erstellen und Senden einer Anfrage zur Code-Überprüfung
2. Überprüfungen auf der API-Seite
3. Empfang und Verarbeitung der API-Antwort

Senden einer Anfrage

Um den Code zu überprüfen, muss der Benutzer Ihrer Anwendung diesen in das Feld in den Anwendungseinstellungen eingeben.

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

Dann müssen Sie eine Anfrage an den Pay-to-use API-Server senden:

function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	return Toybox.Communications.makeWebRequest(
		"https://api.pay-to-use.com", // API-URL
		{
			"device" => ds.uniqueIdentifier, // Gerät eindeutiger Bezeichner
			"app" => "6", // Ihre Anwendungs-ID
			"model" => ds.partNumber, // device part number
			"code" => Application.Properties.getValue("UnlockCode") // Entsperrcode-Wert in Ihrer Anwendung
		},
		{
			:method => Communications.HTTP_REQUEST_METHOD_POST,
			:headers => { "Content-Type" => Communications.REQUEST_CONTENT_TYPE_JSON },
			:responseType => Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
		},
		method(:onReceive)
	);
}

API-Anfrageparameter:

• url - https://api.pay-to-use.com. Using HTTPS is mandatory.
• Der Inhalt der Anfrage (die übergebenen Werte). Ein Wörterbuch aus Schlüsseln und Werten:
• device - eindeutiger Bezeichner des Geräts.
• app - eindeutiger Bezeichner Ihrer Anwendung.
• model - device model identifier. Optional parameter. Data is used to display statistics for new devices.
• code - vom Benutzer in den Anwendungseinstellungen eingegebener Entsperrcode.
• Anfrageoptionen:
• :method - die API unterstützt die Anfrage-Methoden GET und POST.
• :headers - bei der POST-Methode müssen Parameter im JSON-Format übergeben werden.
• :responseType - die Antwort wird im JSON-Format zurückgegeben.
• responseCallback - ein Link zur Callback-Methode, die zwei Argumente akzeptieren sollte:
• responseCode - der Antwortheader-Code des Servers.
• data - der Inhalt, falls die Anfrage erfolgreich war, oder null.

Überprüfungen auf der API-Seite

Wenn keine Parameter an die API übergeben werden, gibt die API einen HTTP/1.1 404 Not Found-Header zurück.

Wenn mindestens ein Parameter an die API übergeben wird, gibt die API den Header HTTP/1.1 200 OK zurück.

Die Serverantwort besteht aus:

• response - Antwortcode
• msg - Textbeschreibung der Antwort
• expires - UNIXTIME-Zeitstempel (falls zutreffend)

Es wird überprüft, ob die übergebene Anwendungs-ID korrekt ist. Die Anwendung muss zum Zeitpunkt der Zahlung den Status Veröffentlicht haben. Im Fehlerfall wird der Antwortcode 301 zurückgegeben.

Wenn eine eindeutige Geräte-ID übertragen wird, wird die Geräte-ID gesucht und gespeichert. Wenn beim Überprüfen oder Speichern Fehler auftreten, wird der Fehlercode 402 zurückgegeben. Wenn ein solcher Rückgabecode gefunden wird, schreiben Sie sofort an Support unter [email protected]

Wenn der Code übergeben wird, werden die folgenden Schritte für Anwendungen mit den Berechnungsmethoden Preiskalkulation je nach Laufzeit und Zeitraumberechnung abhängig vom Preis ausgeführt:

• Wenn ein leerer Code übertragen wird, wird er vom eindeutigen Gerätekennzeichen getrennt, das in den vorherigen Schritten definiert wurde.
• Wenn ein nicht leerer Code übertragen wird und er nicht aktiviert ist, wird der Code abhängig von den Bedingungen des bei Kauf angegebenen Preises aktiviert, unabhängig vom Aktivierungsdatum.
• Wenn kein Code übertragen wurde oder der übertragene Code nicht gefunden wurde, wird der Fehlercode 201 zurückgegeben.
• Der aktivierte Code wird gegen das Gerät geprüft, und wenn ein anderes eindeutiges Gerätekennzeichen als das gespeicherte während der Aktivierung übermittelt wurde, wird der Fehlercode 202 zurückgegeben.
• Wenn der übermittelte Code kein Ablaufdatum hat und alle vorherigen Überprüfungen bestanden wurden, wird der Code 101 zurückgegeben.
• Wenn der Code zeitlich begrenzt ist, wird eine Überprüfung durchgeführt. Wenn der Schlüssel nicht abgelaufen ist, wird der Code 101 zurückgegeben. Wenn der Code abgelaufen ist, wird der Fehlercode 203 zurückgegeben.
• Diese Art von Anwendung erfordert, dass der Code an das Gerät gebunden ist. Wenn die eindeutige Geräte-ID nicht übermittelt wurde, wird der Fehlercode 304 zurückgegeben.

Für eine Anwendung mit einem Permanentcode wird nur die Verfügbarkeit des Codes zum Zeitpunkt des Kaufs überprüft. Wenn ein Code gefunden wird, wird der Code 101 zurückgegeben. Wenn kein Code gefunden wird, wird der Fehlercode 201 zurückgegeben.

Für eine Anwendung mit der Berechnungsmethode Spende wird der Code nicht überprüft. Der Code 101 wird immer zurückgegeben.

Wenn die vorherigen Überprüfungen nicht bestanden wurden, wird die Testzeit überprüft. Wenn seit dem ersten Kontakt des Geräts mehr Zeit vergangen ist als in den aktuellen Anwendungseinstellungen angegeben, wird der Fehlercode 204 zurückgegeben. Wenn die Testphase noch nicht abgelaufen ist, wird der Fehlercode 102 zurückgegeben.

Wenn nur die Anwendungs-ID übermittelt wird und weder der Freischaltcode noch die eindeutige Geräte-ID übermittelt werden, wird der Fehlercode 303 zurückgegeben.

Wenn die zurückgegebene Antwort 500 lautet, sollten Sie sich an den Support unter [email protected] wenden

Im Folgenden finden Sie eine Tabelle aller zurückgegebenen Codes:

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

{
	"response":101,
	"msg":"Active until 26 Dec 2024",
	"expires":1735208531
}

{
	"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 16h 43m",
	"expires":1732331119
}

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

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

{
	"response":203,
	"msg":"Expiration: 19 Nov 2024",
	"expires":1732011731
}

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

Überprüfen der Antwort

Dann sollten Sie die Antwort vom Pay-to-use API-Server überprüfen:

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

Sie können alle Header und Codes überprüfen, Sie können Ihre eigenen Nachrichten zur Benutzerfreundlichkeit anzeigen, aber in der einfachsten Form sieht die Überprüfung etwa so aus:

function onBackgroundData(data) as Void {
	if (data.hasKey("response")) {
		if (data.hasKey("msg")) {
			// Sie können data["msg"] im Eigenschaftsfeld mit dem Namen "UnlockResult" anzeigen.
			Application.Properties.setValue("UnlockResult", data["msg"]);
		}
		if (data["response"].toString().substring(0, 1).equals("2")) {
			// Code-Überprüfung fehlgeschlagen
			// Bezahlte Funktionen sind NICHT verfügbar
			...
		} else {
			// Die Code-Überprüfung war erfolgreich oder der Fehler liegt bei Ihnen oder beim API
			// Bezahlte Funktionen sind verfügbar
			...
		}
	}
}

Entsperrcodes

Wenn Sie zu diesem Abschnitt gehen, wird eine Liste der Freischaltcodes geöffnet.

Liste der Freischaltcodes

Sie können das E-Mail-Feld oder den Code in der oberen Suchleiste durchsuchen. Die gefundenen Codes werden in der Liste angezeigt. Sie können das gesamte E-Mail oder den Code oder Teile davon als Suchkriterium verwenden. Übereinstimmungen werden farblich hervorgehoben. Die Suche und die Filter funktionieren gleichzeitig und schließen sich nicht gegenseitig aus.

Der zuletzt verwendete Filter wird für den Benutzer gespeichert. Das bedeutet, dass beim nächsten Mal, wenn Sie die Seite betreten, der zuletzt verwendete Filter automatisch angewendet wird. Filter sind für die Liste der Freischaltcodes verfügbar:

• Spalten - Wählen Sie Tabellenspalten aus, die in der Liste der Freischaltcodes angezeigt werden sollen.
• Anwendung - Zeigen Sie nur Freischaltcodes für ausgewählte Anwendungen an.
• Status - Zeigen Sie nur Freischaltcodes an, die sich in den ausgewählten Status befinden.

Die Liste der Spalten in der Tabelle der Freischaltcodes:

• Anwendung - Ihre Anwendung. Sie können dem Link folgen, um ihre Einstellungen zu bearbeiten.
• Code - der Freischaltcode.
• E-Mail - die mit der Registrierung des Freischaltcodes verbundene E-Mail-Adresse. Diese Adresse wird verwendet, um Client-Freischaltcodes im Abschnitt Meine Käufe der Website zu suchen. Dieser Abschnitt ist für Benutzer zugänglich.
• Begriff - die Gültigkeitsdauer des gesendeten Codes (angegeben in den Anwendungseinstellungen). Für den Code wird eine Gültigkeitsdauer festgelegt, die den Bedingungen der Anwendungseinstellungen zum Zeitpunkt seiner Erstellung entspricht.
• Status - der Status des Freischaltcodes. (siehe Freischaltcode-Status)
• Erstellt - das Erstellungsdatum des Freischaltcodes.
• Aktiviert - das Aktivierungsdatum des Codes. Es wird festgelegt, wenn dieses bestimmte Benutzergerät zum ersten Mal den PayToUse-API-Dienst kontaktiert und diesen Code übermittelt. Der Status des Codes ändert sich zu Aktiviert. Nur ein inaktiver Code kann aktiviert werden. Wenn ein aktiver Code von einem Gerät mit einer anderen ID übermittelt wird, gibt die API den Fehler 202 zurück. Nur ein Gerät kann mit einem einzigen Code verknüpft werden.
• Ablauf - das Datum, an dem die Codeaktivierung abläuft. Wird für Codes gesetzt, die eine begrenzte Gültigkeitsdauer bei der Codeaktivierung haben. Für Codes mit unbegrenztem Ablaufdatum bleibt dieses Feld leer.
• Gelöscht - das Löschdatum des Codes. Beim Löschen wird der Codestatus auf Unbekannt gesetzt.
• Zahlung # - eindeutige Sequenznummer der Zahlung. Sie können auf den Link klicken, um die Details der Zahlung anzuzeigen.
• Schaltflächen für Aktionen mit Freischaltcodes. Zum Beispiel, Löschung.

Freischaltcode-Status

Während seines Lebenszyklus durchläuft der Freischaltcode verschiedene Zustände, die über den Code-Status verfolgt werden können.

Zahlungen

Wenn Sie zu diesem Abschnitt gehen, wird eine Liste der Benutzerzahlungen angezeigt.

Die folgenden Zahlungssysteme werden zum Empfangen von Zahlungen verwendet:

Nach den Gebühren des Zahlungssystems berechnet PayToUse eine Gebühr von 13%. Wir arbeiten ständig daran, die Gebühren zu reduzieren.

Wenn es zu Streitigkeiten oder Rückerstattungen im Zahlungssystem kommt, werden die Strafen des Zahlungssystems dem Entwickler erneut berechnet. Daher sollten Sie solche Situationen nicht zulassen. Die Gebühr von PayToUse wird in umstrittenen Situationen nicht berechnet.

Liste der Zahlungen

Sie können das E-Mail-Feld oder den gesendeten Code in der oberen Suchleiste suchen. Die gefundenen Zahlungen werden in der Liste angezeigt. Sie können das gesamte oder einen Teil der E-Mail oder des gesendeten Codes als Suchkriterium verwenden. Übereinstimmungen werden farblich hervorgehoben. Suche und Filter funktionieren gleichzeitig und schließen sich nicht gegenseitig aus.

Der zuletzt verwendete Filter wird für den Benutzer gespeichert. Das bedeutet, dass beim nächsten Mal, wenn Sie die Seite betreten, der zuletzt verwendete Filter automatisch angewendet wird. Filter stehen für die Liste der Zahlungen zur Verfügung:

• Spalten - Wählen Sie Tabellenspalten aus, die in der Zahlungsliste angezeigt werden sollen.
• Anwendung - Zeigt Zahlungen nur für ausgewählte Anwendungen an.
• System - Zeigt Zahlungen nur von ausgewählten Zahlungssystemen an.
• Status - Zeigt Zahlungen nur mit ausgewählten Statussen an.

Die Liste der Spalten in der Zahlungstabelle:

• Anwendung - Ihre Anwendung. Sie können dem Link folgen, um ihre Einstellungen zu bearbeiten.
• # - Eindeutige Sequenznummer der Zahlung. Sie wird der Zahlung automatisch zugewiesen, wenn der Benutzer vom Zahlungsformular zur Zahlungsseite im Zahlungssystem wechselt. Sie können auf den Link klicken, um die Details der Zahlung anzuzeigen.
• Kommentare - Nachricht des Benutzers, die im Zahlungsformular eingegeben wurde.
• System - das vom Benutzer ausgewählte Zahlungssystem.
• Status - der Zahlungsstatus. (siehe Zahlungsstatus)
• E-Mail - E-Mail-Adresse des Benutzers, die im Zahlungsformular angegeben wurde.
• Begriff - Gültigkeitsdauer des gesendeten Codes (in den Anwendungseinstellungen angegeben).
• Erstellt - das Erstellungsdatum der Zahlung.
• Rechnungsbetrag - der Betrag der Zahlung, der dem Benutzer belastet wurde. Wird im Zahlungsformular entsprechend den Anwendungseinstellungen angegeben.
• Zahlungsdatum - das Zahlungsdatum.
• Zahlungsbetrag - der Betrag der Zahlung, der vom Zahlungssystem bestätigt wurde.
• Gesendeter Code - Code, der an den Benutzer gesendet wurde.
• Verfügbarer Betrag - verfügbarer Auszahlungsbetrag.
• Auszahlungsbetrag - der Betrag der abgehobenen Gelder für die Zahlung.

Es ist nicht möglich, Änderungen an der Zahlung vorzunehmen.

Zahlungsstatus

Während seines Lebenszyklus durchläuft die Zahlung verschiedene Zustände, die durch den Zahlungsstatus nachverfolgt werden können.

Auszahlungen

Wenn Sie zu diesem Abschnitt gehen, wird eine Liste Ihrer Auszahlungen geöffnet.

Liste der Auszahlungen

Der zuletzt verwendete Filter wird für den Benutzer gespeichert. Das heißt, beim nächsten Besuch der Seite wird der zuletzt verwendete Filter automatisch angewendet. Für die Liste der Auszahlungen stehen Filter zur Verfügung:

• Spalten - Zeigen Sie nur ausgewählte Spalten in der Liste der Auszahlungen an.
• Status - Zeige nur Auszahlungen an, die sich in den ausgewählten Status befinden.

Die Liste der Spalten in der Tabelle der Auszahlungen:

• # - Eindeutige Sequenznummer der Auszahlung. Sie wird der Auszahlung automatisch zugewiesen, wenn die Auszahlung gespeichert wird. Sie können auf den Link klicken, um die Details der Auszahlung anzuzeigen.
• Status - der Auszahlungsstatus. (siehe Auszahlungsstatus)
• Erstellt - das Datum des Auszahlungsantrags.
• Betrag - der Auszahlungsbetrag.
• Auszahlung - das Datum, an dem die Auszahlung gesendet wurde.
• Schaltflächen für Aktionen mit Auszahlungen. Zum Beispiel Bestätigung.

Sie können die Auszahlung bestätigen, wenn sie sich im Status Gesendet befindet.

Auszahlungsstatus

Während seines Lebenszyklus durchläuft die Auszahlung verschiedene Zustände, die durch den Auszahlungsstatus verfolgt werden können.

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); // Ihre Anwendungs-ID
		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 19:05+0300 Last-Translator: VeshchiyOleg Language-Team: Language: de MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Plural-Forms: nplurals=2; plural=(n != 1); 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 19:05+0300 Last-Translator: VeshchiyOleg Language-Team: Language: de MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Plural-Forms: nplurals=2; plural=(n != 1); 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 19:05+0300 Last-Translator: VeshchiyOleg Language-Team: Language: de MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Plural-Forms: nplurals=2; plural=(n != 1); 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