Individuals

Individual accounts represent natural persons (e.g. casino players) onboarded under your partner account. An individual is created in pending status and must pass KYX identity verification before it can be paid out or cash out. Each active individual holds a wallet.

📄️ Create an individual

<p>Creates an individual (a natural person, e.g. a casino player) under your partner account. The individual starts in <code>pending</code> status; submit KYX and have it approved before paying the individual or letting them cash out.</p>

📄️ Retrieve an individual

Retrieve an individual

📄️ Retrieve terms-of-service state

<p>Returns the individual's terms-of-service state. When the individual must accept terms (e.g. before a crypto wallet can be provisioned), <code>terms_of_service_url</code> is the hosted page to redirect them to and <code>required</code> is <code>true</code>. When no terms step applies, <code>required</code> is <code>false</code> and the URL is <code>null</code>.</p>

📄️ Accept terms of service (sandbox)

<p><strong>Sandbox only.</strong> Marks the individual's terms of service as accepted, bypassing the hosted acceptance page. In production the individual accepts via the <code>terms_of_service_url</code> returned by <code>GET /individuals/{individual_id}/tos</code>.</p>

📄️ Retrieve crypto wallet balance

<p>Returns the individual's crypto wallet balance for the given currency, in integer minor units (e.g. cents of USDC). Defaults to <code>BASE-USDC</code>.</p>

📄️ Retrieve fiat balance

<p>Returns the individual's fiat balance, broken down by state and currency. A crypto-only individual with no fiat balance yet returns empty arrays rather than an error.</p>

📄️ Simulate a crypto deposit (sandbox)

<p><strong>Sandbox only.</strong> Simulates an on-chain deposit into the individual's crypto wallet, so the funding → credit flow can be exercised without moving real funds.</p>