Atribuir receita com provedores de pagamento personalizados
Se você já usa um provedor conectado como Stripe, Paddle, LemonSqueezy ou Polar, dê preferência a essa integração nativa.
Escolher a credencial de API certa
Para a maioria das integrações com provedores de pagamento personalizados, use uma chave de API do site da seção Chaves de Website da página Tokens de API. As chaves de website começam com flow_ e já estão limitadas a esse site.
Use um token de API do espaço de trabalho da página Tokens de API do espaço de trabalho apenas quando um backend compartilhado, uma integração MCP ou uma automação precisar de acesso a vários sites. Os tokens do espaço de trabalho começam com flow_ws_. Quando usar um, inclua websiteId ou domain no corpo da requisição para que o Flowsery saiba qual site deve receber o pagamento.
Enviar pagamentos com o contrato de API atual
Quando um pagamento for bem-sucedido, chame a Payment API do 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',
}),
});Notas
- Use exatamente os nomes de campo do backend:
visitorUid,sessionUidetransactionId. websiteIdoudomainé obrigatório para os tokens do espaço de trabalhoflow_ws_e opcional para as chaves de API do siteflow_.amounté obrigatório. Uma requisição sem esse campo retorna400 Bad Request.- Um
transactionIdjá registrado para o site retorna409 Conflictem vez de registrar um segundo pagamento. - Os reembolsos devem reutilizar o
transactionIdoriginal e definirisRefund: true.
Para os detalhes do endpoint, consulte Registrar um pagamento.