api-referenceDEL
DELETE
https://analytics.flowsery.com/api/v1/paymentsEliminar registros de pago por ID de transaccion, visitante o dentro de un rango de fechas.
Clave API (Bearer token)
Se requiere al menos un filtro
Se debe proporcionar al menos un parametro de consulta. Llamar a este endpoint sin filtros devuelve un error 400.Parametros de consulta
| Parametro | Tipo | Descripcion |
|---|---|---|
transactionId | string | Eliminar el pago que coincida con un ID de transaccion especifico. |
visitorId | string | Eliminar todos los pagos vinculados a un ID de visitante especifico. |
startAt | string | Marca de tiempo de inicio ISO 8601 (por ejemplo, 2024-01-01T00:00:00Z). |
endAt | string | Marca de tiempo de fin ISO 8601 (por ejemplo, 2024-01-31T23:59:59Z). |
Comportamiento de eliminacion
<strong>Solo ID de transaccion:</strong> Elimina el registro de pago especifico.
<strong>Solo ID de visitante:</strong> Elimina todos los pagos de ese visitante (todo el periodo).
<strong>Solo rango de tiempo:</strong> Elimina todos los pagos dentro de ese periodo.
<strong>ID de visitante + rango de tiempo:</strong> Elimina los pagos del visitante dentro de la ventana.
<strong>ID de transaccion + rango de tiempo:</strong> Elimina la transaccion especifica si cae dentro del rango.
Proporcionar <code>transactionId</code> o <code>visitorId</code> sin un rango de tiempo elimina TODOS los registros coincidentes de todo el historial.
Respuestas de error
<strong>400 Bad Request</strong> -- No se proporcionaron parametros de filtro.
<strong>401 Unauthorized</strong> -- La clave API falta o es invalida.
Eliminar una transaccion especifica
curl -X DELETE "https://analytics.flowsery.com/api/v1/payments?transactionId=payment_456" \
-H "Authorization: Bearer flow_sk_live_abc123"Eliminar pagos de un visitante en un rango de fechas
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"
}
]
}