Unterstützung/Umsatzzuordnung
Umsatzzuordnung

Umsatzzuordnung mit eigenen Zahlungsanbietern

Wenn Sie bereits einen verbundenen Anbieter wie Stripe, Paddle, LemonSqueezy oder Polar nutzen, verwenden Sie zuerst diese eingebaute Integration.

Die passenden API-Zugangsdaten wählen

Für die meisten Integrationen eigener Zahlungsanbieter nutzen Sie einen Website-API-Schlüssel aus dem Bereich Website-Schlüssel der Seite API-Tokens. Website-Schlüssel beginnen mit flow_ und sind bereits auf diese eine Website beschränkt.

Nutzen Sie ein Workspace-API-Token von der Seite API-Tokens des Workspace nur, wenn ein gemeinsames Backend, eine MCP-Integration oder eine Automatisierung Zugriff auf mehrere Websites braucht. Workspace-Tokens beginnen mit flow_ws_. Wenn Sie eines verwenden, geben Sie websiteId oder domain im Request-Body mit, damit Flowsery weiß, welcher Website die Zahlung zugeordnet werden soll.

Zahlungen mit dem aktuellen API-Vertrag senden

Wenn eine Zahlung erfolgreich ist, rufen Sie die Flowsery Payment API auf:

JavaScript
await fetch('https://analytics.flowsery.com/analytics/api/v1/payments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${FLOWSERY_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    // Required only when FLOWSERY_API_KEY is a workspace token.
    websiteId: process.env.FLOWSERY_WEBSITE_ID,
    amount: 29.99,
    currency: 'USD',
    transactionId: 'txn_98hj',
    visitorUid: request.cookies._fs_vid,
    sessionUid: request.cookies._fs_sid,
    email: 'buyer@example.com',
    name: 'Buyer Name',
    customerId: 'cus_123',
  }),
});

Hinweise

  • Verwenden Sie die Feldnamen des Backends exakt: visitorUid, sessionUid und transactionId.
  • websiteId oder domain ist für Workspace-Tokens mit flow_ws_ erforderlich und für Website-API-Schlüssel mit flow_ optional.
  • amount ist erforderlich. Eine Anfrage ohne diesen Wert gibt 400 Bad Request zurück.
  • Eine transactionId, die für die Website bereits erfasst ist, gibt 409 Conflict zurück, statt eine zweite Zahlung zu erfassen.
  • Rückerstattungen sollten die ursprüngliche transactionId wiederverwenden und isRefund: true setzen.

Details zum Endpunkt finden Sie unter Eine Zahlung erfassen.