API Reference

Delete Payments

Name: Flowsery
Author: Flowsery

Remove payment records by transaction, visitor, or time range

DELETEhttps://analytics.flowsery.com/payments

Delete payment records by transaction ID, visitor, or within a date range.

Bearer Token (API key)

At least one filter required

At least one query parameter must be provided. Calling this endpoint with no filters returns a 400 error.

Query parameters

Parameter	Type	Description
`transactionId`	`string`	Remove the payment matching a specific transaction ID.
`visitorId`	`string`	Remove all payments tied to a specific visitor ID.
`startAt`	`string`	ISO 8601 start timestamp (e.g., 2024-01-01T00:00:00Z).
`endAt`	`string`	ISO 8601 end timestamp (e.g., 2024-01-31T23:59:59Z).

Deletion behavior

Transaction ID only: Removes the specific payment record.

Visitor ID only: Removes all payments for that visitor (all time).

Time range only: Removes every payment within that period.

Visitor ID + time range: Removes payments for the visitor within the window.

Transaction ID + time range: Removes the specific transaction if it falls within the range.

Supplying <code>transactionId</code> or <code>visitorId</code> without a time range deletes ALL matching records across the entire history.

Error responses

400 Bad Request -- No filter parameters were provided.

401 Unauthorized -- API key is missing or invalid.

Delete a specific transaction

curl -X DELETE "https://analytics.flowsery.com/api/v1/payments?transactionId=payment_456" \
  -H "Authorization: Bearer flow_sk_live_abc123"

Delete payments for a visitor in a date range

curl -X DELETE "https://analytics.flowsery.com/api/v1/payments?visitorId=a3ab2331-989f-4cfa-91c6-2461c9e3c6bd&startAt=2024-01-01T00:00:00Z&endAt=2024-03-31T23:59:59Z" \
  -H "Authorization: Bearer flow_sk_live_abc123"

200

{
  "status": "success",
  "data": [
    {
      "deleted": 3,
      "message": "Payment records deleted successfully"
    }
  ]
}