# Fluense Merchant API

> One API for accepting payments with social cashback: organizations and API keys, terminals, checkouts, charge capture, voids and refunds, sales, signed webhooks and payouts. Sandbox and live are the same API — credentials decide the ledger.

## Getting started
- [Overview](https://docs.fluense.social/index.md): What the Fluense Merchant API is: accept payments with social cashback, one API for sandbox and live, credentials at a glance.
- [Quickstart](https://docs.fluense.social/quickstart.md): Take a sandbox payment end to end: register an org, issue an API key, create a terminal and checkout, capture the charge, receive webhooks.
- [Authentication](https://docs.fluense.social/authentication.md): API keys (fl_test_/fl_live_) and merchant console sessions, key management endpoints, organization roles and permissions.
- [Sandbox & live](https://docs.fluense.social/environments.md): One API serves two ledgers: how the environment is resolved from keys and sessions, isolation rules and the live checklist.

## Payments
- [Terminals](https://docs.fluense.social/terminals.md): Point-of-sale terminals identified by a terminal id (QR, NFC, link): create, list, update, resolve the active checkout behind it.
- [Checkouts](https://docs.fluense.social/checkouts.md): Create carts with server-validated totals, statuses from PENDING to CAPTURED, authorization gates and expiry.
- [Charges](https://docs.fluense.social/charges.md): Capture (idempotent), void and return charges: response fields, fee math, partial refunds and cashback adjustments.
- [Cashback](https://docs.fluense.social/cashback.md): How the merchant-funded cashback pot works: recommender share at capture, deferred buyer share, 100% bounty, 30-day maturity.

## Reporting & money
- [Sales](https://docs.fluense.social/sales.md): List and read sales with cursor pagination, status filters and cashback fields.
- [Payouts](https://docs.fluense.social/payouts.md): Move merchant balances to a bank account: payout creation, gates (KYB, monitoring, sanctions), destinations and statuses.

## Platform
- [Webhooks](https://docs.fluense.social/webhooks.md): Signed webhooks for checkout.authorized, charge.captured, charge.voided and charge.returned: payloads, HMAC verification and retries.
- [Team & roles](https://docs.fluense.social/team.md): Organizations, members, invitations and the owner/admin/finance/support/developer role model.

## Reference
- [Data models](https://docs.fluense.social/models.md): Every object the API returns — organizations, members, API keys, terminals, checkouts, sales, capture and return results, cashback summaries, webhook payloads and payouts — with field types and notes.
- [Errors & idempotency](https://docs.fluense.social/errors.md): Error shape and status classes, which calls are idempotent, retry guidance and API conventions.

## Optional
- [Full documentation](https://docs.fluense.social/llms-full.txt): every page concatenated in one markdown file