Soporte/Atribución de ingresos
Atribución de ingresos

Atribuir ingresos con proveedores de pago personalizados

Si ya usas un proveedor conectado como Stripe, Paddle, LemonSqueezy o Polar, da prioridad a esa integración nativa.

Elige la credencial de API adecuada

Para la mayoría de las integraciones con proveedores de pago personalizados, usa una clave API de sitio web de la sección Claves de sitio web de la página Tokens de API. Las claves de sitio web empiezan por flow_ y ya están limitadas a ese sitio web.

Usa un token de API de workspace de la página Tokens de API del workspace solo cuando un backend compartido, una integración MCP o una automatización necesite acceder a varios sitios web. Los tokens de workspace empiezan por flow_ws_. Si usas uno, incluye websiteId o domain en el cuerpo de la solicitud para que Flowsery sepa qué sitio web debe recibir el pago.

Envía pagos con el contrato de API actual

Cuando un pago se complete, llama a la Payment API de Flowsery:

JavaScript
await fetch('https://analytics.flowsery.com/analytics/api/v1/payments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${FLOWSERY_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    // Required only when FLOWSERY_API_KEY is a workspace token.
    websiteId: process.env.FLOWSERY_WEBSITE_ID,
    amount: 29.99,
    currency: 'USD',
    transactionId: 'txn_98hj',
    visitorUid: request.cookies._fs_vid,
    sessionUid: request.cookies._fs_sid,
    email: 'buyer@example.com',
    name: 'Buyer Name',
    customerId: 'cus_123',
  }),
});

Notas

  • Usa exactamente los nombres de campo del backend: visitorUid, sessionUid y transactionId.
  • websiteId o domain es obligatorio con los tokens de workspace flow_ws_ y opcional con las claves API de sitio web flow_.
  • amount es obligatorio. Una solicitud sin él devuelve 400 Bad Request.
  • Un transactionId que ya está registrado para el sitio web devuelve 409 Conflict en lugar de registrar un segundo pago.
  • Los reembolsos deben reutilizar el transactionId original y definir isRefund: true.

Para los detalles del endpoint, consulta Registrar un pago.