# Flowlix API

## Docs

- [Authentication](https://docs.flowlix.dev/api-reference/authentication.md): How to authenticate with the Flowlix API
- [Errors](https://docs.flowlix.dev/api-reference/errors.md): Understanding and handling Flowlix API errors
- [Idempotency](https://docs.flowlix.dev/api-reference/idempotency.md): Safely retry requests without creating duplicate operations
- [Pagination](https://docs.flowlix.dev/api-reference/pagination.md): Navigate large result sets with cursor-based pagination
- [Create a Direct API payment](https://docs.flowlix.dev/api-reference/payments/create-a-direct-api-payment.md): Creates a new payment by charging a card directly. The full card details are submitted in the request body.
- [Create an HPP payment](https://docs.flowlix.dev/api-reference/payments/create-an-hpp-payment.md): Creates a Hosted Payment Page (HPP) session. Instead of collecting card details directly, you redirect the customer to a Flowlix-hosted payment page where they securely enter their card information.
- [List payments](https://docs.flowlix.dev/api-reference/payments/list-payments.md): Returns a paginated list of payments, sorted by creation date in descending order (newest first). Use cursor-based pagination with `starting_after` to navigate through results.
- [Refund a payment](https://docs.flowlix.dev/api-reference/payments/refund-a-payment.md): Refunds a payment that has already succeeded. Supports both full refunds (omit `amount`) and partial refunds (specify `amount` in minor units). A payment can be refunded multiple times as long as the accumulated refunded amount does not exceed the original.
- [Retrieve a payment](https://docs.flowlix.dev/api-reference/payments/retrieve-a-payment.md): Retrieves the details of a payment that has previously been created. Supply the unique payment ID that was returned from your previous request, and Flowlix will return the corresponding payment information.
- [Rate Limits](https://docs.flowlix.dev/api-reference/rate-limits.md): Understand API rate limits and how to handle them
- [Test Cards](https://docs.flowlix.dev/api-reference/test-cards.md): Simulate different payment scenarios in test mode
- [Test Mode](https://docs.flowlix.dev/api-reference/test-mode.md): Build and test your integration without moving real money
- [3D Secure](https://docs.flowlix.dev/api-reference/three-d-secure.md): Handle 3DS authentication for card payments
- [Decline: Card Velocity Exceeded](https://docs.flowlix.dev/declines/card-velocity-exceeded.md): Understanding and handling the card_velocity_exceeded decline code
- [Decline: Do Not Honor](https://docs.flowlix.dev/declines/do-not-honor.md): Understanding and handling the do_not_honor decline code
- [Decline: Expired Card](https://docs.flowlix.dev/declines/expired-card.md): Understanding and handling the expired_card decline code
- [Decline: Generic Decline](https://docs.flowlix.dev/declines/generic-decline.md): Understanding and handling the generic_decline decline code
- [Decline: Insufficient Funds](https://docs.flowlix.dev/declines/insufficient-funds.md): Understanding and handling the insufficient_funds decline code
- [Decline: Invalid Card Number](https://docs.flowlix.dev/declines/invalid-number.md): Understanding and handling the invalid_number decline code
- [Decline: Lost Card](https://docs.flowlix.dev/declines/lost-card.md): Understanding and handling the lost_card decline code
- [Decline: Stolen Card](https://docs.flowlix.dev/declines/stolen-card.md): Understanding and handling the stolen_card decline code
- [3D Secure Declines](https://docs.flowlix.dev/declines/three-d-secure.md): Decline codes related to 3D Secure authentication
- [Direct API Payments](https://docs.flowlix.dev/guides/direct-api.md): Charge cards directly from your server with full control
- [Go-Live Checklist](https://docs.flowlix.dev/guides/go-live.md): Everything you need to verify before switching to live mode
- [Hosted Payment Page](https://docs.flowlix.dev/guides/hosted-payment-page.md): Redirect customers to a Flowlix-hosted page for secure card collection
- [Refunds](https://docs.flowlix.dev/guides/refunds.md): Issue full or partial refunds, with an auditable reason on every refund event
- [Introduction](https://docs.flowlix.dev/introduction.md): Welcome to the Flowlix Payments API
- [Quickstart](https://docs.flowlix.dev/quickstart.md): Make your first payment in under 5 minutes

## OpenAPI Specs

- [portal-api](https://docs.flowlix.dev/api-reference/portal-api.yaml)
- [openapi](https://docs.flowlix.dev/api-reference/openapi.yaml)
- [internal-api](https://docs.flowlix.dev/api-reference/internal-api.yaml)
- [backoffice-api](https://docs.flowlix.dev/api-reference/backoffice-api.yaml)