Skip to main content
The Flowlix Merchant API lets your server create and retrieve card payments, refund succeeded payments, submit card payouts, and receive payment and refund notifications. Start with a Sandbox integration using the Quickstart below.

​
Choose a payment integration

Hosted Payment Page

Redirect the customer to a Flowlix-hosted card form. Flowlix collects the card details and handles any required browser authentication.

Direct API

Collect card details in your own checkout and submit them from your server. This path requires a PCI-compliant card-data environment.
Both paths create the same Payment resource. Your server retrieves that Payment for its current status and can receive Webhooks when it changes; the browser return is never the authoritative result. Not sure which path fits? Use the Quickstart chooser.

​
Base URL

All requests in this documentation use:
Endpoints are versioned under /v1, for example https://api.flowlix.eu/v1/payments. Send the appropriate secret key from your server on every authenticated request.

​
Core resources

IDs such as pay_..., ref_..., and po_... are opaque. Store them; do not derive business meaning from their characters.

​
Amounts and currencies

Amounts are integers in the currency’s minor units, using its ISO 4217 exponent. For example, 4999 is EUR 49.99 but JPY 4999. Do not assume that every currency has two decimal places. Requests use three-letter ISO 4217 currency codes. Flowlix returns their canonical uppercase form.

​
Start here

1

Configure your test key

Follow Authentication and keep the key in a server-side environment variable or secrets manager.
2

Create a test payment

Open the Quickstart chooser, then complete either the Hosted Payment Page or Direct API path.
3

Confirm the final status

Retrieve the Payment until it reaches SUCCEEDED, FAILED, or EXPIRED. See Payment lifecycle.
4

Continue your integration

Add Refunds, Payouts, Webhooks, and robust error handling.

​
Support

Contact developers@flowlix.eu. Include the Request-Id response header from the failed API call, but never include API keys or raw card data.