Create the organization Flutterwave subaccount
Creates a provider subaccount and, on provider success, stores its subaccount/account IDs and a default Flutterwave gateway for the authenticated organization. The server supplies split_value=0.05 and split_type=percentage; callers cannot override these fields. Returns the updated organization model. A provider rejection or transport exception is a local500 failure. Requires permission: one of access_payment_gateways.
Authorizations
Passport bearer token authentication for legacy admin sessions.
Body
Validated request fields for this operation.
Provider bank code.
"044"
Required bank account identifier; this controller imposes no further type rule.
"EXAMPLE-ACCOUNT"
Required organization/business name.
"Example Nonprofit"
Required business contact phone.
"+2348000000000"
Business contact mailbox.
"finance@example.org"
Provider setup country.
"NG"
Response
Operation result.
A Gratona client — the tenant of the multi-tenant system. Owns donors, entities, programs, users, and integrations. The client_id on every other resource scopes data to this row. Stripe Connect onboarding state, account-level settings, and the client's display name all live here.
Internal client ID — referenced by every multi-tenant resource.
207
Display name of the organization.
"Gratona Demo Org"
Organization website.
"https://demo.gratona.com"
Primary contact email for the organization.
"hello@demo.gratona.com"
Stripe Connect account id once onboarding completes; null until the org has finished Stripe onboarding.
"acct_1OqXXXXX"
Prior Stripe Connect account id, kept around when the client migrates between Connect accounts.
null
Whether the org has finished the Stripe Connect onboarding flow and can accept Stripe payments.
true
Stored organization date-format setting token. API and admin surfaces resolve this token to the corresponding display pattern.
m-d-Y, d-m-Y, Y-m-d "Y-m-d"
Computed accessor: client timezone derived from settings.
"America/Chicago"
Legacy free-form JSON column for arbitrary client-level configuration.
Legacy frequency configuration for billing / payment plans (JSON).
Legacy billing custom start date marker.
null
Legacy billing custom amount marker.
null
"2024-06-01T12:00:00Z"
"2026-01-01T00:00:00Z"