Assistance/Attribution des revenus
Attribution des revenus

Attribuer les revenus avec des fournisseurs de paiement personnalisés

Si vous utilisez déjà un fournisseur connecté comme Stripe, Paddle, LemonSqueezy ou Polar, privilégiez d'abord cette intégration native.

Choisir le bon identifiant d'API

Pour la plupart des intégrations de fournisseurs de paiement personnalisés, utilisez une clé API de site web depuis la section Clés de site web de la page Jetons API. Les clés de site web commencent par flow_ et sont déjà limitées à ce seul site.

Utilisez un jeton API workspace depuis la page Jetons API du workspace uniquement lorsqu'un backend partagé, une intégration MCP ou une automatisation a besoin d'accéder à plusieurs sites web. Les jetons de workspace commencent par flow_ws_. Si vous en utilisez un, incluez websiteId ou domain dans le corps de la requête pour que Flowsery sache quel site doit recevoir le paiement.

Envoyer des paiements avec le contrat d'API actuel

Lorsqu'un paiement réussit, appelez la Payment API de 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',
  }),
});

Remarques

  • Utilisez exactement les noms de champs du backend : visitorUid, sessionUid et transactionId.
  • websiteId ou domain est obligatoire pour les jetons de workspace flow_ws_ et facultatif pour les clés API de site web flow_.
  • amount est obligatoire. Une requête sans ce champ renvoie 400 Bad Request.
  • Un transactionId déjà enregistré pour le site renvoie 409 Conflict au lieu d'enregistrer un second paiement.
  • Les remboursements doivent réutiliser le transactionId d'origine et définir isRefund: true.

Pour les détails de l'endpoint, consultez Enregistrer un paiement.