# Float Developer Documentation

> Integrate Float's interest-free instalment payments into your store or platform.

## Docs

- [Create a checkout](https://docs.float.co.za/api-reference/create-checkout.md): POST /api/checkouts — create a payment session and get the hosted payment URL.
- [Create a refund](https://docs.float.co.za/api-reference/create-refund.md): POST /api/refunds — request a full or partial refund for a checkout.
- [Get a checkout](https://docs.float.co.za/api-reference/get-checkout.md): GET /api/checkouts/:id — fetch a single checkout's current status.
- [Get merchant config](https://docs.float.co.za/api-reference/get-config.md): GET /api/config — your merchant profile and available instalment terms.
- [Get a refund](https://docs.float.co.za/api-reference/get-refund.md): GET /api/refunds/:id — track a refund request's status.
- [Intermediaries](https://docs.float.co.za/api-reference/intermediaries.md): For platforms integrating Float on behalf of multiple merchants.
- [List checkouts](https://docs.float.co.za/api-reference/list-checkouts.md): GET /api/checkouts — paginated list of your checkouts.
- [List refunds](https://docs.float.co.za/api-reference/list-refunds.md): GET /api/refunds — paginated list of your refund requests.
- [API overview](https://docs.float.co.za/api-reference/overview.md): Base URLs, conventions, errors, rate limits, and pagination for the Float Merchant API.
- [Payment callback](https://docs.float.co.za/api-reference/payment-callback.md): The signed webhook Float POSTs to your notify_url when a payment finishes.
- [Authentication](https://docs.float.co.za/authentication.md): Bearer tokens for every request, HMAC-SHA512 signatures for integrity.
- [How Float works](https://docs.float.co.za/concepts/how-float-works.md): The payment lifecycle, checkout statuses, and what they mean for your order flow.
- [Accepting payments](https://docs.float.co.za/guides/accepting-payments.md): The complete custom-integration walkthrough: checkout, redirect, callback, reconciliation.
- [Callbacks](https://docs.float.co.za/guides/callbacks.md): Float's signed server-to-server payment notifications: payload, verification, retries, and the dynamic redirect.
- [Migrating from the legacy API](https://docs.float.co.za/guides/migrate-from-v1.md): Move from the v1 (plugin) API to the current Merchant API — field mappings and behavioural differences.
- [Platform plugins](https://docs.float.co.za/guides/plugins.md): Add Float to WooCommerce, Shopify, or Magento without writing code.
- [Refunds](https://docs.float.co.za/guides/refunds.md): Create full or partial refunds via the API, and track them to completion.
- [Testing & go-live](https://docs.float.co.za/guides/testing-and-go-live.md): How to test your integration in the sandbox, and the checklist to pass before switching to production.
- [Troubleshooting](https://docs.float.co.za/guides/troubleshooting.md): Diagnose the most common integration problems — signature mismatches, missing callbacks, rate limits, and validation errors.
- [Introduction](https://docs.float.co.za/introduction.md): Offer your customers interest-free instalments with a single redirect-based integration.
- [Quickstart](https://docs.float.co.za/quickstart.md): Create a checkout and take a test payment in five minutes.

## Optional

- [🇬🇧 United Kingdom](https://docs.choosefloat.com)