API-Referenz

Zahlung erstellen

Name: Flowsery
Author: Flowsery

Zahlungen von jedem Anbieter verfolgen

Automatisches Tracking verfuegbar

Wenn Sie Stripe, LemonSqueezy oder Polar verwenden, benoetigen Sie diesen Endpunkt nicht. Zahlungen werden automatisch verfolgt, wenn Ihr Zahlungsanbieter verbunden ist.

POSThttps://analytics.flowsery.com/payments

Zahlungen von jedem Anbieter verfolgen und Umsaetze Ihren Traffic-Quellen zuordnen.

API-Schluessel (Bearer-Token)

Anfrage-Body

Parameter	Typ	Beschreibung
`amount`	`number`	Zahlungsbetrag. Beispiele: 29.99 fuer 29,99 $, 0 fuer kostenlose Testversionen.
`currency`	`string`	Waehrungscode wie "USD", "EUR", "GBP".
`transactionId`	`string`	Eine eindeutige Transaktionskennung von Ihrem Zahlungsanbieter.
`visitorUid`	`string`	Die Flowsery Analytics Besucher-ID aus dem _fs_vid-Browser-Cookie. Wird dringend fuer eine genaue Umsatzzuordnung empfohlen.
`sessionUid`	`string`	Die Sitzungs-ID fuer die aktuelle Besuchersitzung.
`email`	`string`	E-Mail-Adresse des Kunden.
`name`	`string`	Name des Kunden.
`customerId`	`string`	Kunden-ID von Ihrem Zahlungsanbieter.
`isRenewal`	`boolean`	Auf true setzen fuer wiederkehrende Zahlungen. Standard: false.
`isRefund`	`boolean`	Auf true setzen fuer erstattete Zahlungen. Standard: false.

Gibt bei Erfolg eine Bestaetigungsnachricht zurueck.

Beispielanfrage (Node.js)

const handler = async (req, res) => {
  const _fs_vid = req.cookies._fs_vid;

  const response = await fetch(
    "https://analytics.flowsery.com/api/v1/payments",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${FLOWSERY_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        amount: 29.99,
        currency: "USD",
        transactionId: "payment_456",
        visitorUid: _fs_vid,
      }),
    }
  );

  res.status(200).send("Payment tracked");
};

200

{
  "status": "success",
  "data": [{
    "message": "Payment recorded and attributed successfully"
  }]
}