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

# Intermediaries

> For platforms integrating Float on behalf of multiple merchants.

An **intermediary** integration lets a platform (a payment orchestrator, marketplace, or agency) create Float checkouts on behalf of many merchants using a single set of API credentials. Your Bearer token identifies you as the intermediary; the target merchant is addressed explicitly.

<Note>
  Intermediary access is provisioned by Float — contact your account manager to have your integration flagged as an intermediary and to onboard the merchants you represent.
</Note>

## Get a managed merchant's config

Identical to [`GET /api/config`](/api-reference/get-config), but addressed to a specific merchant you manage.

<ParamField path="merchant_id" type="string" required>
  The Float merchant identifier for the managed merchant, provided during that merchant's onboarding.
</ParamField>

```bash theme={null}
curl https://uat-secure.float.co.za/api/merchants/12345678-1111-1111-1111-1234567890ab/config \
  -H "Authorization: Bearer $FLOAT_CLIENT_SECRET"
```

```json 200 theme={null}
{
  "data": {
    "id": "12345678-1111-1111-1111-1234567890ab",
    "type": "merchants",
    "attributes": {
      "name": "South Park Cows Merch",
      "rules": [
        { "from_amount": 10000, "to_amount": 100000000, "terms": [1, 2, 3, 4, 5, 6] }
      ]
    }
  }
}
```

Rate limited to **5 requests per hour** per config — cache per merchant.

## Errors

| HTTP  | When                                                        |
| ----- | ----------------------------------------------------------- |
| `401` | Bad Bearer token                                            |
| `404` | The merchant isn't managed by your intermediary integration |

## Everything else works the same

Checkouts, callbacks, and refunds use the same endpoints and semantics documented across this reference. A dedicated intermediary OpenAPI spec is also published at `/api-docs-intermediary` on each environment.