Produktions-API-Anforderungsfluss

Empfohlene Anforderungsreihenfolge für Live-Vorgänge mit explizitem Eigentumsbereich und Transaktionsüberprüfbarkeit.

1. Authentifizieren und erhalten Sie den JWT- oder App-API-Schlüssel des Benutzers.
2. Erstellen oder aktualisieren Sie Produkte über /v1/products (POST, PUT, PATCH); sehen Produkte API CRUD Und mehrsprachige Beispiele.
3. Starten Sie den Checkout, indem Sie mit Ihrer Produkt-ID bezahlen.
4. Rückruf-/Webhook-Signaturen empfangen und validieren (payment.confirmed + Spiegelvalidierung).
5. Transaktionsergebnisse abfragen von /v1/transaction/status oder /v1/transactions - sehen Transaktionsdetails.

Erforderliche Header

Authorization: Bearer <token>
Content-Type: application/json

Grundlinie zur Fehlerbehandlung

• Wiederholen Sie vorübergehende Fehler (5xx) mit exponentiellem Backoff.
• Behandeln 401/403 als Authentifizierungs-/Berechtigungsprobleme.
• Behandeln 409 B. geschäftliche Konflikte (z. B. Produktlöschblocker).
• Protokollieren Sie Transaktions-IDs, Webhook-Ereignis-IDs und Anforderungs-IDs zur Nachverfolgbarkeit.