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:
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,sessionUidytransactionId. websiteIdodomaines obligatorio con los tokens de workspaceflow_ws_y opcional con las claves API de sitio webflow_.amountes obligatorio. Una solicitud sin él devuelve400 Bad Request.- Un
transactionIdque ya está registrado para el sitio web devuelve409 Conflicten lugar de registrar un segundo pago. - Los reembolsos deben reutilizar el
transactionIdoriginal y definirisRefund: true.
Para los detalles del endpoint, consulta Registrar un pago.