Zum Hauptinhalt springen

Produkte, verwaltete Links und Abonnements

Diese Geschäftsressourcen gehören dem Konto. Erforderlich sind API-Schlüssel oder Partner-Bearer und die freigeschalteten Funktionen. Ein Schlüssel aktiviert keine Zahlungsroute. Siehe Authentifizierung.

Bei Lesen und Löschen ist env ein Query-Filter. Bei Erstellen und Ändern von Produkten/Links gehört env in den JSON-Body. Der Eigentümer folgt aus dem Zugang; keine fremde partner_id senden. Ressourcenpreise können endpunktspezifische Integer-Typen haben; amount der Transaktions-API bleibt ein exakter Integer-String.

Produkte​

GET /api/v1/products?env=prod&limit=10
GET /api/v1/products/{id}?env=prod
POST /api/v1/products
PUT /api/v1/products/{id}
DELETE /api/v1/products/{id}?env=prod

Ein Produkt definiert header, text, price, qty und currency und ist selbst keine Zahlung. Listen liefern data/total, Produktdetails und Erstellung data. Der Beispielpreis ist 1 USDT bei decimals=6.

{
  "env": "prod",
  "header": "Example item",
  "text": "Example item",
  "price": 1000000,
  "qty": "1",
  "currency": "USDT"
}
GET /api/v1/links?env=prod&limit=10
POST /api/v1/links
PUT /api/v1/links/{id}
DELETE /api/v1/links/{id}?env=prod

Links sind eigene Serverressourcen mit Betrag, Zahlungskonfiguration und optionalen Produkten. Verwenden Sie zurückgegebene URL-/Formulardaten, keine erfundene URL. Der lokal erzeugte Heth-Empfangslink ist ein anderes Objekt. Linklöschung erstattet keine abgeschlossene Zahlung.

Händler-Abonnements​

GET /api/v1/recurrents?env=prod&limit=10
GET /api/v1/recurrents/{id}?env=prod
POST /api/v1/recurrents
PUT /api/v1/recurrents/{id}
POST /api/v1/recurrents/{id}/pause
POST /api/v1/recurrents/{id}/resume
POST /api/v1/recurrents/{id}/cancel

Ein Abonnement basiert auf einer erfolgreichen Initialzahlung des Kontos. POST /recurrents erwartet payment_id und recurrent. interval akzeptiert daily, weekly, monthly oder yearly; period zählt Intervalle. Die Umgebung wird von der Initialzahlung übernommen. Der Zahler muss Zahlungsmethode und wiederkehrende Abbuchungen erlauben. Ein erstellter Datensatz beweist kein nutzbares Mandat.

Lebenszyklus: POST /recurrents/{id}/pause, /resume und /cancel. Status prüfen; Stornierung künftiger Abbuchungen erstattet keine früheren. Eigene Krypto-Mandate verwaltet der Heth-Zahler mit seiner Wallet-Sitzung unter Einstellungen → Subscription mandates, sofern aktiviert. Dies ist von Händler-Abonnements getrennt.

Letztes Update am