Skip to main content
POST
Create Funding Session

Authorizations

Authorization
string
header
required

A floo_ API key.

Headers

X-Floo-Org-Id
string<uuid>

Organization to act in; defaults to the one joined most recently.

Body

application/json

A credit purchase requires explicit consent to save a card and collect usage overages.

client_request_id
string<uuid>
required
amount_cents
integer
required
Required range: 1000 <= x <= 100000
return_to
enum<string>
required
Available options:
onboarding,
billing
save_for_future
boolean
required
Available options:
paygo-card-backstop-v1,
paygo-card-top-up-v1
currency
string
default:usd
Allowed value: "usd"

Response

Successful Response

POST-only funding session entry point for the creator org admin.

id
string<uuid>
required
amount_cents
integer
required
currency
string
required
Allowed value: "usd"
status
string
required
save_for_future
boolean
required
card_saved
boolean
required
client_secret
string | null

Stripe Checkout Session client secret for the browser's payment form.