Suporte/Atribuição de receita
Atribuição de receita

Atribuir receita com provedores de pagamento personalizados

Se você já usa um provedor conectado como Stripe, Paddle, LemonSqueezy ou Polar, dê preferência a essa integração nativa.

Escolher a credencial de API certa

Para a maioria das integrações com provedores de pagamento personalizados, use uma chave de API do site da seção Chaves de Website da página Tokens de API. As chaves de website começam com flow_ e já estão limitadas a esse site.

Use um token de API do espaço de trabalho da página Tokens de API do espaço de trabalho apenas quando um backend compartilhado, uma integração MCP ou uma automação precisar de acesso a vários sites. Os tokens do espaço de trabalho começam com flow_ws_. Quando usar um, inclua websiteId ou domain no corpo da requisição para que o Flowsery saiba qual site deve receber o pagamento.

Enviar pagamentos com o contrato de API atual

Quando um pagamento for bem-sucedido, chame a Payment API do 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

  • Use exatamente os nomes de campo do backend: visitorUid, sessionUid e transactionId.
  • websiteId ou domain é obrigatório para os tokens do espaço de trabalho flow_ws_ e opcional para as chaves de API do site flow_.
  • amount é obrigatório. Uma requisição sem esse campo retorna 400 Bad Request.
  • Um transactionId já registrado para o site retorna 409 Conflict em vez de registrar um segundo pagamento.
  • Os reembolsos devem reutilizar o transactionId original e definir isRefund: true.

Para os detalhes do endpoint, consulte Registrar um pagamento.