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:
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,sessionUidundtransactionId. websiteIdoderdomainist für Workspace-Tokens mitflow_ws_erforderlich und für Website-API-Schlüssel mitflow_optional.amountist erforderlich. Eine Anfrage ohne diesen Wert gibt400 Bad Requestzurück.- Eine
transactionId, die für die Website bereits erfasst ist, gibt409 Conflictzurück, statt eine zweite Zahlung zu erfassen. - Rückerstattungen sollten die ursprüngliche
transactionIdwiederverwenden undisRefund: truesetzen.
Details zum Endpunkt finden Sie unter Eine Zahlung erfassen.