Webhooks reservieren (On-Demand-Inventar)

Konfiguriere einen HTTPS-Endpunkt pro Angebot, der Feldwerte für COMPLEX-Angebote zurückgibt. Die Zahlung wird weiterhin abgeschlossen, wenn der Aufruf fehlschlägt; du kannst es erneut versuchen oder manuell erfüllen.

Rufe Lizenz-, Konto- oder Schlüsselwerte von deinem Server ab, wenn ein Käufer bezahlt.

Wann man reservierte Webhooks verwendet

Verwende dies für COMPLEX (einzigartige Einheit) Inventar, wenn du Schlüssel oder Konten in deinem eigenen System zum Zeitpunkt des Kaufs generierst. Lokaler Lagerbestand wird immer bevorzugt; der Webhook füllt nur den Mangel.

  • Funktioniert nur mit INSTANT-Auto-Lieferung, wenn jede Einheit tatsächlich zugewiesen ist.
  • Konfiguriere einen Angebotsstandard oder überschreibe pro Preisoption.
  • Nur HTTPS. Optionale HMAC-Signierung entspricht ausgehenden Webhooks.

Zahlungssichere Fehler

Wenn dein Endpunkt zeitlich begrenzt ist oder ungültige Daten zurückgibt, bleibt die Bestellung BEZAHLT. Der Käufer wird belastet; du siehst einen Fehler bei der Bestellung und kannst reservieren oder Schlüssel manuell anhängen.

Vertragsanforderung

Nach der Zahlung sendet RMT einen reservieren.item-Aufruf pro fehlender Einheit mit Bestellung, Angebot, Option, Feldschema und Menge 1. Optionale Anforderungs-Template-JSON wird mit {{placeholders}} zusammengeführt.

Kanonischer POST-Body (abgekürzt)

json
{
  "id": "rsv_…",
  "type": "reserve.item",
  "order": { "uid": "…", "reference": "…", "url": "…" },
  "offer": { "url": "…", "title": "…", "pageUrl": "…" },
  "option": { "id": 1, "name": "Standard" },
  "fields": [{ "id": 10, "name": "Lizenz", "type": "text", "required": true }],
  "quantity": 1
}

Antwort und Feldzuordnung

Gib 2xx JSON zurück. Ordne Pfade wie $.license auf Artikel-Felder zu oder gib { "entries": [{ "fieldId": 10, "value": "KEY-…" }] } zurück.

Bequeme Antwort

json
{
  "entries": [
    { "name": "Lizenz", "value": "AAAA-BBBB-CCCC" }
  ]
}
  • Lizenz-nur: ordne ein Textfeld von $.license oder $.key zu.
  • Konto: ordne E-Mail- und Passwortfelder von $.email und $.password zu.
  • Fehlende erforderliche Felder nach der Zuordnung zählen als Fehler.

Testen, erneut versuchen und Sicherheit

Verwende Test im Angebotseditor (sendet dryRun: true). Auf der Bestellseite, versuche erneut zu reservieren, nachdem du deinen Endpunkt behoben hast. Protokolliere niemals Geheimnisse oder vollständige Schlüssel in E-Mails.

  1. 1Speichere HTTPS-URL, Antwortzuordnung und optionales Geheimnis im Schritt 'Angebotsartikel'.
  2. 2Führe Test aus und bestätige zugeordnete Vorschauen.
  3. 3Bei Fehlern öffne die Bestellung, versuche erneut zu reservieren oder erstelle/weise einen Schlüssel manuell zu.

Rufe reserviere nicht vor der Zahlung auf

RMT ruft deinen Endpunkt nur nach erfolgreicher Zahlung auf, sodass abgebrochene Checkouts keine Lizenzen verbrennen.