Support/Omzetattributie
Omzetattributie

Omzet toeschrijven met eigen betaalproviders

Gebruik je al een gekoppelde provider zoals Stripe, Paddle, LemonSqueezy of Polar, kies dan eerst voor die ingebouwde integratie.

Kies de juiste API-gegevens

Gebruik voor de meeste integraties met een eigen betaalprovider een website-API-sleutel uit het onderdeel Websitesleutels op de pagina API-tokens. Websitesleutels beginnen met flow_ en zijn al beperkt tot die ene website.

Gebruik een workspace-API-token van de pagina API-tokens van de workspace alleen als een gedeelde backend, een MCP-integratie of een automatisering toegang nodig heeft tot meerdere websites. Workspacetokens beginnen met flow_ws_. Gebruik je er een, neem dan websiteId of domain op in de body van het verzoek, zodat Flowsery weet welke website de betaling moet ontvangen.

Betalingen versturen met het huidige API-contract

Roep de Flowsery Payment API aan zodra een betaling geslaagd is:

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',
  }),
});

Opmerkingen

  • Gebruik de veldnamen van de backend precies zo: visitorUid, sessionUid en transactionId.
  • websiteId of domain is verplicht voor flow_ws_-workspacetokens en optioneel voor flow_-website-API-sleutels.
  • amount is verplicht. Een verzoek zonder dit veld geeft 400 Bad Request terug.
  • Een transactionId die voor de website al is vastgelegd, geeft 409 Conflict terug in plaats van een tweede betaling vast te leggen.
  • Gebruik bij terugbetalingen de oorspronkelijke transactionId opnieuw en zet isRefund: true.

Zie Create Payment voor de details van het endpoint.