Intermediaries
Merchant Config
Intermediaries
For platforms integrating Float on behalf of multiple merchants.
GET
Intermediaries
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.
Rate limited to 5 requests per hour per config — cache per merchant.
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.
Get a managed merchant’s config
Identical toGET /api/config, but addressed to a specific merchant you manage.
The Float merchant identifier for the managed merchant, provided during that merchant’s onboarding.
200
Errors
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.