Identities
Registering and managing the root identity object and its lifecycle.
Register a new identity and provision its virtual account.
Creates an Identity record in PENDING state and asynchronously provisions a Nomba virtual account against it. The response returns immediately with the identity in PENDING state; integrators should either poll GET /identities/{id} or listen for the `identity.activated` webhook to know when the account is ready.
Fetch an identity record, its current state, and linked account.
Fetch an identity record, its current state, and linked account.
Update display profile fields (rename, contact details).
Updates only the display profile layer. Never changes the identity ID and never triggers a new virtual account provisioning. If display_name changes, Kobo re-submits the updated name to Nomba for the linked virtual account and logs an identity event of type 'renamed'.
Initiate closure of an identity's virtual account.
Transitions the account ACTIVE or LIMITED -> CLOSING. The account stops accepting new attributed inflow immediately; any settlement already in flight is allowed to clear. Once balance reaches zero and funds are swept to sweep_destination, the account transitions CLOSING -> CLOSED automatically and an `identity.closed` webhook fires. This endpoint does not block until closure completes; it starts the process.
Reopen a CLOSED identity's account.
Transitions CLOSED -> ACTIVE against the same identity ID, without re-running full provisioning. Fails if the identity is not currently CLOSED.