Atrybucja przychodów z niestandardowymi dostawcami płatności
Jeśli korzystasz już z połączonego dostawcy, takiego jak Stripe, Paddle, LemonSqueezy czy Polar, w pierwszej kolejności wybierz wbudowaną integrację.
Wybierz właściwe dane uwierzytelniające API
W większości integracji z niestandardowymi dostawcami płatności używaj klucza API witryny z sekcji Klucze stron na stronie Tokeny API. Klucze witryn zaczynają się od flow_ i są od razu przypisane do jednej witryny.
Tokenu API obszaru roboczego ze strony Tokeny API obszaru roboczego używaj tylko wtedy, gdy dostęp do wielu witryn jest potrzebny współdzielonemu backendowi, integracji MCP lub automatyzacji. Tokeny obszaru roboczego zaczynają się od flow_ws_. Korzystając z takiego tokenu, dodaj do treści żądania websiteId lub domain, aby Flowsery wiedziało, do której witryny przypisać płatność.
Wysyłaj płatności zgodnie z aktualnym kontraktem API
Po udanej płatności wywołaj Payment API 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',
}),
});Uwagi
- Używaj dokładnie takich nazw pól, jakich oczekuje backend:
visitorUid,sessionUiditransactionId. - Pole
websiteIdlubdomainjest wymagane dla tokenów obszaru roboczegoflow_ws_i opcjonalne dla kluczy API witrynflow_. - Pole
amountjest wymagane. Żądanie bez niego zwraca400 Bad Request. transactionIdzarejestrowany już dla danej witryny zwraca409 Conflicti druga płatność nie zostaje zapisana.- Zwroty powinny używać pierwotnego
transactionIdi ustawiaćisRefund: true.
Szczegóły endpointu znajdziesz w sekcji Utwórz płatność.