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:
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,sessionUidentransactionId. websiteIdofdomainis verplicht voorflow_ws_-workspacetokens en optioneel voorflow_-website-API-sleutels.amountis verplicht. Een verzoek zonder dit veld geeft400 Bad Requestterug.- Een
transactionIddie voor de website al is vastgelegd, geeft409 Conflictterug in plaats van een tweede betaling vast te leggen. - Gebruik bij terugbetalingen de oorspronkelijke
transactionIdopnieuw en zetisRefund: true.
Zie Create Payment voor de details van het endpoint.