> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowlix.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Integrate card payments, refunds, payouts, and payment notifications

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

<CardGroup cols={2}>
  <Card title="Hosted Payment Page" icon="globe" href="/guides/hosted-payment-page">
    Redirect the customer to a Flowlix-hosted card form. Flowlix collects the
    card details and handles any required browser authentication.
  </Card>

  <Card title="Direct API" icon="server" href="/guides/direct-api">
    Collect card details in your own checkout and submit them from your server.
    This path requires a PCI-compliant card-data environment.
  </Card>
</CardGroup>

Both paths create the same Payment resource. Your server retrieves that
Payment for its current status and can receive [Webhooks](/guides/webhooks)
when it changes; the browser return is never the authoritative result.

Not sure which path fits? Use the [Quickstart chooser](/guides/quickstart).

## Base URL

All requests in this documentation use:

```text theme={null}
https://api.flowlix.eu
```

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

| Resource    | What it represents                                    | How you read the latest state                                |
| ----------- | ----------------------------------------------------- | ------------------------------------------------------------ |
| **Payment** | One attempt to collect funds from a customer.         | `GET /v1/payments/{id}` or `GET /v1/payments`.               |
| **Refund**  | A full or partial return against a succeeded Payment. | Retrieve the parent Payment and inspect its `refunds` array. |
| **Payout**  | One card payout submission.                           | `GET /v1/payouts/{payout_id}` or `GET /v1/payouts`.          |

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

<Steps>
  <Step title="Configure your test key">
    Follow [Authentication](/guides/authentication) and keep the key in a
    server-side environment variable or secrets manager.
  </Step>

  <Step title="Create a test payment">
    Open the [Quickstart chooser](/guides/quickstart), then complete either the
    Hosted Payment Page or Direct API path.
  </Step>

  <Step title="Confirm the final status">
    Retrieve the Payment until it reaches `SUCCEEDED`, `FAILED`, or `EXPIRED`.
    See [Payment lifecycle](/guides/payment-lifecycle).
  </Step>

  <Step title="Continue your integration">
    Add [Refunds](/guides/refunds), [Payouts](/guides/payouts),
    [Webhooks](/guides/webhooks), and robust
    [error handling](/guides/errors).
  </Step>
</Steps>

## Support

Contact [developers@flowlix.eu](mailto:developers@flowlix.eu). Include the
`Request-Id` response header from the failed API call, but never include API
keys or raw card data.