Two ways to integrate
Hosted Payment Page
The fastest way to get paid. Create a payment, redirect your customer to a
Flowlix-hosted page, and let us handle card entry, 3D Secure, and PCI
compliance. No card data ever touches your servers.
Direct API
Full control over the checkout experience. Collect card details in your own
UI and charge them server-to-server. Requires PCI DSS compliance for
handling cardholder data.
Base URL
All API requests are made over HTTPS to:/v1, for example
https://api.flowlix.dev/v1/payments. Test mode and live mode share the same
host; the mode is selected by your API key.
Core concepts
| Concept | Description |
|---|---|
| Payment | One attempt to collect funds from a customer. Identified by an opaque pay_... ID. |
| Refund | A full or partial return of a succeeded payment. Identified by a ref_... ID. |
| Amounts | Always expressed in minor units of the currency: 4999 in EUR means €49.99. |
| Idempotency | Every POST request requires an Idempotency-Key header so retries never create duplicate charges. See Idempotency. |
| Statuses | Payments move through a defined lifecycle (PENDING → … → SUCCEEDED/FAILED). See Payment lifecycle. |
Get started
Get your API keys
Sign in to the Merchant Portal and copy your test secret key
(
api_test_sk_...) from the Developers section.Make your first payment
Follow the quickstart to create a hosted payment page
payment and complete it with a test card.
Track the result
Poll
GET /v1/payments/{id}
or subscribe to webhooks to learn the final outcome.Need help?
Contact Flowlix Developer Support at developers@flowlix.eu. Include theRequest-Id
response header from any failing API call — it lets us trace your request
end to end.