Pomoc/Atrybucja przychodów
Atrybucja przychodów

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:

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

Uwagi

  • Używaj dokładnie takich nazw pól, jakich oczekuje backend: visitorUid, sessionUid i transactionId.
  • Pole websiteId lub domain jest wymagane dla tokenów obszaru roboczego flow_ws_ i opcjonalne dla kluczy API witryn flow_.
  • Pole amount jest wymagane. Żądanie bez niego zwraca 400 Bad Request.
  • transactionId zarejestrowany już dla danej witryny zwraca 409 Conflict i druga płatność nie zostaje zapisana.
  • Zwroty powinny używać pierwotnego transactionId i ustawiać isRefund: true.

Szczegóły endpointu znajdziesz w sekcji Utwórz płatność.