Registrar um pagamento

api-referencePOST

Rastreamento automatico disponivel

Se voce usa Stripe, LemonSqueezy ou Polar, nao precisa deste endpoint. Os pagamentos sao rastreados automaticamente quando seu provedor de pagamento esta conectado.

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

Registe um pagamento e atribua receita. Envie o valor mais quaisquer identificadores que tenha, especialmente transactionId e visitorUid/sessionUid quando disponíveis.

Chave API (Bearer token)

Corpo da requisicao

Parametro	Tipo	Descricao
`amount`	`number`	Valor do pagamento. Este deve ser sempre enviado.
`currency`	`string`	Codigo da moeda como "USD", "EUR", "GBP".
`transactionId`	`string`	Identificador de transação estável utilizado para desduplicação.
`visitorUid`	`string`	ID de visitante Flowsery opcional, normalmente proveniente do cookie _fs_vid no seu próprio back-end.
`sessionUid`	`string`	ID de sessão Flowsery opcional, normalmente proveniente do cookie _fs_sid.
`email`	`string`	Endereco de e-mail do cliente.
`name`	`string`	Nome do cliente.
`customerId`	`string`	Identificador do cliente do seu provedor de pagamento.
`isRenewal`	`boolean`	Defina como true para pagamentos recorrentes. Padrao: false.
`isRefund`	`boolean`	Defina como true para pagamentos reembolsados. Padrao: false.

A carga útil de sucesso contém apenas uma mensagem de confirmação.

Exemplo de requisicao (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"
  }]
}