POST to the notify_url you supplied on create checkout. This page is the wire contract; the callbacks guide covers handler implementation, verification code, and local testing.
Request
Method:POST · Content-Type: application/json
Body
successful or cancelled. There is no failed — the shopper can retry on the hosted page until they succeed or abandon, so a failed attempt is not final.Your reference from the checkout request, echoed verbatim. Use this to find the order on your side.
The callback does not include the checkout ID. Store the mapping
client_reference_id → checkout_id when you create the checkout — you’ll need the ID for status lookups and refunds.Your response
Respond2xx quickly (do fulfilment work async). Any 2xx counts as delivered, but returning JSON unlocks an optional feature:
If present and non-empty in your JSON response, Float sends the shopper’s browser here instead of the checkout’s
success_url / cancel_url — useful for order-specific confirmation pages created during callback handling.{} (or anything else with a 2xx) to use the default redirect.