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.