Registrar un pago

api-referencePOST

Seguimiento automatico disponible

Si usa Stripe, LemonSqueezy o Polar, no necesita este endpoint. Los pagos se rastrean automaticamente cuando su proveedor de pagos esta conectado.

POSThttps://analytics.flowsery.com/api/v1/payments

Registre un pago y atribuya ingresos. Envíe el monto más cualquier identificador que tenga, especialmente el ID de transacción y el ID de visitante/ID de sesión cuando estén disponibles.

Clave API (Bearer token)

Cuerpo de solicitud

Parametro	Tipo	Descripcion
`amount`	`number`	Monto del pago. Esto siempre debe enviarse.
`currency`	`string`	Codigo de moneda como "USD", "EUR", "GBP".
`transactionId`	`string`	Identificador de transacción estable utilizado para la deduplicación.
`visitorUid`	`string`	ID de visitante Flowsery opcional, que generalmente se obtiene de la cookie _fs_vid en su propio backend.
`sessionUid`	`string`	ID de sesión Flowsery opcional, normalmente procedente de la cookie _fs_sid.
`email`	`string`	Direccion de correo electronico del cliente.
`name`	`string`	Nombre del cliente.
`customerId`	`string`	ID del cliente de su proveedor de pagos.
`isRenewal`	`boolean`	Establecer en true para pagos recurrentes. Predeterminado: false.
`isRefund`	`boolean`	Establecer en true para pagos reembolsados. Predeterminado: false.

La carga útil de éxito contiene únicamente un mensaje de confirmación.

Solicitud de ejemplo (Node.js)

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

  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,
        sessionUid: _fs_sid,
        email: "buyer@example.com",
      }),
    }
  );

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

200

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