API Reference

Create Payment

Name: Flowsery
Author: Flowsery

Track payments from any provider

Automatic tracking available

If you use Stripe, LemonSqueezy, or Polar, you do not need this endpoint. Payments are tracked automatically when your payment provider is connected.

POSThttps://analytics.flowsery.com/payments

Track payments from any provider and attribute revenue to your traffic sources.

Bearer Token (API key)

Request body

Parameter	Type	Description
`amount`	`number`	Payment amount. Examples: 29.99 for $29.99, 0 for free trials.
`currency`	`string`	Currency code such as "USD", "EUR", "GBP".
`transactionId`	`string`	A unique transaction identifier from your payment provider.
`visitorUid`	`string`	The Flowsery Analytics visitor ID from the _fs_vid browser cookie. Strongly recommended for accurate revenue attribution.
`sessionUid`	`string`	The session ID for the current visitor session.
`email`	`string`	Customer email address.
`name`	`string`	Customer name.
`customerId`	`string`	Customer ID from your payment provider.
`isRenewal`	`boolean`	Set to true for recurring payments. Defaults to false.
`isRefund`	`boolean`	Set to true for refunded payments. Defaults to false.

Returns a confirmation message on success.

Example request (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"
  }]
}