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 :
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,sessionUidettransactionId. websiteIdoudomainest obligatoire pour les jetons de workspaceflow_ws_et facultatif pour les clés API de site webflow_.amountest obligatoire. Une requête sans ce champ renvoie400 Bad Request.- Un
transactionIddéjà enregistré pour le site renvoie409 Conflictau lieu d'enregistrer un second paiement. - Les remboursements doivent réutiliser le
transactionIdd'origine et définirisRefund: true.
Pour les détails de l'endpoint, consultez Enregistrer un paiement.